Comment installer un projet Laravel que vous avez cloné depuis Git

Comment installer un projet Laravel que vous avez cloné depuis Git

par Sidick Allaladé le 11/03/2020 |

Mis à jour le 7/07/2020


Laravel est un Framework php puissant et comme son slogan le mentionne, c'est vraiment le Framework PHP pour les artisans du web - 'The PHP Framework for Web Artisans'.

Cela arrive d'oublier des étapes ou commandes lors de l'installation de vos projet Laravel, ce tutoriel explique toutes les étapes. 

Voici en quelques étapes comment installer un projet Laravel sur un serveur ou environnement Linux à partir de git. 

1- Connectez vous avec les bonnes permissions (optionnel)

Etant connecté en tant que root ou superadmin sur votre serveur, assurez-vous de changer d’usager afin de vous connecter avec l’usager web par défaut de votre projet. 

Faites simplement :

  •  su votrenomdusager 

2- Clonez votre repo *

Que votre projet soit hébergé sur Github, Gitlab, Bitbucket ou autre, le tout reviens a GIT, donc nous pouvons utiliser git sur notre machine local ou serveur pour cloner notre projet.

  • git clone lienversvotrerepo.com/nomDuProjet

Notez que vous pouvez cloner votre projet de 2 manières différentes, un en mode HTTPS et un autre en mode SSH.  

ASTUCES PRO : Vous pouvez cloner votre projet à partir d’une branch spécifique en faisant 

  • git clone -b nomdelabranch lienversvotrerepo.com/nomDuProjet

3- Accédez au répertoire de votre projet *

Après votre clone, un nouveau dossier portant le nom de votre projet devrait etre crée dans votre emplacement actuel.

Vous devez simplement y accéder en faisant un ;

  • cd nomduprojet

4- Installer les dépendances du projet à partir de composer 

Chaque fois que vous clonez un nouveau projet Laravel, vous devez installer toutes les dépendances du projet. C'est ce qui permet d'installer Laravel lui-même, parmi d'autres paquets nécessaires pour démarrer votre application. 

Lorsque nous lançons composer, il vérifie le fichier composer.json qui est dans votre repo et liste tous les paquets composer dont votre repo a besoin. Comme ces paquets changent constamment, le code source n'est généralement pas soumis à git, ceci grace au .gitignore qui devrait toujours contenir votre répertoire vendor.

Donc pour installer tout le code source nécessaire, nous lançons composer avec la commande suivante.

  • composer install

5- Installer les dépendances NPM (optionnel)

Ceci est exactement comme l’étapes précédente à la seule différence qu’il vous permettra d'installer Vue.js, Bootstrap.css, Lodash et Laravel Mix etc…

Bref au lieu d’installer du code PHP comme a l’étape précédente, il s'agit d'installer les paquets Javascript (ou Node) requis.

 La liste des paquets nécessaire dans ce cas sont indiquée dans le fichier ‘packages.json’.

Si votre projet n’utilise donc pas vue.js, node ou autre vous pouvez sautez cette étape sinon vous devez faire : 

  • npm install

D’autre préfere Yarn , si c’est votre cas faite simplement 

  • Yarn

6- Créez une copie de votre fichier .env

Les fichiers .env ne sont généralement pas soumis a votre repo, si ce n’est pas le cas je vous invite à corriger ceci pour des raisons de sécurité.

Mais il existe un exemple de fichier .env, qui est un modèle du fichier .env que tout projet Laravel a besoin pour démarrer. 

Nous allons donc faire une copie du fichier .env.example et créer un fichier .env que nous pourrons remplir avec nos paramètres de configuration.

  • cp .env.example .env

7- Générez votre clé d’encryption

Laravel exige que vous ayez une clé d’encryption pour chacune de vos applications, ceci est généralement généré de manière aléatoire et stocké dans votre fichier .env. L'application utilisera cette clé d’encryption pour encoder divers éléments de votre application, tels que les cookies, le hachages de mots de passe et bien d’ autres éléments.

Heureusement les outils en ligne de commande de Laravel permettent de générer cette clé très facilement. Dans le terminal, nous pouvons exécuter cette commande pour générer cette clé. 

  • php artisan key:generate

Fermez et ouvrez à nouveau votre fichier .env, vous devriez remarquez que votre clé s’est généré dans la variable : APP_KEY

8- Quelques commandes pratiques (Optionnel)

Si votre projet ne contient pas de base de données à ce niveau, il devrait déjà fonctionné.

Si c’est le cas Parfait : tout fonctionne comme sur des roulettes 


Sinon essayez ces commandes qui peuvent aider :

Mettez les bonnes permissions a l’ensemble des répertoires et fichiers de votre projet en exécutant simplement

  • chmod 755 -R nomdevotreprojet/
  • chmod -R o+w nomdevotreprojet/storage

