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 6/04/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'.

Si ca vous arrive d'oublier des étapes ou commandes lors de l'installation de vos projet Laravel, ce tuto est pour vous. 

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

1- Connecter vous avec les bonne permissions (optionnel)

Si vous êtes 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. 

Faite simplement :

  • su votrenomdusager

2- Cloner 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, 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éder 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 actuelle.

Vous devez simplement y acceder 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éer 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 a 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 tous 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 parametres 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ée de manière aléatoire et stockée 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 a ce niveau il devrait déjà fonctionner.

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éer une base de donnée vide pour votre projet

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 connection a 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ée 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 conbiner les 2 précédentes commandes en une seul qui est celle-ci : 

  • php artisan migrate:fresh --seed

Les migrations sont super pratique, mais si vous n’en avez pas ce n’est pas grave vous pouvez simplement importez le fichier sql de votre ancienne base de donnée avec votre outils de base de données préféré. 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, mais les étapes que j'ai décrites 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 suivres sur les réseaux sociaux pour d'autres excellents tutoriels sur les technologies web et techniques de marketing populaires.

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

Les lecteurs de cet article lisent aussi ...

Une agence de communication tout ce qu il faut savoir

Par définition, Une agence de communication (marketing) est une entreprise qui planifie et harmonise la communication interne et / o...

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 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...


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...


L'importance d'une URL bien structurée

Saviez-vous qu'une URL bien planifiée peut être un facteur décisif dans le succès de votre site Web ?

L'importance d'une URL bien st...


×