NOTLimai Docs
Cloner sur github

Cloner un projet Laravel

Guide complet pour cloner et lancer un projet Laravel depuis GitHub

Prérequis

Avant de commencer, assurez-vous d'avoir installé :

  • Git
  • PHP 8.1 ou supérieur
  • Composer
  • Node.js et npm

1. Cloner le projet

Clonez le repository GitHub sur votre machine locale :

git clone https://github.com/username/project-name.git
cd project-name

2. Installer les dépendances

Installez toutes les dépendances PHP du projet avec Composer :

composer install

3. Configuration de l'environnement

Créez le fichier .env à partir du fichier .env.example :

cp .env.example .env

Générez une clé d'application :

php artisan key:generate

Modifiez le fichier .env pour configurer :

  • Base de données : DB_DATABASE, DB_USERNAME, DB_PASSWORD
  • Variables d'environnement : APP_ENV, APP_URL, etc.

Exemple :

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel_db
DB_USERNAME=root
DB_PASSWORD=
APP_URL=http://localhost

4. Créer la base de données

Créez la base de données manuellement ou utilisez la commande :

php artisan db:create

Exécutez les migrations pour créer les tables :

php artisan migrate

5. Charger les seeders (optionnel)

Si le projet contient des seeders pour les données de test :

php artisan db:seed

Ou exécutez migration et seed en une seule commande :

php artisan migrate:fresh --seed

6. Installer les assets (si nécessaire)

Si le projet utilise Laravel Mix ou Vite :

npm install
npm run dev

Ou pour la production :

npm run build

7. Créer le lien de stockage

Si le projet utilise le stockage de fichiers :

php artisan storage:link

8. Lancer le serveur

Démarrez le serveur de développement Laravel :

php artisan serve

Le projet sera accessible sur : http://localhost:8000

Problèmes courants

Erreur de permissions

Si vous rencontrez des erreurs de permissions sur les dossiers storage/ et bootstrap/cache/ :

chmod -R 775 storage bootstrap/cache

Cache

Pour vider tous les caches :

php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clear

Extensions PHP manquantes

Vérifiez les extensions requises dans composer.json et installez-les si nécessaire. Extensions courantes :

  • OpenSSL
  • PDO
  • Mbstring
  • Tokenizer
  • XML
  • Ctype
  • JSON

Commandes utiles

  • Lister les routes : php artisan route:list
  • Vérifier la configuration : php artisan config:show
  • Créer un lien symbolique : php artisan storage:link
  • Mode maintenance : php artisan down / php artisan up