Usando PHP desde la línea de comando

Desde la versión 4.3.0, PHP soporta un nuevo tipo de SAPI (Interfaz De Programación De Uso Del Servidor) llamada CLI que significa literalmente interfaz de línea de comando (Command Line Interface). Como el nombre implica, este tipo de SAPI se foca en la creación de aplicaciones que pueden correr desde la línea de comando (o desde el desktop también) con PHP. Hay algunas diferencias dentro del CLI SAPI y otros SAPI que son explicadas en este capítulo. Es importante mencionar que CLI y CGI son diferentes clases de SAPI y comparten algunas características.

La interfaz llamada CLI SAPI fue introducida con PHP 4.2.0, pero es todavía en estado experimental y tiene que ser activada explícitamente con --enable-cli cuando usando ./configure. Desde PHP 4.3.0 la interfaz CLI SAPI es activada automáticamente. Tu puedes usar --disable-cli para de-activarla.

Desde PHP 4.3.0, el nombre, locación, y existencia de los binarios CLI/CGI serán diferentes dependiendo en como Instales PHP en tu sistema. Cuando ejecutes make, CGI, y CLI son compilados automáticamente, y puestas comosapi/cgi/php y sapi/cli/php respectivamente, en el directorio "source" de PHP.

Debes notar, que los dos son llamados php. Lo que ocurre durante el proceso make depende en tu línea de configuración (./configure). Si el moduloSAPI es seleccionado durante tu configuración, como por ejemplo apxs, o la opción --disable-cgi es usada, el CLI es copiado a {PREFIX}/bin/php durante la ejecución del comando make install de otras maneras el CGI es instalado aquí. Por ejemplo, si pones --with-apxs en tu configuración, entonces el CLI es copiado a {PREFIX}/bin/php durante make install. Si tu quieres sobrescribir la instalación del CGI binario, utiliza make install-cli después de usar make install. Alternativamente puedes especificar --disable-cgi en tu línea de configuración.

Nota: Por que ambos --enable-cli y --enable-cgi son activados automáticamente, simplemente teniendo --enable-cli en tu línea de configuración no necesariamente significa que CLI son copiados a {PREFIX}/bin/phpdurante make install.

Los archivos de PHP 4.2.0 y PHP 4.2.3 distribuían el CLI como php-cli.exe, y los mantenía en el mismo directorio que el CGI php.exe. Empezando con PHP 4.3.0 el archivo para windows distribuye el CLI como php.exe en un directorio llamado cli; o sea cli/php.exe.

Que versión de SAPI tengo?: Desde tu línea de comando, ejecutando php -v te dejara saber si php es CGI o CLI.

Diferencias remarcables del CLI SAPI comparadas con otros SAPIs: SAPIs:

• 
  
  En esta clase de CGI SAPI no hay cabeceras ("headers") escritas en el resultado ("output").
  Aunque el CGI SAPI provee una manera de suprimir HTTP cabeceras ("headers"), no existe una opción equivalente que los activa en el CLI SAPI.
  CLI automáticamente empieza en modo silencioso, la opción -q existe por compatibilidad con antiguos programas CGI.
  No cambia el directorio corriente, a ese en el cual el programa vive. La opción -C es mantenida por compatibilidad.
  Errores son reportados en texto, no en el formato HTML.
  
  
• 
  
  Hay ciertas directivas en el php.ini que son sobrescrita por el CLI SAPI por que estas no hacen mucho sentido en situaciones donde la línea de comando es usada:
  
  
  
  

  Tabla 43-1. Directivas sobrescrita en php.ini

  Directivas (directives)	CLI SAPIevaluó automático (default value)	Commentario (comment)
  html_errors	FALSE	Cuando los resultados incorrectos aparecen en tu línea de comando, puede ser difícil hacer sentido de ellos con todas esas HTML tags, por esta razón, esta directiva es automáticamenteFALSE.
  implicit_flush	TRUE	Es deseoso que los resultados de print (imprimir)(), echo (ecco)() y otras relacionadas, sean inmediatamente escritas como resultados y no mantenidas en ningún buffer. Tu todavía puedes usar output buffering si tu quieres manipular los resultados proveidos automáticamente.
  max_execution_time	0 (unlimited)	Debido un numero ilimitado de posibilidades de usar PHP en la línea de comando, el máximo tiempo de ejecución es ilimitado. Aunque aplicaciones escritas para el Internet, usualmente requieres una rápida ejecución, la clase de aplicación que es ejecutada desde la línea de comando, usualmente necesitan mas tiempo para ejecutar correctamente.
  register_argc_argv	TRUE	Por que estas opciones son TRUE tu siempre necesitaras acceso al argc (el numero de argumentos pasados a la aplicación) y argv (el array de argumentos) en el CLI SAPI. Desde la versión 4.3.0 de PHP, las variables $argc y $argv son registradas y llenadas con los resultados apropiados cuando usando CLI SAPI. Antes de esta versión, la creación de estas variables es similar a como en CGI y MODULE versiones que requiere la PHP directiva register_globals estar on (active). Sin importar la versión o la configuración deregister_globals tu siempre puedes trabajar por medio de $_SERVER o $HTTP_SERVER_VARS. Por ejemplo: $_SERVER['argv']

  
  

  Nota: Estas instrucciones no pueden ser iniciadas con valores que son diferentes a los de la configuración en php.ini o el archivo correspondiente. Esta es una limitación dada por que esos valores automáticos, son aplicados después de que todos los archivos conteniendo parámetros de configuración an sido ejecutados; PERO, esto valores pueden ser cambiados mientras to programa esta ejecutando (esto no hace sentido para todas las directivas, como por ejemplo register_argc_argv).

  
  
• 
  
  Para facilitar trabajando en la línea de comando, las siguientes constantes son definidas:
  
  

  Tabla 43-2. constantes especificas de CLI

  Constant (constante)	Description (descripción)
  STDIN	Una stream abierta hacia stdin. Esto nos salva de abrirla con $stdin = fopen('php://stdin', 'r');
  STDOUT	Una stream abierta hacia stdout. Esto nos salva de abrirla con $stdout = fopen('php://stdout', 'w');
  STDERR	Una stream abierta hacia stderr. Esto nos salva de abrirla con $stderr = fopen('php://stderr', 'w');

  
  
  
  Dado lo anterior, tu no necesitas abrir, como por ejemplo, una stream hacia stderr manualmente, solamente necesitas usar la constante en vez de usar los recursos de la stream:

  php -r 'fwrite(STDERR, "stderr\n");'

  No necesitas cerrar estas stream explícitamente, desde que son cerradas automáticamente por PHP cuando tu programa termina.
  
  
• 
  
  El CLI SAPI no cambia el directorio en el cual to estas corrientemente, al directorio donde el programa ejecutado vive!
  
  
  Ejemplo mostrando la diferencia al CGI SAPI:

  <?php     /* Nuestra aplicaci&oacute;n llamada.php*/     echo getcwd(), "\n";?>

  
  
  
  Cuando usas la versión CGI el resultado es:

  $ pwd /tmp $ php -q otro_directorio/test.php /tmp/otro_directorio

  Esto claramente muestra que PHP cambia su directorio al usado por el programa que ejecutas.
  
  
  
  Usando el CLI SAPI resulta:

  $ pwd /tmp $ php -f otro_directorio/test.php /tmp

  Esto no da mas flexibilidad cuando escribiendo utilidades en la línea de comando con PHP.