(Ma première fois) Installer Laravel

Parfois, surtout lorsque vous êtes au début de votre carrière, il peut sembler que vous suivez les instructions et n'arrivez à rien - alors que tout le monde semble trouver cela terriblement facile.

Cela peut être assez décourageant, et je veux décrire quelques façons dont je vis exactement la même chose même après, eh bien, des décennies. Me voilà donc en train d'essayer de détailler les trébuchements et les erreurs que je fais en essayant de faire fonctionner les choses. C'est mon premier article sur le sujet, mais j'espère en faire d'autres.

Apprenons Laravel.

Laravel s'efforce de fournir une expérience de développement incroyable [...]
Que vous soyez nouveau dans les frameworks Web PHP ou que vous ayez des années d'expérience [...]

Laravel est présenté comme étant le « framework des développeurs », du moins dans les cercles PHP, car il est plus simple que les autres et il prend des décisions d'architecture simples mais strictes. J'ai créé quelques autres frameworks PHP - Drupal 7 , Drupal 8 , Symfony, WordPress, Concrete5, PrestaShop, CodeIgniter me viennent à l'esprit - donc je ne m'y lance pas sans préparation.

Je vais partir d'un ordinateur portable barebones et voir jusqu'où j'arrive.

Installation des prérequis (tldr ; problèmes : zéro, confiance : suprême)

Avant de créer votre première application Laravel, assurez-vous que PHP, Composer et le programme d'installation de Laravel sont installés sur votre ordinateur local. De plus, vous devez installer Node et NPM ou Bun afin de pouvoir compiler les ressources frontend de votre application.

D'accord. Pas de problème. Je vais probablement installer moi-même une partie de ce PHP, récupérer Composer sur... getcomposer.org et découvrir ensuite comment installer le "programme d'installation de Laravel". Apparemment, ma distribution a le nœud 22 prêt à l'emploi, ou il est installé lorsque j'ai configuré autre chose plus tôt, donc cela devrait être couvert.

$ composer global nécessite laravel/installer

Boum. Fait. Aucun problème pour l'instant, nous avons bien démarré et la confiance est au plus haut.

Mise en place d'un nouveau projet Laravel (tldr ; problèmes : certains, confiance : élevée)

$ nouvel exemple d'application laravel
zsh : commande introuvable : laravel

Oh. Peut-être que je dois revoir ce truc de confiance suprême.

Il semble donc que Composer n'installe rien dans les chemins binaires normaux et que le programme d'installation de Composer ne fait rien non plus pour s'ajouter au chemin système. Je n'ai jamais vraiment eu à y faire face auparavant, puisque j'ai directement exécuté les binaires installés par Composer à partir du chemin dans lequel ils apparaissent. Par exemple, avec Drupal, il y a supplier/drush/drush/drush ou supplier/bin/drush selon quelle version vous utilisez. Dois-je m'ajouter un lien symbolique ou un alias ou trouver le binaire Laravel partout où le compositeur l'a ajouté, « globalement » ?

Je ne sais pas, donc je dois chercher ça.

Je trouve quelques indices sur une réponse de Stack Overflow : vous pouvez trouver le répertoire binaire du composer avec composer global config bin-dir --absolute, et apparemment dans les versions modernes de composer, tout ce qui a une commande exécutable le place plutôt dans ce répertoire que de se perdre dans la hiérarchie.

Bien. Je peux ajouter quelque chose à mon script de démarrage pour le mettre sur mon chemin... sauf que cette commande produit plus que le chemin...

$ composer global config bin-dir --absolute
Changement du répertoire actuel en /home/moopet/.config/composer
/home/moopet/.config/composer/vendor/bin

... et je ne peux pas utiliser toute cette chaîne comme répertoire. Peut-être que je devrai utiliser tail pour obtenir la dernière ligne, ou quelque chose du genre. Attendez, non, il y a un autre commentaire sur cette réponse SO qui inclut l'indicateur --quiet. Qu'est-ce que ça fait ? Je vais essayer composer --help :

Utilisation :
liste [options] [--] []

Eh bien, euh, il s'avère que l'exécution de --help sur une commande nue composer donne en fait de l'aide pour la sous-commande list plutôt que pour composer lui-même. Cela m'a laissé perplexe pendant une minute.

-q --quiet Ne pas afficher de message

Hmm, ça n'a pas l'air utile ! Nous voulons du résultat. Qu'y a-t-il d'autre ?

--raw Pour afficher la liste de commandes brutes
--format=FORMAT Le format de sortie (txt, xml, json ou md) [par défaut : "txt"]

Peut-être que c'est l'un d'entre eux ?

L'option "--raw" n'existe pas.
L'option "--format" n'existe pas.

Non. Comme je le pensais, ce sont des options à lister et non des indicateurs à usage général.

Exécutons-le avec --quiet quand même, juste pour faire caca et s'amuser :

$ composer global config bin-dir --absolute --quiet
/home/moopet/.config/composer/vendor/bin

Eh bien, qu'est-ce que tu sais, ça a marché. C'est juste mal documenté.

Je vais insérer cela dans mon script de démarrage shell avec un petit code de garde et nous pouvons continuer :

if command -v composer >/dev/null; then
  export PATH=$(composer global config bin-dir --absolute --quiet):$PATH
fi

Mise en place d'un nouveau projet Laravel, prise 2 (tldr ; problèmes : certains, confiance : hésitante)

