Laravel est le framework PHP le plus populaire et fonctionne très bien sur un hébergement partagé. Dans ce guide, vous apprendrez comment installer, configurer et préparer Laravel pour la production sur l'hébergement Theory7.

Exigences pour Laravel

Avant de commencer, vérifiez si votre hébergement répond aux exigences.

Exigences PHP

Laravel 11 nécessite :

  • PHP 8.2 ou supérieur
  • BCMath PHP Extension
  • Ctype PHP Extension
  • Fileinfo PHP Extension
  • JSON PHP Extension
  • Mbstring PHP Extension
  • OpenSSL PHP Extension
  • PDO PHP Extension
  • Tokenizer PHP Extension
  • XML PHP Extension

Sur l'hébergement Theory7, toutes les extensions requises sont disponibles par défaut.

Autres exigences

  • Accès SSH (pour Composer)
  • Base de données MySQL ou MariaDB
  • Espaces disque suffisants (minimum 100 Mo)
  • Composer disponible via la ligne de commande

Activer l'accès SSH

Installer Laravel nécessite un accès SSH.

Activer SSH dans DirectAdmin

  1. Connectez-vous à DirectAdmin
  2. Allez dans Gestionnaire de compte
  3. Cliquez sur Clés SSH
  4. Générez ou téléchargez votre clé SSH
  5. Activez l'accès SSH

Voir aussi : Activer l'accès SSH

Établir une connexion

ssh utilisateur@votredomaine.nl
# Ou avec le port :
ssh -p 7777 utilisateur@serveur.theory7.net

Installer Laravel via Composer

Vous pouvez maintenant installer Laravel.

# Allez dans le dossier de votre domaine
cd ~/domains/votredomaine.nl

Créer un projet Laravel

Installez Laravel dans un sous-dossier :

# Créer un nouveau projet Laravel
composer create-project laravel/laravel projet
# Cela crée un dossier 'projet' avec Laravel

Ou directement dans le dossier actuel :

# Dans un dossier vide
composer create-project laravel/laravel .

Vérifier l'installation

# Vérifiez la version de Laravel
cd projet
php artisan --version
# Sortie : Laravel Framework 11.x.x

Configurer la racine du document

L'hébergement partagé nécessite une configuration spéciale pour Laravel.

Créer un lien symbolique public_html

Le dossier public de Laravel doit être la racine du document :

# Supprimez ou renommez l'ancien public_html
cd ~/domains/votredomaine.nl
mv public_html public_html_backup
# Créez un lien symbolique vers le public de Laravel
ln -s projet/public public_html

Alternative : .htaccess à la racine

Si les liens symboliques ne fonctionnent pas :

# Dans le .htaccess à la racine
RewriteEngine On
RewriteRule ^(.*)$ projet/public/$1 [L]

Configurer la base de données

Laravel a besoin d'une base de données.

Créer une base de données dans DirectAdmin

  1. Allez dans Gestionnaire de compte puis Gestion MySQL
  2. Cliquez sur Créer une nouvelle base de données
  3. Choisissez un nom et un mot de passe
  4. Notez les informations

Configurer le fichier .env

Éditez le fichier .env :

cd ~/domains/votredomaine.nl/projet
nano .env

Modifiez les paramètres de la base de données :

DB_CONNECTION=mysql
DB_HOST=localhost
DB_PORT=3306
DB_DATABASE=votre_nom_de_base_de_données
DB_USERNAME=votre_utilisateur_de_base_de_données
DB_PASSWORD=votre_mot_de_passe_de_base_de_données

Configurer l'application

Définissez la configuration de base.

Générer la clé de l'application

php artisan key:generate

Cela génère une clé de cryptage unique dans .env.

Paramètres de production

Modifiez .env pour la production :

APP_NAME="Mon Application Laravel"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://votredomaine.nl
LOG_CHANNEL=daily
LOG_LEVEL=error

Paramètres de cache

Optimisez pour la production :

CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_CONNECTION=database

Configurer le stockage

Laravel a besoin d'un accès en écriture pour le stockage.

Créer un lien de stockage

php artisan storage:link

Cela crée un lien symbolique de public/storage vers storage/app/public.

Définir les permissions

# Assurez-vous que le stockage est accessible en écriture
chmod -R 775 storage
chmod -R 775 bootstrap/cache

Exécuter les migrations

Créez les tables de la base de données :

# Exécutez les migrations
php artisan migrate
# Avec seeding (si disponible)
php artisan migrate --seed

Optimisation de la production

Optimisez Laravel pour la vitesse.

Cache de configuration

php artisan config:cache

Cela met en cache toute la configuration dans un seul fichier.

Cache de route

php artisan route:cache

Accélère considérablement la résolution des routes.

Cache de vue

php artisan view:cache

Précompile toutes les templates Blade.

Optimisation de l'autoloader

composer install --optimize-autoloader --no-dev

Tout en une fois

php artisan optimize

Configurer une tâche cron

Le planificateur de Laravel a besoin d'une tâche cron :

  1. Allez dans DirectAdmin
  2. Allez dans Fonctionnalités avancées puis Tâches cron
  3. Ajoutez une tâche cron :
    4. * * * * * cd ~/domains/votredomaine.nl/projet && php artisan schedule:run >> /dev/null 2>&1

Problèmes courants

Erreur 500 après l'installation

  1. Vérifiez si .env existe
  2. Générez la clé de l'application : `php artisan key:generate`
  3. Vérifiez les permissions de stockage

Le lien de stockage ne fonctionne pas

# Supprimez l'ancien lien
rm -f public/storage
# Créez à nouveau
php artisan storage:link

Erreur de mémoire Composer

# Augmentez la limite de mémoire
php -d memory_limit=512M /usr/local/bin/composer install

Page blanche sans message d'erreur

  1. Activez temporairement le débogage : `APP_DEBUG=true`
  2. Vérifiez l'erreur
  3. Désactivez à nouveau le débogage

Effectuer des mises à jour

Gardez Laravel à jour :

# Mettez à jour les dépendances
composer update
# Exécutez de nouvelles migrations
php artisan migrate
# Videz et reconstruisez le cache
php artisan optimize:clear
php artisan optimize

Articles connexes

Besoin d'aide ?

Nous sommes là pour vous aider ! Vous rencontrez des problèmes ou avez des questions ? Notre équipe de support est prête à vous aider personnellement. Envoyez-nous un message via le système de tickets - nous répondons généralement dans quelques heures et sommes heureux de vous aider.