====== Créer un nouveau projet Symfony ======
Comment créer un nouveau projet Symfony et paramétrer l'environnement du projet.
===== Résumé =====
  - ''symfony new %NomDuProjet% --webapp'' = Créé un répertoire et y télécharge les fichiers symfony.
  - ''cd %NomDuProjet%'' = Pour entrer dans le répertoire du projet.
  - ''symfony server:start -d'' = démarrage du serveur de test en arrière plan (''-d'') 
  - ''symfony open:local'' = pour lancer le navigateur web pour vérifier que tout est bien installé.
  - ''git status'' = pour vérifier si GIT fonctionne bien
  - ''symfony composer req logger'' pour les logs
  - ''symfony composer req debug --dev'' pour activer la barre de débogage en bas de la page
<note important>Apparement   ''symfony composer req debug --dev'' serait déprécié dans les nouvelles versions de Symfony

Voir [[https://symfony.com/components/Debug]]</note>


===== Installer l'environnement Symfony dans le répértoire du projet =====


<note important>Il faut que [[prog:git:installation|GIT soit configuré]]</note>
Se rendre dans le dossier racine qui contiendra le dossier de votre projet et taper : ''symfony new  test-api-project''

Pour un projet simple, comme une API utilser juste ''symfony new test-api-project''
<code php>
D:\webprojects>symfony new test-api-project --webapp
* Creating a new Symfony project with Composer
  (running C:\ProgramData\ComposerSetup\bin\composer.bat create-project symfony/website-skeleton test-api-project)

* Setting up the project under Git version control
  (running git init test-api-project)

 [OK] Your project is now ready in D:\webprojects\test-api-project
</code>
===== Tester =====
==== Lancer le serveur ====
On se rends dans le dossier de l'appli : ''cd test-api-project''

Et on lance le serveur avec : ''symfony server:start -d'' (-d = en arrière plan)\\ 
ou  ''symfony server:start'' dans ce cas on voit les logs en temps réel dans la console.

<code powershell>
D:\webprojects>cd test-api-project

D:\webprojects\test-api-project>symfony server:start
 
 [WARNING] run "symfony.exe server:ca:install" first if you want to run the web server with TLS support, or use
 "--no-tls" to avoid this warning


Sep 30 20:08:02 |DEBUG| PHP    Using PHP version 7.3.6 (from default version in $PATH) 
Sep 30 20:08:02 |INFO | PHP    listening path="C:\\Program Files\\php-7.3.6\\php-cgi.exe" php="7.3.6" port=58722
Sep 30 20:08:02 |DEBUG| PHP    started 
 
 [OK] Web server listening on http://127.0.0.1:8000 (PHP CGI 7.3.6)


WARNING unable to find the application log
Sep 30 20:08:49 |WARN | SERVER GET  (404) / ip="127.0.0.1"
Sep 30 20:08:50 |INFO | SERVER GET  (200) /_wdt/e71290 
Sep 30 20:08:51 |WARN | SERVER GET  (404) /robots.txt 
Sep 30 20:08:51 |WARN | SERVER GET  (404) /favicon.ico 
Sep 30 20:08:52 |WARN | SERVER GET  (404) /robots.txt 
Sep 30 20:10:27 |WARN | SERVER GET  (404) / 
Sep 30 20:10:28 |INFO | SERVER GET  (200) /_wdt/07ed06 
</code>
=== Les logs du serveur ===
Si on démarre le serveur avec la commande  ''symfony server:start'',  les logs sont affiché en temps réel dans la console.

Si on démarre le serveur avec la commande ''symfony server:start -d'', le serveur démarre et nous redonne la main sur la console, on ne voit pas les logs.\\
Dans ce cas on peut taper la commande ''symfony server:log'' pour afficher les logs du serveur http de symfony dans la console.

==== Test avec le navigateur ====
Comme indiqué ci-dessus on ouvre la page dans un navigateur: ''http://127.0.0.1:8000''\\
ou on tape directement la commande ''symfony open:local'' pour ouvrir le navigateur.

{{:prog:symfony:sym1.png|}}

Pour info a ce niveau là le répertoire de l'application pèse 51Mo avec l'option ''--full'' ou 9.49Mo sans l'option ''--full''

==== Tester GIT ====
On vérifie que GIT fonctionne bien !
<code bash>
>git status
On branch main
nothing to commit, working tree clean
</code>
un répertoire ''.git'' a été créé dans le répertoire du projet.

==== En plus... ====
  * ''symfony composer req logger'' pour les logs
  * ''symfony composer req debug --dev'' pour activer la barre de débogage en bas de la page
<note important>Apparement   ''symfony composer req debug --dev'' serait déprécié dans les nouvelles versions de Symfony

Voir [[https://symfony.com/components/Debug]]</note>