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-name2. Installer les dépendances
Installez toutes les dépendances PHP du projet avec Composer :
composer install3. Configuration de l'environnement
Créez le fichier .env à partir du fichier .env.example :
cp .env.example .envGénérez une clé d'application :
php artisan key:generateModifiez 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://localhost4. Créer la base de données
Créez la base de données manuellement ou utilisez la commande :
php artisan db:createExécutez les migrations pour créer les tables :
php artisan migrate5. Charger les seeders (optionnel)
Si le projet contient des seeders pour les données de test :
php artisan db:seedOu exécutez migration et seed en une seule commande :
php artisan migrate:fresh --seed6. Installer les assets (si nécessaire)
Si le projet utilise Laravel Mix ou Vite :
npm install
npm run devOu pour la production :
npm run build7. Créer le lien de stockage
Si le projet utilise le stockage de fichiers :
php artisan storage:link8. Lancer le serveur
Démarrez le serveur de développement Laravel :
php artisan serveLe 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/cacheCache
Pour vider tous les caches :
php artisan cache:clear
php artisan config:clear
php artisan route:clear
php artisan view:clearExtensions 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