Différences entre versions de « Débogage PHP »

De Cliss XXI
Sauter à la navigation Sauter à la recherche
imported>SylvainBeucler
m (intro)
imported>SylvainBeucler
(→‎Xdebug : instructions Xdebug + GEBEN + DBGp)
Ligne 31 : Ligne 31 :
 
* Extension Zend
 
* Extension Zend
  
−
Modifie le gestionnaire d'erreur de PHP pour afficher l'état de la pile d'appels (''stacktrace'').
+
Xdbug peut contacter un client via TCP/IP (debugclient) pour lancer une session de débogage.
  
−
[[Image:Xdebug.png]]
+
Il y a deux protocoles:
 +
* GDB (sans rapporta avec le GNU debugger) est utilisable via un simple netcat (nc -l -p 9000). Le jeu de commande reste relativement simple cependant (bt, run, finish, break {main}, etc.). Pas d'alias ou raccourcis pour les commandes comme dans GDB.
 +
* DBGP utilise un autre jeu de commande plus lourd (run -i IDENTIFIANT à la place de run, breakpoint_set -i IDENTIFIANT {main} à la place de break {main}...), et répond en XML. Il faut donc avoir un IDE qui intègre la communication avec xdebug.
 +
 
 +
Les sessions de débogage dans une appli web peuvent être suivies via un cookie qui indique l'identifiant de session.
 +
 
 +
=== Exemple d'installation ===
 +
 
 +
On utilise Xdebug + GEBEN (mode pour Emacs 22) + DGBp:
 +
 
 +
<pre>
 +
# Xdebug
 +
wget 'http://www.xdebug.org/link.php?url=xdebug203'
 +
tar xzf xdebug-2.0.3.tgz
 +
cd xdebug-2.0.3
 +
phpize
 +
./configure --enable-xdebug
 +
make
 +
sudo make install
 +
 
 +
cd debugclient
 +
./configure && make && make install
 +
 
 +
cat <<EOF > /etc/php5/conf.d/xdebug.ini
 +
zend_extension="/usr/lib/php5/20060613+lfs/xdebug.so"
 +
xdebug.remote_enable = 1
 +
xdebug.remote_host = localhost
 +
xdebug.remote_port = 9000
 +
xdebug.remote_handler = dbgp
 +
EOF
 +
 
 +
# GEBEN
 +
wget http://geben-on-emacs.googlecode.com/files/geben-0.19.tar.gz
 +
tar xzf geben-0.19.tar.gz
 +
cd geben-0.19
 +
make
 +
sudo make install
 +
cat <<EOF >> ~/.emacs
 +
