Différences

Ci-dessous, les différences entre deux révisions de la page.

--- bloc2:prog:gen:netbeans-config [2023/06/22 16:59] – [Activation et paramétrage] admin
+++ bloc2:prog:gen:netbeans-config [2025/03/12 14:03] (Version actuelle) – [PHP Doc] admin
@@ Ligne 5: / Ligne 5: @@
 Tout d'abord, il faut disposer de la librairie XDebug dans le sous-dossier **ext** de PHP. Le fichier se nomme **php_xdebug.dll** et il est à choisir selon la version de PHP. Voir vos ressources sur le Bureau Windows. \\ \\
 Ensuite, il faut ajouter les lignes suivantes à la fin du fichier **.\xampp\php\php.ini** que l'on peut atteindre via le **Control Panel** de Xampp (bouton Config d'Apache) :
-  [XDebug]
+<code ini>
-  zend_extension=xdebug
+[XDebug]
-  xdebug.start_with_request=trigger
+zend_extension=xdebug
-  xdebug.mode=debug
+xdebug.start_with_request=trigger
-  xdebug.client_host=localhost
+xdebug.mode=debug
-  xdebug.client_port=9003
+xdebug.client_host=localhost
-  xdebug.idekey="netbeans-xdebug"
+xdebug.client_port=9003
+xdebug.idekey="netbeans-xdebug"
+</code>
 Il est nécessaire de redémarrer Apache pour prendre en compte la nouvelle configuration.
@@ Ligne 65: / Ligne 66: @@
 |\\ \\ \\ \\ Dans le menu **Tools / Options / PHP / Frameworks & Tools / phpDocumentor**|{{:bloc2:prog:gen:netbeans-config-phpdoc.png?400|phpDocumentor}}|
-A partir de là, le menu contextuel "**Générer la documentation**" sera pleinement opérant et la documentation sera produite dans un dossier qu'il reste à indiquer à la demande.
+A partir de là, le menu contextuel du projet "**Générer la documentation**" sera pleinement opérant et la documentation sera produite dans un dossier qu'il reste à indiquer à la demande.
 Pourtant, en l'état, sur un projet CodeIgniter (ou tout autre framework), l'auto-documentation s'opérera sur l'ensemble du projet. Y compris les sources du framework. Pour limiter au strict nécessaire, on pourra s'appuyer sur un fichier de configuration à nommer **phpdoc.dist.xml** et à placer **à la racine du projet** sur la base de l'exemple suivant :
@@ Ligne 94: / Ligne 95: @@
 </code>
 Dans ce fichier de configuration, éventuellement à adapter, le dossier de stockage de la documentation est placé à la **racine du projet** et il est nommé **.phpdoc**. Le nom du dossier commençant par un point, il sera ignoré par le versioning. Ce qui est une bonne idée.
+Enfin, pour que le fichier XML soit pris en compte, il faut indiquer sa présence dans les propriétés du projet dans l'onglet **Documentation**.