laravel
Créé le novembre 8, 2022
8 min read

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

Laravel est un puissant framework php et, comme le dit son slogan, il s’agit du “Framework PHP pour les artisans du web”.

Dans notre agence web, nous recevons souvent des questions sur le développement web Laravel, mais nous adorons aussi Laravel.

Si vous avez oublié les étapes ou les commandes Laravel lors de l’installation de vos projets, ce tutoriel est fait pour vous.

Voici notre tutoriel Laravel pour installer des projets sur un serveur Linux ou Windows à partir de Git et d’autres dépôts Git.

Qu’est-ce que Laravel ?

Laravel est un framework pour application web PHP populaire et puissant qui permet aux développeurs de créer facilement des applications web modernes, évolutives et sécurisées.

L’un des principaux avantages de Laravel est qu’il simplifie de nombreuses tâches courantes de développement web, telles que le routage, l’authentification, la gestion des bases de données, etc.

Il comprend également de nombreux composants et packages prédéfinis qui peuvent aisément être intégrés dans votre application, tels que la mise en cache, la gestion des sessions et l’envoi d’e-mails.

Se connecter avec les bonnes autorisations (facultatif)

Si vous êtes connecté comme root ou super administrateur sur votre serveur, assurez-vous de changer votre utilisateur pour l’utilisateur web par défaut pour le projet Laravel.

Faites simplement ceci :

su votrenomusager

Clonez votre Repo (répertoire) Git

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

git clone linktoyourpo.com/projectname

Notez que vous pouvez cloner les projets de deux manières, l’une en mode HTTPS et l’autre en mode SSH.

ASTUCE : Vous pouvez cloner votre projet à partir d’une branche spécifique en faisant git clone :

-b nameofthebranch linktoyourepo.com/projectname

Accédez au répertoire de votre projet web

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

Vous devez simplement y accéder en faisant:

cd nomduprojet

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.

Ainsi pour installer tout le code source nécessaire, nous installons l’application web grâce à composer avec la commande suivante.

composer install

Installer les dépendances NPM (optionnel)

Ceci ressemble à étape 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 à 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ées dans le fichier ‘packages.json’.

Si votre application web n’utilise donc pas Vue.js, Node ou autre, vous pouvez sauter cette étape sinon vous devez faire : 

npm install

D’autres préfère Yarn , si c’est votre cas faite simplement

Créez une copie de votre fichier .env

Les fichiers .env ne sont habituellement pas soumis à 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

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 hachage 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 rouvrez votre fichier .env, vous devriez remarquer que votre clé s’est générée dans la variable : APP_KEY

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 

If your Laravel Project doesn't Contain a Database it Should Work Already

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

Nettoyez 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, vous devez ajouter à votre URL /public/ ou /index.php/

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

Bien, on continue 

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

Configurez votre fichier .env pour permettre une connexion à la base de données.

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. 

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 toute 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ées, mais ne remplis aucune table.

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

php artisan db:seed

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

php artisan migrate:fresh --seed

Les migrations sont super pratiques, 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 originel de données préférées. Ceci créera toutes vos tables avec vos contenus.

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 sûr, Laravel vous permet aussi bien de créer des applications web sur mesure complexe, toutefois également d’être bien référencé sur le web. 

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

Git Bash Menu

L’installation de Laravel n’était donc pas si difficile, n’est-ce pas ?

J’espère que cela vous a aidé à commencer votre prochain projet Laravel.

Pensez à vous inscrire à notre newsletter et de nous suivre sur les réseaux sociaux pour d’autres tutoriels sur les technologies web populaires et les techniques de marketing.

Si vous rencontrez des difficultés avec Laravel, n’hésitez pas à me contacter ou à contacter notre équipe chez Oshara. Nous sommes une des meilleure agence de développement web Laravel à Montréal.

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

Questions fréquemment posées