(autoload 'geben "geben" "PHP Debugger on Emacs" t)
 +
EOF
 +
</pre>
 +
 
 +
Pour tester:
 +
* Lancer Emacs
 +
* <code>M-x geben</code> (lance <code>debugclient</code> qui écoute sur le port 9000)
 +
* Visiter http://localhost/~moi/monscript.php?XDEBUG_SESSION_START=1
 +
 
 +
Emacs se positionne sur le fichier et permet d'avancer pas à pas. La touche "v" affiche l'ensemble des variables, globales et locales, sous une forme arborescente.
 +
 
 +
Autres éditeurs libres:
 +
* Eclipse: http://www.eclipse.org/pdt/ and http://www.phpeclipse.net/
 +
* NetBeans: http://php.netbeans.org/
 +
* Protoeditor: http://protoeditor.sourceforge.net/
 +
* VI: http://www.vim.org/scripts/script.php?script_id=1929
  
−
Il y a moyen que PHP/xdebug contacte un client via TCP/IP (debugclient) pour lancer une session de débogage. L'outil est franchement primitif et j'ai du mal à l'utiliser. Apparemment il faut avoir un IDE qui intègre la communication avec xdebug, mais l'outil recommandé est prioriétaire. On est loin de C+GDB.
+
Référence:
 +
* http://www.xdebug.org/docs/remote
 +
* http://code.google.com/p/geben-on-emacs/
  
−
Le protocole dit "GDB" n'est aucunement utilisable avec GDB lui-même, ni avec le mode GUD d'Emacs. En fait on peut intéragir avec ce "protocole" via un simple netcat (nc -l -p 9000), il n'a pas grand chose à voir avec GDB. Le jeu de commande reste relativement simple cependant (bt, run, finish, break {main}, etc.). Pas d'alias ou raccourcis pour les commandes comme dans GDB.
+
== Autres ==
  
−
Le nouveau protocole DBGP utilise un autre jeu de commande plus lourd (run -i IDENTIFIANT à la place de run, breakpoint_set -i IDENTIFIANT {main} à la place de break {main}...), et répond en XML. Bref ce n'est pas utilisable sans IDE.
+
Xdebug peut aussi modifier le gestionnaire d'erreur de PHP pour afficher l'état de la pile d'appels (''stacktrace'').
  
−
Les sessions de débogage dans une appli web peuvent être suivies via un cookie qui indique l'identifiant de session.
+
[[Image:Xdebug.png]]
−
J'ai essayé de lancer un débogage pas à pas, mais l'exécution reprend sans mon accord au bout d'un moment, et la commande "list" ne me dit pas toujours sur quelle ligne je me trouve. Pas moyen non plus d'obtenir le nom du fichier courant, ou alors j'ai mal cherché.
 
  
−
Bref, c'est déjà ça mais peut mieux faire.
+
(note: on peut faire un effet similaire avec du code PHP du style <code>set_error_handler("debug_print_backtrace");</code>)
  
 
== Gubed ==
 
== Gubed ==

Version du 4 décembre 2008 à 18:10

Il existe des outils libres pour tracer les erreurs dans PHP.

Pour l'instant, xdebug est le plus proche du fonctionnel parmi les solutions disponibles.

DBG

Interface de contrôle en ligne de commande, ou avec DDD.

La nouvelle version 3 est proprio et intégrée dans un IDE (pas essayé).

La version 2 est libre mais ne compile pas avec PHP5/Debian, et produit un module cassé avec PHP4/Debian (PHP Warning: Unknown(): Unable to load dynamic library '/usr/lib/php4/20050606+lfs/dbg.so' - /usr/lib/php4/20050606+lfs/dbg.so: undefined symbol: OnUpdateLong in Unknown on line 0).

Bref il n'y a plus de version libre maintenue.

APD

Non-intéractif, plutôt un profiler

Xdebug

Xdbug peut contacter un client via TCP/IP (debugclient) pour lancer une session de débogage.

Il y a deux protocoles:

  • GDB (sans rapporta avec le GNU debugger) est utilisable via un simple netcat (nc -l -p 9000). Le jeu de commande reste relativement simple cependant (bt, run, finish, break {main}, etc.). Pas d'alias ou raccourcis pour les commandes comme dans GDB.
  • DBGP utilise un autre jeu de commande plus lourd (run -i IDENTIFIANT à la place de run, breakpoint_set -i IDENTIFIANT {main} à la place de break {main}...), et répond en XML. Il faut donc avoir un IDE qui intègre la communication avec xdebug.

Les sessions de débogage dans une appli web peuvent être suivies via un cookie qui indique l'identifiant de session.

Exemple d'installation

On utilise Xdebug + GEBEN (mode pour Emacs 22) + DGBp: 

# Xdebug
wget 'http://www.xdebug.org/link.php?url=xdebug203'
tar xzf xdebug-2.0.3.tgz
cd xdebug-2.0.3
phpize
./configure --enable-xdebug
make
sudo make install

cd debugclient
./configure && make && make install

cat <<EOF > /etc/php5/conf.d/xdebug.ini
zend_extension="/usr/lib/php5/20060613+lfs/xdebug.so"
xdebug.remote_enable = 1
xdebug.remote_host = localhost
xdebug.remote_port = 9000
xdebug.remote_handler = dbgp
EOF

# GEBEN
wget http://geben-on-emacs.googlecode.com/files/geben-0.19.tar.gz
tar xzf geben-0.19.tar.gz
cd geben-0.19
make
sudo make install
cat <<EOF >> ~/.emacs
(autoload 'geben "geben" "PHP Debugger on Emacs" t)
EOF

Pour tester:

Emacs se positionne sur le fichier et permet d'avancer pas à pas. La touche "v" affiche l'ensemble des variables, globales et locales, sous une forme arborescente.

Autres éditeurs libres:

Référence:

Autres

Xdebug peut aussi modifier le gestionnaire d'erreur de PHP pour afficher l'état de la pile d'appels (stacktrace).

Xdebug.png

(note: on peut faire un effet similaire avec du code PHP du style set_error_handler("debug_print_backtrace");)

Gubed

Modifie les scripts PHP à la volée pour appeler le debugger. Ce modèle est simple, mais ne pose-t-il pas des limitations (comment remonter d'une ligne ou gérer la pile des appels, par exemple?)

Quanta Plus propose un environnement intégré de programmation et s'intègre avec Gubed. Voici une documentation qui explique comment configurer le tout. Je n'ai pas réussi à la faire fonctionner...

Il y a également une interface graphique spécifique à Gubed.

BODY

C'est vieux, écrit en PHP, et à base d'interface web. Je le sens pas.

Autres outils

Apparemment il y a un ou deux produits propriétaires intégrés dans des IDE elles-aussi proprio. Pensez à vérifier la licence d'un produit qu'on vous recommande.

Liens

Récupérée de « https://doc.cliss21.com/index.php?title=Débogage_PHP&oldid=1418 »