Foros del Web » Programando para Internet » PHP »

phpDocumentor: documentar los errores

Estas en el tema de phpDocumentor: documentar los errores en el foro de PHP en Foros del Web. Holas!! Mi pregunta es simple: estoy tratando de escribir mis páginas PHP siguiendo la norma que requiere phpDocumentor para poder generar los manuales a partir ...
  #1 (permalink)  
Antiguo 08/10/2007, 15:08
Avatar de quinqui  
Fecha de Ingreso: agosto-2004
Ubicación: Chile!
Mensajes: 776
Antigüedad: 19 años, 7 meses
Puntos: 56
Pregunta phpDocumentor: documentar los errores

Holas!!
Mi pregunta es simple: estoy tratando de escribir mis páginas PHP siguiendo la norma que requiere phpDocumentor para poder generar los manuales a partir del código.
Pues bien, he buscado y rebuscado en el sitio web de phpDocumentor, así como en su foro y manuales, pero no encuentro ninguna parte donde diga cómo se pueden documentar los errores de nuestro programa. O sea, si tenemos esto:
Código PHP:
/**
* Descripcion de mi funcion
*
* @param integer $numero : Este es un parametro de ejemplo de esta funcion
* @return boolean
*/
function MiFunction($numero)
{
 ...

...quiero saber si haciendo algo como esto (que no se puede, claro, por eso lo pregunto) podría documentar mis errores personalizados:
Código PHP:
/**
* Descripcion de mi funcion
*
* @param integer $numero : Este es un parametro de ejemplo de esta funcion
* @error ABC01 : Mensaje Ejemplo de Error
* @return boolean
*/
function MiFunction($numero)
{
 ...

O sea, si hay una tag que phpDocumentor reconozca como código de Error de nuestras funciones y clases, de modo que al generar el manual, no sólo aparezcan las variables, funciones y clases, sino también los código de errores que nosotros retornamos si se produce algun fallo al usar la funcion X, etc...

Uhm... Ahora que lo pienso... tal vez no se hayan preocupado de documentar los errores porque la mayoría usa el die para demostrar que hay un fallo ¬¬....

Mm, pero como sea, igual lo pregunto por si las moscas.
Muchas gracias de antemano
__________________
pipus.... vieeeeeji plomius!!!
*quinqui site*
  #2 (permalink)  
Antiguo 27/12/2007, 22:07
 
Fecha de Ingreso: abril-2004
Mensajes: 154
Antigüedad: 19 años, 11 meses
Puntos: 0
Re: phpDocumentor: documentar los errores

Cita:
Iniciado por quinqui Ver Mensaje
Holas!!
Mi pregunta es simple: estoy tratando de escribir mis páginas PHP siguiendo la norma que requiere phpDocumentor para poder generar los manuales a partir del código.
Pues bien, he buscado y rebuscado en el sitio web de phpDocumentor, así como en su foro y manuales, pero no encuentro ninguna parte donde diga cómo se pueden documentar los errores de nuestro programa. O sea, si tenemos esto:
Código PHP:
/**
* Descripcion de mi funcion
*
* @param integer $numero : Este es un parametro de ejemplo de esta funcion
* @return boolean
*/
function MiFunction($numero)
{
 ...

...quiero saber si haciendo algo como esto (que no se puede, claro, por eso lo pregunto) podría documentar mis errores personalizados:
Código PHP:
/**
* Descripcion de mi funcion
*
* @param integer $numero : Este es un parametro de ejemplo de esta funcion
* @error ABC01 : Mensaje Ejemplo de Error
* @return boolean
*/
function MiFunction($numero)
{
 ...

O sea, si hay una tag que phpDocumentor reconozca como código de Error de nuestras funciones y clases, de modo que al generar el manual, no sólo aparezcan las variables, funciones y clases, sino también los código de errores que nosotros retornamos si se produce algun fallo al usar la funcion X, etc...

Uhm... Ahora que lo pienso... tal vez no se hayan preocupado de documentar los errores porque la mayoría usa el die para demostrar que hay un fallo ¬¬....

Mm, pero como sea, igual lo pregunto por si las moscas.
Muchas gracias de antemano
Quinqui, depronto no parece lo mas adecuado que cada función se asocie a un código de error. En este caso te recomeindo la utilización de un error_handler que se encargue de capturar las excepciones y las gestione de la manera que mas gustes, ya sea escribiendo los errores en un archivo de log o enviando a tu correo y que a la vez se encargue de que el usuario no reciba la descripción del error. De todas maneras sería interesante conocer si PHPDocumentor tiene algo al respecto para este tipo de documentación. Finalmente, todo comentario será de utilidad en algun momento.

Saludos
__________________
Desdichado quien duerme en la mañana
Atención: Estás leyendo un tema que no tiene actividad desde hace más de 6 MESES, te recomendamos abrir un Nuevo tema en lugar de responder al actual.
Respuesta




La zona horaria es GMT -6. Ahora son las 06:58.