Prod : Déployer Laravel sur un hébergement mutualisé

Déployer votre site Laravel sur un hébergement mutualisé n’est pas toujours bien documenté. De nombreux articles existants ne fonctionnent pas (croyez-moi, je les ai tous essayés). J’aurais aimé avoir un guide comme celui-ci à l’époque, donc j’ai décidé d’en écrire un.

Pré-requis

• Votre application Laravel
• Git
• Un compte GitHub ou GitLab (supposons que vous en avez un)
• Un compte d’hébergement mutualisé
• SSH (optionnel)

Résumé

Pour déployer Laravel sur un hébergement mutualisé :

1. Clonez votre dépôt Git dans votre compte d’hébergement.
2. Configurez la base de données.
3. Configurez le fichier .htaccess pour définir le répertoire racine des documents.
4. Et voilà, votre application est prête à fonctionner.

Préparation

1. Initialisez un dépôt Git si ce n’est pas déjà fait :bash
   git init && git add . && git commit -m "Initial commit"
2. Créez un dépôt vide sur GitHub si nécessaire, puis poussez votre code vers ce dépôt :bash
   git remote add origin votre-url-github && git push origin master
3. Compilez les assets pour la production :bash
   npm run production
4. Commitez les changements et poussez-les :bash
   git add . && git commit -m "Ready for production" git push origin master

Déploiement

Accès SSH

En fonction de votre fournisseur d’hébergement, vous devrez peut-être contacter leur support pour obtenir un accès SSH. Certains hébergements permettent uniquement un accès Shell via une interface de navigateur.

Accéder à votre terminal CPanel

1. Connectez-vous à votre compte CPanel.
2. Allez dans Avancé > Terminal.
3. Une fois dans le terminal, rendez-vous dans le répertoire public_html : bash
   cd public_html

Configuration Git

1. Assurez-vous que Git est installé sur votre hébergement. Si ce n’est pas le cas, contactez votre fournisseur.
2. Pour éviter de saisir vos identifiants Git à chaque fois, configurez un stockage local des identifiants :bash

   git config credential.helper store --local Utilisez l’option --local pour que les identifiants soient spécifiques à ce dépôt uniquement.

3. Clonez votre dépôt :bash
   git clone votre-url-github

Activer les fonctions PHP désactivées

Pour des raisons de sécurité, certaines fonctions PHP, comme proc_open, peuvent être désactivées par votre hébergement. Voici comment les activer :

1. Dans le terminal de votre hébergeur, allez dans le répertoire racine et ouvrez le fichier php.ini : bash
   nano php.ini
2. Remplacez le contenu par : plaintext
   disable_functions = system,exec,passthru,shell_exec,proc_get_status,proc_terminate,proc_close,virtual,popen,show_source,curl_multi_exec
3. Enregistrez et fermez le fichier.

Configurer la base de données

1. Dans votre CPanel, créez une base de données.
2. Retournez dans le terminal et naviguez vers le répertoire de votre application Laravel : bash
   cd public_html/votre_nom_de_repo
3. Copiez le fichier .env.example en .env : bash
   cp .env.example .env
4. Modifiez le fichier .env pour y ajouter les informations de votre base de données.

Installer les dépendances

Dans le terminal, installez les dépendances de Laravel avec Composer :

bash