Nettoyer votre projet

  • php artisan cache:clear
  • php artisan view:clear
  • php artisan config:clear

Parfois il faut que vous ajoutez à votre url /public/ ou /index.php/

Ce n’est pas terminé, et si vous avez une base de donnée ? 

Bien on continue 

9- Créez une base de données vide pour votre projet Laravel

Créez une base de données vide pour votre projet en utilisant n’importe quels outils de base de données que vous préférez (Mon préféré est Datagrip pour mac, mais parfois j’utilise DBForge, ou Mysql Workbench ou meme le bon vieux Phpmyadmin).

10- Configurez votre fichier .env pour permettre une connexion à la base de donnée.

Nous voudrons permettre à Laravel de se connecter à la base de données que vous venez de créer à l'étape précédente. Pour ce faire, nous devons ajouter les références de connexion dans le fichier .env et Laravel se chargera de la connexion à partir de là.

Dans le fichier .env, remplissez les options DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME et DB_PASSWORD pour qu'elles correspondent aux informations d'identification de la base de données que vous venez de créer. 

11- Ajouter les tables et contenus de votre base de données avec les migrations ou en sql

Les migrations dans Laravel vous permettent d’avoir toutes votre architecture de BD dans votre code et avec une simple ligne de commande vous pouvez recréer toutes vos tables.

  • php artisan migrate

Cette commande crée la structure de votre base de donnée mais ne remplis aucune tables.

Si votre dépôt dispose d'un fichier seed, c'est le moment de l’exécuter,  afin de remplir votre base de données avec des données de démarrage ou factices.

  • php artisan db:seed

ASTUCES PRO : Vous pouvez combiner les 2 précédentes commandes en une seule qui est celle-ci : 

  • php artisan migrate:fresh --seed

Les migrations sont supers pratique, mais si vous n’en avez pas ce n’est pas grave vous pouvez simplement importer le fichier sql de votre ancienne base de données avec votre outil de base de données préférées. Ceci créera toutes vos tables avec vos contenus.

Conclusion

C'est tout ce dont vous avez besoin pour démarrer un projet. Bien sûr, certains projets comportent des étapes spécifiques qui ne s'appliquent qu'à ce projet Laravel, mais les étapes que j'ai décris ci-dessus sont les étapes nécessaires que vous devrez suivre pour démarrer n'importe quel projet Laravel standard à partir d'un clone de git.

C'est essentiellement la même chose sur windows, sauf si vous n'avez pas de terminal batch. Ce qui serait surprenant car en installant git sur un serveur ou machine windows, ensuite en faisant un clic droit dans votre dossier, vous devez avoir l'option 'git bash here' et le tour est joué.

Si vous rencontrez des difficultés, laisser un commentaire et notre équipe se fera un plaisir de vous aider.

J'espère que cela vous a aidé à démarrer votre prochain projet. N'oubliez pas de vous inscrire a notre infolettre ou nous suivre sur les réseaux sociaux pour d'autres excellents tutoriels sur les technologies web et techniques de marketing populaires. Vous savez maintenant comment installer Laravel pour faire votre projet.

Sidick Allaladé

Sidick Allalade, est directeur technologique à Oshara INC, et Co-fondateur de l'application web Osortoo. Il adore résoudre les problèmes informatique complexe, douée dans le code et l'univers informatique, il a une bonne connaissance du marketing en ligne et en Gouvernance, Audit et sécurité des TI. 

Ses expériences sur des centaines de projets avec des compagnies de différentes envergures font de lui un atout précieux dans le web.

Cet article a-t-il été utile ?

Les lecteurs de cet article lisent aussi ...

Pourquoi suivre un processus de conception pour vos logiciels ou applications web ?

Un sage a dit un jour que si on ne planifie pas, on planifie alors d'échouer. Souhaitez-vous réduire le temps de développement de vo...

Pourquoi suivre un processus d...


Une agence de communication tout ce qu'il faut savoir

Une agence de communication to...


Développer une application Native, Hybride ou Web ? Quels sont les différences ?

Il existe différents types d'application (app), ayant chacune leurs avantages et inconvénients. Nous essayerons ici d'éclaircir vos ...

Développer une application Na...


Les secrets d'une stratégie marketing conforme au RGPD sans diminuer vos revenus ?

Le GDPR ou en francais RGPD est l’initiale de Réglement Général pour la Protection des Données et désigne la dernière directive...

Les secrets d'une stratégie m...


Comment obtenir une certification instagram ?

A l’identique de Twitter et Facebook, Instagram offre la possibilité aux administrateurs d’une page Instagram de certifier certai...

Comment obtenir une certificat...


Comment choisir son CMS : Wordpress, Joomla ou Drupal

De nos jours, mettre en place un site internet n«a jamais été aussi aisé. Désormais, la principale difficulté est de sélectionne...

Comment choisir son CMS : Word...


×