Création d’un projet Laravel

Une fois que vous avez installé votre boîte Homestead, vous pouvez débuter le développement de votre premier projet Laravel.

Dans cet article, je vais vous guider pour que l'installation de votre projet Laravel se déroule rondement.

▼Publicité

Chacun de vos projets Laravel sera d'abord composé des fichiers de base de Laravel, que vous téléchargerez en bloc. Les fichiers du projet seront placés dans un dossier propre au projet, lui-même placé sous le dossier configuré dans le fichier Homestead.yaml (ex : C:\users\VotreNom\Documents\CodeLaravel).

De plus, chaque projet pourra être lancé dans un navigateur via un nom de domaine local (qui ne fonctionnera que sur votre ordinateur) qui lui est propre. Des configurations seront ajoutées à cet effet dans le fichier Homestead.yaml ainsi que dans le fichier hosts.

Voici donc les étapes à réaliser pour démarrer un projet Laravel.

  1. Dans Git Bash, lancez votre machine virtuelle :

    Console Git Bash

    cd Homestead

    vagrant up

  2. Ouvrez une console SSH :

    Console Git Bash

    vagrant ssh

    vagrant ssh

  3. Déplacez-vous dans le dossier Code de votre machine virtuelle :

    Console Vagrant SSH

    cd Code

  4. Pour débuter le développement de votre projet Laravel vous devez… créer un projet Laravel ! La création du projet consiste à télécharger les fichiers de base de Laravel et à les installer dans un sous-dossier du dossier où vous êtes positionné.

    Les fichiers seront récupérés à l’aide de l’utilitaire composer, un gestionnaire de dépendances.

    Pour connaître les « packages » disponibles et leurs versions, rendez-vous sur http://packagist.org et recherchez Laravel.

    packagist.org

    Cliquez sur laravel/laravel.

    packagist.org

    Voici la commande permettant de créer un nouveau projet Laravel. L’avant-dernier paramètre (ici, HelloWorld), est le nom du projet, qui sera également utilisé pour créer le dossier du projet.

    Console Vagrant SSH

    composer create-project laravel/laravel HelloWorld --prefer-dist

  5. Ouvrez le fichier Homestead.yaml, situé dans le dossier C:\Users\VotreNom\.homestead, à l’aide d’un éditeur de votre choix puis ajoutez une configuration pour associer le dossier du projet à un nom de domaine local. Rappel : le nom du dossier qui contient Homestead.yaml débute par un point : .homestead. Il existe également un dossier Homestead (sans point) mais ce n'est pas là que vous devez travailler.

    Note : le fichier Homestead.yaml utilise le chemin de votre machine virtuelle et non celui de votre ordinateur. Ainsi, le dossier C:\users\VotreNom\Documents\CodeLaravel\HelloWorld\public de votre ordinateur correspond à /home/vagrant/Code/HelloWorld/public sur votre machine virtuelle.

    Fichier Homestead.yaml

    sites:

        - map: homestead.app

          to: /home/vagrant/Code/Laravel/public

        - map: helloworld.app

          to: /home/vagrant/Code/HelloWorld/public

    Remarquez que le nouveau chemin se termine par public. C’est que Laravel est conçu pour que la racine du site Web soit à cet endroit.

    Remarquez également que les noms de domaines locaux se terminent par .app. Il s'agit de la façon de faire habituelle pour le développement d'applications Laravel. Vous êtes libres de choisir le nom de domaine que vous désirez mais l'utilisation de .app est fortement suggérée puisqu'elle correspond à ce que les développeurs s'attendent de voir.

    Attention : dans le fichier Homestead.yaml, vous devez utiliser des espaces et non des caractères de tabulation. De plus, pour éviter que des caractères invisibles indésirables ne soient insérés, il est conseillé de ne pas faire de copier-coller à partir du Web pour y ajouter des lignes.

  6. Éditez le fichier hosts de votre ordinateur (présent dans le dossier C:\Windows\System32\drivers\etc) afin d’associer le nom de domaine local à l’adresse IP indiquée dans le fichier Homestead.yaml :

    Fichier hosts

    192.168.10.10    helloworld.app

  7. Il vous faut maintenant dire à votre machine virtuelle de prendre en compte les changements apportés au fichier Homestead.yaml. Ceci sera fait en deux étapes : retrouver l’identifiant de la machine Homestead à l’aide de vagrant global-status, puis forcer la reconfiguration de la machine virtuelle à l’aide de vagrant provision suivi de l’identifiant.

    Mais d'abord, vous devez sortir de la console Vagrant SSH.

    Console Vagrant SSH

    exit

    De retour à la console Git Bash, lancez la commande suivante :

    Console Git Bash

    vagrant global-status

    Puis utilisez dans la commande suivante l'identifiant ainsi obtenu :

    Console Git Bash

    vagrant provision 8c22ea0

    vagrant provision

  8. À ce stade, il est possible de tester notre installation en entrant l’URL configuré dans Homestead.yaml (ici : helloworld.app).

    Page d'accueil du projet Laravel

Vous voici donc prêts à débuter votre développement.

Merci de partager ! Share on FacebookTweet about this on TwitterShare on Google+Share on LinkedInPin on PinterestShare on StumbleUponEmail this to someone
Catégories