apc_store
There seem to be a mistake with the name of the apd_set_socket_session_trace function. In the latest build (version 1.0.1) of apd for PHP, the function is called apd_set_session_trace_socket.
The APD pecl page also have some problems. Some of the links direct you to some adt pages.
IV. Débogueur avancé pour PHP
Introduction
APD est un débogueur avancé pour PHP (Advanced PHP Debugger). Il a été écrit pour fournir des capacités de profilage et de déboguage du code PHP tout comme la possibilité d'afficher un retour de trace de la pile. APD supporte le débogage interactif, mais, par défaut, il écrit les données dans des fichiers de trace. APD fournit également la notation basée par événement, de sorte que les niveaux d'information (incluant les appels de fonctions, le passage d'arguments, le délai d'exécution, etc.) peuvent être activer ou non pour chaque script.
| Attention |
APD est une extension Zend, qui modifie la façon interne de gestion des appels de fonctions PHP et peut ou ne pas être compatible avec d'autres extensions Zend (par exemple avec le Zend Optimizer). |
Installation
APD est actuellement disponible en tant qu'extension PECL depuis http://pecl.php.net/package/apd. Assurez-vous d'avoir installé la version CGI de PHP et qu'elle soit disponible dans votre PATH courant tout au long de votre script PHP.
Exécutez la commande suivante pour télécharger, construire et installer la dernière version stable d'APD :
pear install apd |
Ceci installera automatiquement le module APD Zend dans votre dossier d'extensions de PHP. Il n'est pas obligatoire de le conserver à cet endroit ; vous pouvez stocker le module dans n'importe quel dossier que PHP peut lire, à partir du moment où vous paramétrez correctement le paramètre zend_extension.
Les utilisateurs de Windows peuvent télécharger la bibliothèque dll php_apd.dll depuis http://snaps.php.net/win32/PECL_STABLE/.
Dans votre fichier INI, ajoutez les lignes suivantes :
zend_extension = /chemin/absolu/vers/apd.so apd.dumpdir = /chemin/absolu/vers/dossier/trace apd.statement_tracing = 0 |
En fonction de votre installation de PHP, le dossier zend_extension peut être l'un de la liste suivante :
zend_extension (non ZTS, non debug build) zend_extension_ts ( ZTS, non debug build) zend_extension_debug (non ZTS, debug build) zend_extension_debug_ts ( ZTS, debug build) |
Compilation sous un environnement Win32
Pour compiler APD sous Windows, vous avez besoin d'un environnement de compilation PHP comme décrit sur http://php.net/ -- simplement, cela nécessite que vous possédiez Microsoft Visual C++, win32build.zip, bison/flex certains savent comment les récupérer et les faire fonctionner. Assurez-vous également que adp.dsp a bien des fins de lignes façon DOS ; si les fins de lignes sont du style Unix, Microsoft Visual C++ vous le fera remarquer.
Configuration à l'exécution
Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini.
Tableau 1. APD Configuration Options
| Nom | Par défaut | Modifiable | Historique |
|---|---|---|---|
| apd.dumpdir | NULL | PHP_INI_ALL | |
| apd.statement-tracing | "0" | PHP_INI_ALL |
Voici un éclaircissement sur l'utilisation des directives de configuration.
- apd.dumpdir chaîne de caractères
Spécifie le dossier dans lequel APD écrit les fichiers de profilage. Vous pouvez spécifier un chemin absolu ou relatif.
Vous pouvez spécifier un dossier différent comme argument de apd_set_pprof_trace().
- apd.statement_tracing boolean
Active ou désactive les traces à la ligne. En activant cette option (valeur de 1), l'application sera considérablement ralentie.
Types de ressources
Cette extension ne définit aucune ressource.
Constantes pré-définies
Cette extension ne définit aucune constante.
Comment utiliser APD dans vos scripts ?
À la première ligne de vos scripts PHP, appelez la fonction apd_pprof_trace() pour commencer la trace :
apd_set_pprof_trace();Vous pouvez ajouter cette ligne n'importe où dans votre script, mais si vous ne commencez pas à tracer au début de votre script, vous désactivez les données de profil qui pourraient autrement vous mener à un goulot d'étranglement d'exécution.
Maintenant, exécutez votre script. Le contenu de la sortie devrait être écrit dans le fichier apd.dumpdir/pprof_pid.ext.
Astuce : Si vous utilisez la version CGI de PHP, vous devez ajouter le flag '-e' pour activer les informations étendues pour que apd fonctionne correctement. Par exemple : php -e -f script.php
Pour afficher les données de profile formattées, exécutez la commande pprofp avec les options de trie et d'affichage de votre choix. L'affichage formattée pourra ressembler à cela :
bash-2.05b$ pprofp -R /tmp/pprof.22141.0 Trace for /home/dan/testapd.php Total Elapsed Time = 0.00 Total System Time = 0.00 Total User Time = 0.00 Real User System secs/ cumm %Time (excl/cumm) (excl/cumm) (excl/cumm) Calls call s/call Memory Usage Name -------------------------------------------------------------------------------------- 100.0 0.00 0.00 0.00 0.00 0.00 0.00 1 0.0000 0.0009 0 main 56.9 0.00 0.00 0.00 0.00 0.00 0.00 1 0.0005 0.0005 0 apd_set_pprof_trace 28.0 0.00 0.00 0.00 0.00 0.00 0.00 10 0.0000 0.0000 0 preg_replace 14.3 0.00 0.00 0.00 0.00 0.00 0.00 10 0.0000 0.0000 0 str_replace
L'option -R utilisée dans cet exemple trie la table de profil par la durée réelle qu'une fonction donnée coûte au script. La colonne "cumm call" révèle le nombre d'appel de chaque fonction et la colonne "s/call", le nombre de secondes chaque appel à la fonction nécessite, en moyenne.
Pour générer un fichier d'appel sous forme d'arbre que vous pourrez importer dans l'application KCacheGrind (application d'analyse de profile), exécutez la commande pprof2calltree.
Informations de contact
Si vous avez des commentaires, des corrections de bogues ou si vous voulez développer des améliorations pour cette extension, vous pouvez envoyer un email à apd@mail.communityconnect.com. Toute aide est vraiment la bienvenue.
- Table des matières
- apd_breakpoint -- Stoppe l'interpréteur et attend un CR depuis le socket
- apd_callstack -- Retourne la pile d'appel courante dans un tableau
- apd_clunk -- Lance une alerte et un callstack
- apd_continue -- Redémarre l'interpréteur
- apd_croak -- Lance une erreur, un callstack et sort
- apd_dump_function_table -- Affiche la table courant de fonction
- apd_dump_persistent_resources -- Retourne toutes les ressources persistantes dans un tableau
- apd_dump_regular_resources -- Retourne toutes les ressources régulières courantes dans un tableau
- apd_echo -- Ecrit dans le socket de débogage
- apd_get_active_symbols -- Récupère un tableau contenant les noms de variables courantes de portées locales
- apd_set_pprof_trace -- Démarre la session de déboguage APD
- apd_set_session_trace -- Démarre la session de débogage
- apd_set_session -- Modifie ou définit le degré de débogage courant
- apd_set_socket_session_trace -- Démarre la session de débogage à distance
- override_function -- Dépasse les fonctions intégrées
- rename_function -- Renomme une fonction intégrée dans la table des fonctions globales
add a note
User Contributed Notes
Débogueur avancé pour PHP
northon_patrick3 at yahoo dot ca
26-Jun-2008 08:36
judas dot iscariote at gmail dot com
07-May-2006 10:52
if you are looking for better/different alternatives to APD, check the xdebug website http://www.xdebug.org or download it from PECL http://pecl.php.net/xdebug
bugbuster at darrencampbell dot com dot au
22-May-2005 01:53
Locate the root-cause of defects, fast.
If you need to locate the source of a defect in complicated web-based PHP applications with lots of conditional includes (osCommerce and Zen-Cart are reasonably complex), use APD to create a profile dump.
Then filter the dump for lines containing "!" to produce a list of included (required) files in the order they were included.
On my Win98 dev box I use: find "!" dumpfile > trace_program.txt
I use the trace_program.txt to backtrack to the root-cause of defects appearing in the browser. Great for maintaining systems you did not build yourself.
ng4rrjanbiah at rediffmail dot com
05-Apr-2005 10:52
Some useful links on APD:
1. Profiling PHP Applications ( http://www.schlossnagle.org/~george/talks/Profiling-phpworks-2004.pdf ), [1.40 MB], George Schlossnagle, 2004-09-23
2. PHP Performance Profiling ( http://www.linuxjournal.com/article/7213 ), [13.16 KB], Jonathan Oxer, 2003-10-21
3. APD Wiki ( http://www.wiki.cc/php/Apd )
HTH,
R. Rajesh Jeba Anbiah
yoghurtmetperzik at gmail dot com
25-Jan-2005 07:15
If pprofp reports 'No such file or directory', it's probably because it contains an incorrect path to your php client. Open pprofp in your fav editor, edit the first line, and try again.