Discussion :

[siro75]

Bonjour,

Gros gros débutant en PHP, et donc forcément aussi en Symfony, je désirerais savoir s'il existe une documentation officielle pour les objets utilisés via Symfony.

Par exemple, ces pages

https://symfony.com/doc/current/controller.html

https://github.com/symfony/symfony/b...Controller.php

sont intéressantes mais elles ne correspondent pas du tout à mon attente.

En effet, étant développeur Java à la base, j'ai l'habitude d'aller très régulièrement voir les documentations officielles Java pour les objets utilisés.

Par exemple :

https://docs.spring.io/spring-framew...ontroller.html

Cette page permet d'avoir un aperçu global, en premier, puis détaillé, ensuite, sur tout le contenu (les constructeurs, les attributs, les méthodes) d'un objet Java.

Mais, elle permet aussi très rapidement d'aller trouver une page similaire pour tous les autres objets du framework Java.

Ma question est la suivante :

Existe-t-il donc de telles documentations pour Symfony ?

Par exemple, j'aimerais découvrir l'objet AbstractController.php cité plus haut, soit plus précisément Symfony\Bundle\FrameworkBundle\Controller\AbstractController, c'est-à-dire que j'aimeras avoir un aperçu global et détaillé, mais je ne sais où aller sur la toile pour cela.

Un grand merci d'avance.

[grunk]

A ma connaissance Symfony ne publie pas leur documentation de référence. Tu dois par contre pouvoir la générer avec phpdoc sur les sources de symfony.

[siro75]

Merci à toi pour cet outil.

Je viens d'installer Visual Studio Code (que je découvre) et j'ai installé une extension phpDoc.
Je vois bien que l'auto-complétion se réalise (c'est déjà ça d'acquis) mais je n'arrive pas à voir les méthodes d'objets importés et utilisés dans une classe.
Normalement, à ce que j'ai compris de phpDoc, cela sert à ça.

[grunk]

Non phpdoc c'est l'équivalent de doxygen pour php. En gros ca te permet de générer des documentation basées sur des bloc de commentaire. Exacactement comme est faite la javadoc par exemple.
Le fait que tu es de l'autocomplétion dans VSCode n'a pas de lien.

Tu peux évidemment l'utiliser pour ton propre code , mais comme tu souhaitais avoir la doc des "api" de Symfony c'est la solution pour la créer toi même.

[siro75]

OK, merci encore pour tes explications et le temps que tu m'as consacré.

Finalement, je crois que je vais utiliser les deux sites web mis en avant dans mon premier message afin de savoir ce que propose les classes que je vais rencontrer lors de mon développement d'applications web.
Il va falloir que j'explore tout ça.

[siro75]

Finalement, j'ai trouvé ça

https://doc.hotexamples.com/class/sy...ler/Controller

Ça ressemble à ce que je désirerais mais la dernière version de Symfony n'y est pas.