Comment installer une application web Laravel que vous avez cloné depuis Git

Comment installer une application web Laravel que vous avez cloné depuis Git

par Sidick Allaladé le 11/03/2020 |

Mis à jour le 30/07/2021


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


Laravel permet de créer aussi bien de simple site web, que des sites e-commerce, ou des applications web tres complexes et meme des Applications web sur mesure, ou encore des applications SAAS (Logiciel en tant que service). 

En d'autre termes, il vous permet de créer des solutions web personalisé sans limites en fonction de vos besoins, vous pourriez par exemple créer un réseau social tel que Facebook avec Laravel.


Laravel ne vous permet pas seulement de créer des solutions web uniques non conventionnelles et facilement évolutives, mais vous permet de facilement surmonter toutes les difficultés liées aux tests, à la formation de mécanismes de routage, à l'authentification, au commerce électronique, à la sécurité, au  Référencement SEO , etc.


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

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


Notez que lorqu'on parle ici d'une application web, il s'agit aussi bien d'un simple site internet ou d' un logiciel web plus élaboré fait sur mesure.


1- Connectez vous avec les bonnes permissions (optionnel)


Etant connecté en tant que root ou superadmin sur votre serveur web, 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 application web 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 application web.

  • git clone lienversvotrerepo.com/nomDuProjet

Notez que vous pouvez cloner votre application web 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 web *


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

Vous devez simplement y accéder en faisant un ;

  • cd nomduprojet


4- Installer les dépendances de l'application web à 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 web. 

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 application web a besoin. Comme ces paquets changent constamment, le code source n'est généralement pas soumis à git, ceci grace au fichier .gitignore qui devrait toujours contenir votre répertoire vendor.

Donc pour installer tout le code source nécessaire, nous installons l'application web grace a 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 par votre application web.

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

Si votre application web 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. Laravel utilisera cette clé d’encryption pour encoder divers éléments de votre application web, 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 application web 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 afin de 


* Définir 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 web laravel

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


* Retirer des fichiers que vous avez accidentellement envoyé dans votre repo Git, l'exemple suivant est avec le dossier vendor, mais cette commande fonctionne pour n'importe quel dossier ou fichier


  • git rm -r --cached vendor
  • git rm -r --cached composer.lock
  • git commit -m "untrack vendor directory"
  • git push



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 application web 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 à notre application web 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 examples.

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



12- Et Ensuite ?


Une fois que votre site web ou application web est en ligne, vous aimeriez certainement qu'il soit visible par les être humain, mais aussi par les moteurs de recherche. 

Ne perdez donc pas de vue,  l'aspect référencement organique (SEO) , et bien sur, Laravel vous permet aussi bien de créer des applications web sur mesure complexe, mais aussi d' être bien référencé sur le web. 

Pour ce faire voici quelques astuce pour améliorer son  référencement web SEO  avec Laravel .


a- Utiliser des métas-tag sur toutes vos pages web public

b- Améliorer la vitesse de votre site internet ou application web

c- Genérer un Sitemap

d- Installer un certificat SSL

e- et bien d'autres...


Si etre visible sur le web vous intéresse aussi cet article afin d'apprendre Comment réussir son référencement SEO en 3 mois pourrait vous intéresser.


Conclusion


C'est tout ce dont vous avez besoin pour démarrer un projet web Laravel. Bien sûr, certains projets comportent des étapes spécifiques qui ne s'appliquent qu'à ce projet Laravel, mais les étapes décris ci-dessus sont les étapes nécessaires que vous devrez suivre pour démarrer en général n'importe quel application web sur 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 démarrer votre application web.

Questions fréquemment posées

C’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'.

Il vous permet de créer des solutions web personnalisés sans limites en fonction de vos besoins, vous pourriez par exemple créer un réseau social tel que Facebook avec Laravel.

Clonez votre repo, accédez au répertoire de votre projet web, installer les dépendances de l'application web à partir de composer, créez une copie de votre fichier .env, générez votre clé d’encryption, créez une base de données vide pour votre projet Laravel, configurez votre fichier .env pour permettre une connexion à la base de donnée et ajouter les tables et contenus de votre base de données avec les migrations ou en sql.



Sidick Allaladé

Sidick Allalade, est directeur technologique à Oshara INC, et Co-fondateur de l'application web Osortoo. Il adore résoudre les problèmes informatiques complexes, doué 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...


Comment installer une application web Laravel que vous avez cloné depuis Git

Laravel est un Framework php puissant qui vous permet de créer des applications web sur mesures

Comment installer une applicat...


Développer une application Native, Hybride ou Web ? Quelles 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...


Une agence de communication tout ce qu'il faut savoir

Une agence de communication to...


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


Les avantages du Marketing Social

Personne n'aurait pu s’imaginer il y a quelques années à quel point les médias sociaux gagneraient en popularité. Statista révè...

Les avantages du Marketing Soc...