Avant de commencer à coder, il est crucial de configurer correctement votre environnement de développement Laravel 12. Ce guide couvre chaque étape essentielle, avec des explications et des commandes claires, pour préparer votre projet Laravel au développement.
1. Installer les prérequis
Ce dont vous avez besoin :
PHP 8.2 ou version ultérieure (Laravel 12 nécessite PHP 8.2 minimum)
Composer (gestionnaire de dépendances pour PHP)
Serveur de base de données (MySQL, PostgreSQL, SQLite ou SQL Server — le plus courant est MySQL/MariaDB)
Node.js et npm (pour compiler des ressources CSS/JS avec Vite)
Vérifier les installations
Exécutez les commandes suivantes dans votre terminal :
php -v # Check PHP version (>= 8.2 required)
composer --version
mysql --version
node -v
npm -v
👉 S'il manque quelque chose, installez-le à partir des sites officiels :
2. Créer un nouveau projet Laravel 12
Option 1 : Utilisation de Composer
composer create-project laravel/laravel myproject
Option 2 : Utiliser l'installateur Laravel
Si vous avez installé le programme d'installation de Laravel globalement :
laravel new myproject
Accédez au dossier du projet :
cd myproject
3. Configurer les variables d'environnement ( .envfichier)
Laravel utilise un .envfichier pour la configuration spécifique à l'environnement.
Copiez le fichier d'exemple :
cp .env.example .env
Mettre à jour le .envfichier :
APP_NAME=MyProject
APP_ENV=local
APP_KEY= # Will be generated later
APP_DEBUG=true
APP_URL=http://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=myproject_db
DB_USERNAME=root
DB_PASSWORD=your_db_password
📌 Remarques :
APP_DEBUG=truepermet des messages d'erreur détaillés (développement uniquement).Assurez-vous que les paramètres de votre base de données correspondent à votre configuration locale.
4. Générer la clé d'application
Exécutez la commande suivante pour générer une clé d’application :
php artisan key:generate
Cela met à jour automatiquement APP_KEYvotre fichier..env
5. Créer une base de données
Exemple (MySQL) :
CREATE DATABASE myproject_db;
Assurez-vous que le nom correspond à celui DB_DATABASEde votre .envfichier.
6. Exécuter les migrations de bases de données
Exécutez les migrations par défaut de Laravel :
php artisan migrate
Cela créera des tables essentielles comme users, password_resets, et plus encore.
7. Définir les autorisations de fichiers (Linux/macOS uniquement)
Laravel nécessite un accès en écriture à certains dossiers :
chmod -R 775 storage bootstrap/cache
Si l’utilisateur de votre serveur Web est différent :
sudo chown -R www-data:www-data storage bootstrap/cache
(Les utilisateurs de Windows n’ont généralement pas besoin de cette étape.)
8. Créer un lien symbolique de stockage
Pour rendre les fichiers téléchargés accessibles via le navigateur :
php artisan storage:link
Ce lien public/storage→ storage/app/public.
9. Installer les modules Node et compiler les ressources
Installer les dépendances Node.js :
npm install
Compiler les ressources pour le développement :
npm run dev
Compiler pour la production (optimisé et minifié) :
npm run build
📌 Laravel 12 utilise Vite (au lieu de Laravel Mix).
10. Exécutez le serveur de développement Laravel
Démarrer le serveur :
php artisan serve
Ouvrez maintenant votre navigateur et visitez :
http://localhost:8000
👉 Vous devriez voir la page d'accueil par défaut de Laravel 🎉
✅ Conclusion
Vous avez maintenant terminé la configuration préalable au développement de Laravel 12. Votre environnement est prêt, votre base de données est connectée et votre projet est entièrement configuré. Vous pouvez désormais commencer à développer votre application Laravel 12 en toute confiance. 🚀
