Démarrer son projet Symfony 5 en local

Vous venez de créer votre projet Symfony 5 et vous voulez à présent le démarrer en local, cet article est fait pour vous 🙂 On va voir toutes les solutions qui s’offrent à vous ( et il y en a beaucoup ! ) pour démarrer votre projet.

Qu’est ce qu’il vous faut pour démarrer un projet ?

Le minimum nécessaire est d’avoir PHP et un serveur web local. Il y a plusieurs façon d’en générer un, on peut:

– lancer celui généré par le bin Symfony

– utiliser le serveur web inclut directement dans PHP

– se servir du serveur fourni par le bundle symfony/web-server-bundle ( le fameux php bin/console server:run qui était la norme avant)

– héberger en local directement un serveur apache ou nginx

Comme vous le voyez, il y a beaucoup de façons de faire et on va les détailler une par une.

I. La nouvelle norme: le binaire Symfony

Si vous avez déjà le binaire Symfony installé globalement sur votre machine, il suffit de taper la commande suivante à la racine de votre projet:

symfony server:start

Pour installer le bin, c’est ici.

Le serveur Symfony est la nouvelle norme pour le développement local. Il inclut de nombreuses fonctionnalités qui doivent faciliter le développement: on peut par exemple facilement changer la version de PHP du serveur, créer un proxy ou générer un certificat sécurisé local.

Plus d’informations ici.

II. Le serveur interne PHP

PHP propose un serveur interne simplifié, ça fait très bien l’affaire si votre but est juste de jouer avec Symfony sur votre machine. En revanche, il n’a pas pour but d’être un serveur local complet donc il est très limité (c’est d’ailleurs un « warning » présent tout en haut de la page de documentation).

Pour lancer votre projet, lancez la commande suivante à la racine de votre projet :

php -S localhost:8000

Plus d’informations ici.

III. En utilisant le « web server bundle »

Vous aviez vos projets avec des versions antérieures de Symfony et vous ne voulez pas passer par le binaire Symfony ou alors vous aviez déjà configuré votre IDE pour lancer le projet avec le fameux « php bin/console server:run » et vous avez la flemme de la changer ?

Ce serveur est encore utilisable mais est déprécié à la faveur du binaire Symfony (voir I).

Encore une fois, si vous voulez simplement tester Symfony 5 en local sans avoir à modifier votre installation, il n’y a aucun problème à l’utiliser 😉

Pour l’installer, tapez la commande suivante :

composer require symfony/web-server-bundle 4.4

Note: il faut bien préciser la versions « 4.4 » sinon la commande va échouer comme la version 5 n’existe pas.

Une fois fait, tapez la commande suivante à la racine de votre projet :

php bin/console server:run

IV. En utilisant un serveur Apache ou NGINX

Avec cette solution, vous n’aurez plus besoin d’exécuter de commandes pour lancer votre serveur et vous pourrez vous rapprocher de la configuration du serveur de production mais c’est généralement plus compliqué à configurer !

De futurs articles détailleront la marche à suivre pour cette approche.

Plus d’informations ici.

Conclusion

J’espère que cet article vous aura permis de lancer votre projet Symfony 5 en local et que vous y voyez un peu plus clair sur les différentes façons de lancer votre projet en local 🙂