Cette fois, le nouvel exemple d'application de Laravel se lance et me demande quelques éléments. J'accepte les valeurs par défaut, car je n'ai pas lu assez loin dans la documentation pour connaître la différence, à l'exception du kit de démarrage. J'ai choisi "Breeze" parce que c'est comme ça dans la documentation.

Le processus d'installation démarre et tout semble bien jusqu'à :

- Root composer.json nécessite laravel/pint ^1.0 -> satisfiable par laravel/pint[v1.0.0, v1.1.0, v1.1.1].
- laravel/pint[v1.0.0, ..., v1.1.1] nécessite ext-xml * -> il est absent de votre système. Installez ou activez l'extension XML de PHP.

Attendez, PHP a besoin de l'extension XML ? Cela n’a jamais été répertorié comme une exigence ! OK, je vais faire une installation rapide d'apt php-xml.

Bien, tout est installé. Je vais relancer la configuration.

nouvel exemple d'application Laravel
Dans NewCommand.php ligne 789 :
L'application existe déjà !

Oh.

Le programme d'installation est donc à mi-chemin, a échoué car il n'avait pas vérifié ses dépendances et a laissé l'application dans un état défectueux. Ce n'est pas bon signe. Laravel est allumé, quoi, version 11 ?

Ils auraient sûrement déjà vérifié les exigences de base initiales ? Tant pis. Je vais juste rm -r example-app et recommencer, rien de perdu car je n'ai pas encore vraiment commencé.

Pour faire court¹ la prochaine dépendance manquante était l'extension DOM, ou peut-être l'extension XML. Ou peut-être l'extension cURL.

- phpunit/phpunit[11.0.1, ..., 11.4.3] nécessite ext-dom * -> il est absent de votre système. Installez ou activez l'extension dom de PHP.
- Root composer.json nécessite phpunit/phpunit ^11.0.1 -> satisfiable par phpunit/phpunit[11.0.1, ..., 11.4.3].

Je dois donc installer php-dom ? Non. Essayez-en d’autres. Stack Overflow à nouveau. Il s'avère que je dois installer php-curl. Très bien.

En avant. rm -r le répertoire et exécutez à nouveau l'assistant de configuration.

Mise en place d'un nouveau projet Laravel, prise 3 (tldr ; problèmes : hngg, confiance : toujours hésitante mais renforcée par les récents succès en matière de résolution de problèmes)

Il me demande quel serveur de base de données utiliser. Tous disent « Extension PDO manquante » à côté d'eux.

Soupir.

Je quitte le programme d'installation, supprime à nouveau tout le répertoire, apt install php8.3-mysql car il n'y a pas de package php-pdo direct ni d'alias pour php-mysql qui fonctionne non plus, donc j'ai fait quelques apt fastidieux recherche.

IlluminateDatabaseQueryException
SQLSTATE[HY000] [2002] Connexion refusée (Connexion : mysql, SQL : select existe (sélectionnez 1 dans information_schema.tables où table_schema = 'laravel_example_app' et table_name = 'migrations' et table_type dans ('BASE TABLE', 'SYSTEM VERSIONED' )) comme 'existe')

Qu'est-ce que ça fait maintenant ? A aucun moment cet installateur ne m'a demandé les détails de connexion à une base de données. Et il essaie d'exécuter des commandes SQL contre... quelque chose. Qui sait ?

En l'occurrence, j'ai un serveur MySQL exécuté sur un autre hôte de mon réseau local et j'étais prêt à l'utiliser (même si je noterai qu'apporter votre propre base de données n'était pas répertorié comme une exigence pour Laravel). Je suppose que j'aurais dû installer SQLite, peut-être que cela aurait fonctionné, car il n'aura besoin d'aucune information d'identification.

sudo apt install php8.3-sqlite

Réessayez.

rm -r exemple-app
laravel nouvel exemple d'application
...

Belle réussite. Voix de hacker "Je suis partant". Pour la victoire. Enfant qui réussit.

Conclusion

J'ai réussi ? Je pense.

Mais si quelqu'un m'avait demandé combien de temps cela pourrait prendre, alors, compte tenu de la documentation enthousiaste et de la réputation, j'aurais répondu 20 minutes. Si je le faisais pour le travail, mon chef de projet aurait doublé ou quadruplé ce montant en fonction de l'expérience des estimations des développeurs.

Combien de temps cela m’a-t-il réellement pris ? Une heure environ un soir et environ une heure le lendemain. Je n'étais pas pressé, mais ce n'était pas simple.

Et tu sais quoi ? Je n'en suis pas content. Il n'utilise pas MySQL, car cette partie du programme d'installation semble complètement cassée. J'utilise SQLite et c'est un pas de plus par rapport à ce qui se passerait dans un environnement de production réel. Il reste donc certainement certaines choses sur la liste TODO avant que je puisse commencer avec les tutoriels proprement dits.

Mais ça marche. Les étapes de construction prétendent qu'elles se sont déroulées sans accroc.

Je suis prêt pour la phase suivante : corriger les JsonException, l'erreur de syntaxe et ProcessTimedOutException qui apparaissent dans la console dès que j'ouvre la page de démonstration dans mon navigateur.

Euh-oh.

Si seulement tout se passait comme prévu, hein.

---

1. Refrain : trop tard ↩

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!