IV. Depurador avanzado de PHP

IntroducciÃ³n

APD (por sus siglas en inglÃ©s) es el depurador avanzado de PHP. Fue escrito para proporcionar la capacidad de analizar y depurar el cÃ³digo PHP, asÃ como tambiÃ©n proporcionar la capacidad de imprimir una completa descripciÃ³n acerca de errores en las aplicaciones. APD soporta la depuraciÃ³n interactiva, pero por omisiÃ³n escribe informaciÃ³n para localizar archivos. AdemÃ¡s ofrece registros basados en eventos de tal manera que los diversos niveles de informaciÃ³n (incluyendo llamados a funciones, argumentos pasados, intÃ©rvalos de tiempo entre cambios en un documento, etc.) puedan ser activados o desactivados por scripts individuales.

AtenciÃ³n

APD es una extensiÃ³n Zend, modifica la manera interna en la que PHP maneja los llamados a funciones, y en este sentido pudiera o no pudiera ser compatible con otras extensiones Zend (por ejemplo Zend Optimizer).

InstalaciÃ³n

APD se encuentra actualmente disponible como una extensiÃ³n PECL en http://pecl.php.net/package/apd. AsegÃºrese de tener instalada la versiÃ³n CGI de PHP y de que estÃ© disponible en su ruta actual acompaÃ±ado con el script phpize.

Ejecute el siguiente comando para descargar, estructurar e instalar la Ãºltima versiÃ³n estable de APD:
pear install apd

Ã‰sto instala automÃ¡ticamente el mÃ³dulo APD Zend en su directorio de extensiones de PHP. No es obligatorio mantenerlo allÃ; es posible almacenar el mÃ³dulo en cualquier directorio que PHP pueda leer mientras establezca adecuadamente el parÃ¡metro zend_extension.

Los usuarios de Windows pueden descargar la extensiÃ³n dll php_apd.dll desde http://snaps.php.net/win32/PECL_STABLE/.

En su archivo INI, agregue las siguientes lÃneas:

zend_extension = /absolute/path/to/apd.so apd.dumpdir = /absolute/path/to/trace/directory apd.statement_tracing = 0

Dependiendo de su instalaciÃ³n de PHP, la directiva zend_extension puede ser una de las siguientes:

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)

Instalar en Win32

Para instalar APD bajo Windows necesita un entorno de compilaciÃ³n PHP en funcionamiento como se describe en http://php.net -- bÃ¡sicamente, se requiere tener Microsoft Visual C++, win32build.zip, bison/flex, y saber cÃ³mo usarlo. AdemÃ¡s asegÃºrese de que adp.dsp tenga terminaciones de lÃneas en modo DOS; si tiene terminaciones de lÃneas en modo UNIX, Microsoft Visual C++ se quejarÃ¡ al respecto.

ConfiguraciÃ³n en tiempo de ejecuciÃ³n

El comportamiento de estas funciones estÃ¡ afectado por los valores definidos en php.ini.

Tabla 1. Opciones de configuraciÃ³n de APD

Nombre	Valor predeterminado	Cambiable	Registro de cambio
apd.dumpdir	NULL	PHP_INI_ALL
ini.apd.statement-tracing	"0"	PHP_INI_ALL

For further details and definitions of the PHP_INI_* constants, see the ApÃ©ndice G.

A continuaciÃ³n se presenta una corta explicaciÃ³n de las directivas de configuraciÃ³n.

apd.dumpdir string

Establece el directorio en el cual APD escribe la salida del anÃ¡lisis de los archivos. Puede especificar una ruta absoluta o relativa.

Puede especificar un directorio diferente como un argumento a apd_set_pprof_trace().

apd.statement_tracing boolean

Especifica si se hacen o no anÃ¡lisis por lÃnea. ActivÃ¡ndolo (1) impactarÃ¡ en el desempeÃ±o de su aplicaciÃ³n.

Tipos de recursos

Esta extensiÃ³n no tiene ningÃºn tipo de recurso definido.

Constantes predefinidas

Esta extensiÃ³n no tiene ninguna constante definida.

CÃ³mo usar PHP-APD en sus scripts

En la primera lÃnea de su script PHP, ejecute la funciÃ³n apd_set_pprof_trace() para iniciar el anÃ¡lisis:

apd_set_pprof_trace();

Puede insertar la lÃnea en cualquier parte de su script, pero si no inicia el anÃ¡lisis al comienzo de su script descarta el examen de informaciÃ³n que de otra manera pudiera llevarlo a un atascamiento en el desempeÃ±o.
Ahora ejecute su script. La salida serÃ¡ escrita en apd.dumpdir/pprof_pid.ext.
Sugerencia: Si estÃ¡ ejecutando la versiÃ³n CGI de PHP, necesitarÃ¡ agregar la opciÃ³n '-e' para habilitar una ampliaciÃ³n de la informaciÃ³n con la finalidad de que apd funcione apropiadamente. Por ejemplo: php -e -f script.php

Para mostrar la informaciÃ³n analizada con formato, emita el comando pprofp con las opciones de ordenamiento y visualizaciÃ³n de su preferencia. La salida con formato serÃ¡ algo como:
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

La opciÃ³n -R usada en este ejemplo ordena la tabla analizada por la cantidad de tiempo real que el script tardÃ³ ejecutando una funciÃ³n dada. La columna "cumm call" revela cuÃ¡ntas veces fue llamada cada funciÃ³n, y la columna "s/call" revela cuÃ¡ntos segundos fueron necesarios para cada funciÃ³n, en promedio.

Para generar una estructura de llamados a un archivo que pueda importar a la aplicaciÃ³n de anÃ¡lisis KCacheGrind, emita el comando pprof2calltree.

InformaciÃ³n de contacto

Si tiene comentarios, soluciones a fallos, mejoras o quiere ayudar a desarrollar esta bestia, puede enviar un correo a apd@mail.communityconnect.com. Cualquier ayuda es bien recibida.

Tabla de contenidos
apd_callstack -- Devuelve la pila actual de llamados como una matriz
apd_clunk -- Lanza una advertencia y una pila de llamadas
apd_croak -- Lanza un error, una pila de llamadas y detiene la ejecuciÃ³n
apd_dump_function_table -- Imprime la tabla actual de funciones
apd_dump_persistent_resources -- Devuelve todos los recursos persistentes como una matriz
apd_dump_regular_resources -- Devuelve todos los recursos regulares actuales como una matriz
apd_echo -- Imprime hacia el socket de depuraciÃ³n
apd_get_active_symbols -- Obtiene una matriz de los nombres de las variables actuales en el Ã¡mbito local
apd_set_pprof_trace -- Inicia la depuraciÃ³n de la sesiÃ³n
apd_set_session_trace -- Inicia la depuraciÃ³n de la sesiÃ³n
apd_set_session -- Cambia o establece el nivel de depuraciÃ³n actual
apd_set_socket_session_trace -- Inicia la depuraciÃ³n remota de la sesiÃ³n
override_function -- Sobreescribe funciones incorporadas
rename_function -- Renombra nombre_original a nombre_nuevo en el sÃmbolo function_table global

add a note User Contributed Notes
Depurador avanzado de PHP

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.

add a note

MANUAL DE PHP

windsurf mercedes camper

IV. Depurador avanzado de PHP

IntroducciÃ³n

InstalaciÃ³n

Instalar en Win32

ConfiguraciÃ³n en tiempo de ejecuciÃ³n

Tipos de recursos

Constantes predefinidas

CÃ³mo usar PHP-APD en sus scripts

InformaciÃ³n de contacto