Installation Laravel pour les nuls – Etape 1

Initialisation

Prérequis et environnement

Étape 1: Vérifier l’environnement de base

== Vérifier si PHP est installé
php --version
== Vérifier si Composer est installé
composer --version

Étape 2: Installation de PHP via MAMP (si pas installé)

Si PHP n’est pas trouvé :

  1. Télécharger MAMP : https://www.mamp.info/en/downloads/
  2. Installer le package .dmg
  3. Configurer le terminal pour utiliser PHP de MAMP

Configuration de l’environnement terminal

Étape 3: Configuration du shell (zsh recommandé)

== Changer vers zsh (recommandé par macOS)
chsh -s /bin/zsh
== Fermer et rouvrir le terminal complètement

Étape 4: Configurer PHP dans le PATH

== Éditer le fichier de configuration
nano ~/.zshrc
== Ajouter cette ligne (ajuster selon votre version MAMP)
export PATH="/Applications/MAMP/bin/php/php8.3.14/bin:$PATH"
== Sauvegarder : Ctrl+X, puis Y, puis Entrée
== Recharger la configuration
source ~/.zshrc
== Tester PHP
php --version

Étape 5: Alternative – Créer un lien symbolique

== Si la méthode PATH ne fonctionne pas
sudo ln -s /Applications/MAMP/bin/php/php8.3.14/bin/php /usr/local/bin/php
== Tester
php --version

Installation de Composer

Étape 6: Installation de Composer

== Télécharger et installer Composer
curl -sS https://getcomposer.org/installer | php
== Déplacer composer pour usage global
sudo mv composer.phar /usr/local/bin/composer
== Rendre exécutable
sudo chmod +x /usr/local/bin/composer
== Vérifier l'installation
composer --version

Création du projet Laravel

Étape 7: Créer le nouveau projet Laravel

== Créer le projet (remplacer "mon-projet" par votre nom)
composer create-project laravel/laravel mon-projet
== Accéder au projet
cd mon-projet
== Vérifier Laravel
php artisan --version

Étape 8: Test du projet

== Démarrer le serveur de développement
php artisan serve
== Ouvrir dans le navigateur : http://127.0.0.1:8000

Migration depuis un projet existant

Étape 9: Copier les fichiers d’un ancien projet (optionnel)

== Supposons que l'ancien projet soit dans ../ancien-projet
== 1. Migrations
rm database/migrations/*.php
cp ../ancien-projet/database/migrations/*.php database/migrations/
== 2. Models
rm app/Models/User.php
cp ../ancien-projet/app/Models/*.php app/Models/
== 3. Controllers
cp -r ../ancien-projet/app/Http/Controllers/* app/Http/Controllers/
== 4. Routes
cp ../ancien-projet/routes/web.php routes/web.php
cp ../ancien-projet/routes/api.php routes/api.php
== 5. Mettre à jour l'autoloader
composer dump-autoload
== 6. Exécuter les migrations
php artisan migrate:fresh
== 7. Vérifier les routes
php artisan route:list

Commandes utiles de vérification

Étape 10: Vérifications et dépannage

== Vérifier la structure du projet
ls -la
== Nettoyer le cache Laravel
php artisan config:clear
php artisan cache:clear
== Vérifier les routes définies
php artisan route:list
== Vérifier les migrations
php artisan migrate:status
== Démarrer le serveur
php artisan serve

Checklist de vérification

  • [ ] PHP installé et accessible (php --version)
  • [ ] Composer installé (composer --version)
  • [ ] Projet Laravel créé (composer create-project)
  • [ ] Dans le bon répertoire (cd mon-projet)
  • [ ] Laravel fonctionne (php artisan --version)
  • [ ] Serveur démarre (php artisan serve)
  • [ ] Site accessible dans le navigateur

Résolution des problèmes courants

Si “php: command not found”

== Vérifier les versions PHP disponibles
ls /Applications/MAMP/bin/php/
== Créer le lien symbolique avec la bonne version
sudo ln -s /Applications/MAMP/bin/php/php[VERSION]/bin/php /usr/local/bin/php

Si “composer: command not found”

== Réinstaller Composer
curl -sS https://getcomposer.org/installer | php
sudo mv composer.phar /usr/local/bin/composer
sudo chmod +x /usr/local/bin/composer

Si “Could not open input file: artisan”

== Vérifier que vous êtes dans le bon répertoire
pwd
cd mon-projet
php artisan --version

Votre environnement Laravel est maintenant prêt pour le développement

par