Installer Laravel

Laravel est un framework PHP open source mature, conçu pour le développement web moderne. Basé sur le modèle architectural MVC (Model-View-Controller), il offre aux développeurs une syntaxe élégante, un ensemble d'outils robustes et un écosystème étendu.

Avant de commencer, assurez-vous que Composer — le gestionnaire de dépendances incontournable pour PHP — est installé sur votre système.

Méthode 1 : Via le programme d'installation Laravel (recommandé)

C'est la façon la plus efficace de gérer plusieurs projets Laravel.

1. Installer le programme d'installation Laravel de manière globale :

   composer global require laravel/installer
   

2. Configurer le chemin système (pour que la commande laravel soit reconnue) :
   Pour Ubuntu/Debian, ajoutez la ligne suivante à votre profil :

   export PATH="$PATH:$HOME/.config/composer/vendor/bin"
   source ~/.bashrc
   

3. Créer un nouveau projet :

   laravel new project_name
   

Méthode 2 : Installation via Composer create-project

Si vous préférez une installation ponctuelle sans le programme d'installation global, exécutez cette commande dans le répertoire souhaité :

composer create-project laravel/laravel project_name

Configurer le document root

Par défaut, le point d'entrée de Laravel est le répertoire /public. Pour que votre site se charge correctement, vous devez pointer votre serveur web vers ce dossier.

• Option A : Modifier les paramètres d'hébergement (recommandé).
  Dans votre panneau de contrôle, changez le « Document Root » ou le « Home Directory » du site vers /path/to/your/project/public.

• Option B : Via .htaccess (solution de contournement).
  Si vous ne pouvez pas modifier le document root, créez un fichier .htaccess à la racine de votre projet :

# .htaccess à la racine du projet
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteRule ^$ public/ [L]
    RewriteRule ^((?s).*) public/$1 [L]
</IfModule>

Assurez-vous ensuite que le fichier .htaccess par défaut est bien présent dans le dossier /public :

# public/.htaccess
<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^ index.php [L]
</IfModule>

Conseils post-installation

• Définir les permissions : pour que Laravel fonctionne correctement, le serveur web doit avoir accès en écriture à certains dossiers :

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache   # pour Ubuntu/Debian

• Prêt pour la production : pour les tâches telles que les queues et la planification, envisagez de configurer Supervisor ou un Cron job système.
• Documentation officielle : pour les dernières mises à jour et des tutoriels approfondis, consultez le site officiel : laravel.com