Si la depuración es el proceso de eliminar errores, entonces la programación debe ser el proceso de introducirlos.

~ Edsger Dijkstra

Supongamos que tuvieramos el siguiente código, por ejemplo:

<?php
  function a($cadena, $repeticiones, $eliminar) {
    return b(str_repeat($cadena . ' ', $repeticiones), $eliminar);
  }

  function b($cadena, $eliminar) {
    return c(str_replace($eliminar, '', $cadena));
  }

  function c($cadena) {
    echo '<pre>';
    debug_print_backtrace();
    echo '</pre>';

    return ucwords($cadena);
  }

  $cadena = a('Hola', 3, 'H');

La llamada a debug_print_backtrace en la función c imprimiría algo parecido a lo siguiente:

#0 c(ola ola ola ) called at [ejemplo.php:7]
#1 b(Hola Hola Hola , H) called at [ejemplo.php:3]
#2 a(Hola, 3, H) called at [ejemplo.php:19]

Para poder utilizar FirePHP tendremos que instalar primero, como es lógico, tanto Firebug como el propio FirePHP. A continuación activaremos la pestaña de Consola y Red en Firebug.

Antes de poder llamar a las funciones de FirePHP en nuestro script tendremos que importar su código fuente, evidentemente. Si tenemos suerte es posible que si usas un framework o un CMS este ya incluya algún plugin para importarlo fácilmente, como es el caso de Joomla!, por ejemplo. En caso contrario bastará con descargar la librería desde su sitio web, subir los archivos FirePHP.class.php y fb.php a tu servidor, y añadir una llamada a la función require_once en nuestro código.

Si queremos usar una API orientada a objetos importaremos FirePHP.class.php

require_once('FirePHP.class.php');

Si queremos usar una API imperativa o una orientada a objetos con métodos estáticos importaremos fb.php

require_once('fb.php');

Lo más rápido es utilizar la API imperativa, en cuyo caso basta con llamar a las función fb directamente. Esta función toma como argumentos el objeto a imprimir, y, opcionalmente el tipo de mensaje (FirePHP::INFO, FirePHP::WARN, FirePHP::ERROR, …)

fb("Hola mundo");
fb($_SERVER, FirePHP::INFO);

Si usamos la API orientada a objetos también contaremos con otros métodos que no hacen más que llamar al método fb, tienen nombres que proceden del tipo de mensaje, y con los que no tenemos que especificar el tipo del mensaje como segundo parámetro:

$fp = FirePHP::getInstance(true);
$fp->fb("Hola mundo");
$fp->fb($_SERVER, FirePHP::INFO);
$fp->error("Mensaje de error");