Comment installer un projet Laravel existant sur un nouvel ordinateur

Ce chapitre vous guidera à travers les étapes nécessaires pour installer un projet Laravel existant sur un nouvel ordinateur. Nous supposerons que vous avez déjà installé les outils requis et que vous utilisez un serveur de développement local comme Laragon ou Laravel Valet/Herd.

Prérequis#

Avant de commencer, assurez-vous que les éléments suivants sont installés sur votre ordinateur :

• PHP : Le langage de programmation sur lequel Laravel est construit, avec les extensions requises.
• Composer : Un gestionnaire de dépendances pour PHP, utilisé pour installer les packages nécessaires.
• Node.js et npm : Node.js est un environnement d'exécution JavaScript, et npm est son gestionnaire de packages. Ils sont utilisés pour compiler les assets front-end de Laravel.
• Un serveur de développement local : Outils comme Laragon ou Laravel Valet/Herd facilitent le développement local en gérant les configurations de serveur.

Étapes d'installation#

1. Cloner le dépôt du projet Laravel#

La première étape consiste à obtenir une copie du code source du projet. Vous pouvez le faire en clonant le dépôt Git du projet :

git clone https://github.com/nom-utilisateur/nom-du-projet.git

Cette action télécharge le code source du projet sur votre machine locale, vous permettant de travailler avec le même code que celui du dépôt distant.

2. Naviguer vers le répertoire du projet#

Après avoir cloné le dépôt, déplacez-vous dans le répertoire du projet :

cd nom-du-projet

Cela vous positionne dans le dossier du projet où vous exécuterez les commandes suivantes.

3. Installer les dépendances PHP avec Composer#

Installez les packages PHP nécessaires en exécutant :

composer install

Cette commande lit le fichier composer.json et installe toutes les bibliothèques et dépendances PHP dont le projet a besoin pour fonctionner.

4. Copier le fichier .env.example en .env#

Le fichier .env contient les variables d'environnement spécifiques à votre application, comme les informations de base de données. Créez-en une copie à partir de l'exemple fourni :

cp .env.example .env

Cette action crée un fichier .env que vous pourrez personnaliser pour votre environnement local.

5. Générer une nouvelle clé d'application#

Générez une clé unique pour votre application Laravel :

php artisan key:generate

La clé d'application est utilisée pour sécuriser les données chiffrées et les sessions. Cette commande met à jour la variable APP_KEY dans votre fichier .env.

6. Configurer les paramètres de base de données#

Ouvrez le fichier .env avec un éditeur de texte et configurez les informations de connexion à votre base de données :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nom_de_votre_base_de_donnees
DB_USERNAME=votre_nom_d_utilisateur
DB_PASSWORD=votre_mot_de_passe

Ces paramètres permettent à Laravel de se connecter à votre base de données pour effectuer des opérations comme les migrations et les requêtes.

7. Migrer la base de données#

Créez les tables nécessaires dans votre base de données en exécutant :

php artisan migrate

Les migrations sont des scripts qui créent ou modifient la structure de la base de données. Si la base de données spécifiée n'existe pas, la commande vous proposera de la créer.

8. Peupler la base de données avec des seeders (si disponibles)#

Si le projet contient des seeders pour insérer des données initiales, exécutez :

php artisan db:seed

Les seeders remplissent la base de données avec des données fictives ou initiales, utiles pour les tests ou pour démarrer l'application avec des données par défaut.

9. Créer un lien symbolique pour le stockage (si nécessaire)#

Si le projet utilise le stockage de fichiers (par exemple, pour les uploads), créez un lien symbolique vers le répertoire public :

php artisan storage:link

Cette commande crée un lien symbolique entre storage/app/public et public/storage, permettant un accès web aux fichiers stockés.

10. Installer les dépendances Node.js#

Installez les packages front-end nécessaires avec npm :

npm install

Cette commande lit le fichier package.json et installe toutes les dépendances JavaScript requises pour le front-end de l'application.

11. Compiler les assets front-end#

Compilez les fichiers CSS et JavaScript du projet :

• Pour le développement (avec source maps et sans minification) :

  npm run dev
  

• Pour la production (optimisé et minifié) :

  npm run build
  

La compilation des assets génère les fichiers optimisés nécessaires pour le front-end de l'application, en combinant et en minifiant le code pour de meilleures performances.

12. Démarrer le serveur local#

Avec votre serveur de développement local (Laragon, Laravel Valet/Herd), votre application devrait être automatiquement reconnue et servie. Assurez-vous que votre serveur est en cours d'exécution et accédez à l'application via votre navigateur web à l'adresse appropriée, par exemple :

http://nom-du-projet.test

Cette étape vous permet de visualiser et de tester votre application Laravel dans un environnement local.

Conclusion#

Vous avez maintenant installé avec succès un projet Laravel existant sur votre nouvel ordinateur. Ce processus vous permet de configurer rapidement un environnement de développement local pour travailler sur le projet. N'oubliez pas de consulter la documentation du projet pour d'éventuelles instructions supplémentaires spécifiques à celui-ci.