PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Downloads
Documentation
Get Involved
Help

PHP 5.4.27 Released

Getting Started
Introduction
A simple tutorial
Language Reference
Basic syntax
Types
Variables
Constants
Expressions
Operators
Control Structures
Functions
Classes and Objects
Namespaces
Exceptions
Generators
References Explained
Predefined Variables
Predefined Exceptions
Predefined Interfaces and Classes
Context options and parameters
Supported Protocols and Wrappers

Security
Introduction
General considerations
Installed as CGI binary
Installed as an Apache module
Filesystem Security
Database Security
Error Reporting
Using Register Globals
User Submitted Data
Magic Quotes
Hiding PHP
Keeping Current
Features
HTTP authentication with PHP
Cookies
Sessions
Dealing with XForms
Handling file uploads
Using remote files
Connection handling

1 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Persistent Database Connections

Safe Mode
Command line usage
Garbage Collection
DTrace Dynamic Tracing

Function Reference
Affecting PHP's Behaviour
Audio Formats Manipulation
Authentication Services
Command Line Specific Extensions
Compression and Archive Extensions
Credit Card Processing
Cryptography Extensions
Database Extensions
Date and Time Related Extensions
File System Related Extensions
Human Language and Character Encoding Support
Image Processing and Generation
Mail Related Extensions
Mathematical Extensions
Non-Text MIME Output
Process Control Extensions
Other Basic Extensions
Other Services
Search Engine Extensions
Server Specific Extensions
Session Extensions
Text Processing
Variable and Type Related Extensions
Web Services
Windows Only Extensions
XML Manipulation

Keyboard Shortcuts
?
This help
j
Next menu item
k
Previous menu item
gp
Previous man page
gn
Next man page
G
Scroll to bottom
gg
Scroll to top
gh
Goto homepage
gs
Goto search
(current page)
/
Focus search box

2 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Diferencias respecto a otras SAPIs

Uso

Manual de PHP
Caractersticas
Funcionamiento en la lnea de comandos

Funcionamiento en la lnea de comandos

Introduccin
Diferencias respecto a otras SAPIs
Opciones
Uso
Flujos de E/S
Consola interactiva
Servidor web embebido
Configuracin INI

Change language: Spanish

Edit Report a Bug

Opciones de la lnea de comandos

Se puede consultar en cualquier momento la lista de opciones de lnea de comandos en el binario de PHP con el
modificador -h :

Usage: php [opciones] [-f] <fichero> [--] [args...]

php [opciones] -r <cdigo> [--] [args...]
php [opciones] [-B <cdigo_inicial>] -R <cdigo> [-E <cdigo_final>] [--] [args...]
php [opciones] [-B <cdigo_inicial>] -F <fichero> [-E <cdigo_final>] [--] [args...]
php [opciones] -- [args...]
php [opciones] -a

-a Se ejecuta interactivamente.
-c <ruta>|<fichero> Busca el fichero php.ini en este directorio.
-n No se usar el fichero php.ini.
-d foo[=bar] Define la entrada INI de foo con el valor 'bar'
-e Generate informacin extendida para el depurador/perfilador.
-f <fichero> Analiza y ejecuta el <fichero>.
-h Esta ayuda.
-i Informacin de PHP.
-l Solamente revisa la sintxis (lint).
-m Muestra lo compilado en mdulos.
-r <code> Ejecuta el <cdigo> PHP sin utilizar las etiquetas del script <?..?>.
-B <cdigo_inicial> Ejecuta el <cdigo_inicial> antes de procesar las lneas de entrada.
-R <code> Ejecuta el <cdigo> PHP por cada lnea de entrada.
-F <file> Analiza y ejecuta el <fichero> por cada lnea de entrada.
-E <cdigo_final> Ejecuta el <cdigo_final> despus de procesar todas las lneas de entrada.
-H Oculta los argumentos pasados desde cualquier herramienta externa.
-S <direccin>:<puerto> Ejecuta con el servidor web interno.
-t <raz_documento> Especifica la raz del documento <raz_documento> para el servidor web interno.
-s Salida de la fuente en sintxis HTML resaltada.
-v Nmero de versin.
-w Salida de la fuente con espacios en blanco y comentarios subrayados.
-z <fichero> Carga un <fichero> con extensin de Zend.

args... Argumentos pasados al script. Utilice argumentos con -- cuando el primer argumento
inicie con - o el script sea ledo desde la entrada estndar stdin

--ini Muestra los nombres de fichero de configuracin.

--rf <nombre> Muestra informacin sobre la funcin <nombre>.

--rc <nombre> Muestra informacin acerca de la clase <nombre>.
--re <nombre> Muestra informacin acerca de la extensin <nombre>.
--rz <nombre> Muestra informacin acerca de la extensin Zend <nombre>.
--ri <nombre> Muestra la configuracin para la extensin <nombre>.

3 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opciones de lnea de comandos

Opcin Opcin Larga Descripcin

Ejecutar PHP de forma interactiva. Para ms informacin, consltese la seccin Consola

-a --interactive
interactiva.

-b --bindpath Ruta Ligada en modo de servidor FASTCGI externo (slo en CGI).

-C --no-chdir No cambiar el directorio del script (slo en CGI).

-q --no-header Modo silencioso. Elimina la salida de cabeceras HTTP (slo en CGI).

-T --timing Calcula el tiempo de ejecucin del script un nmero de veces (slo en CGI).

Especifica ya sea un directorio en el que se busca a php.ini o bien un fichero INI

personalizado (que no tiene porqu llamarse php.ini necesariamente), p.ej.:

$ php -c /directorio/propio/mi_script.php
-c --php-ini
$ php -c /directorio/propio/fichero-propio.ini mi_script.php

Si no se especifica esta opcin, se busca el fichero php.ini en las localizaciones

predeterminadas.

-n --no-php-ini Ignorar por completo el fichero php.ini.

Establecer un valor predeterminado para cualquiera de las directivas de configuracin

permitidas en php.ini. sta es la sintaxis:

-d directiva_de_configuracion[=valor]

# Si se omite el valor, se establecer un "1" a la directiva

$ php -d max_execution_time
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(1) "1"

-d --define # Si se pasa un valor vaco, se establecer "" a la directiva

php -d max_execution_time=
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(0) ""

# Se pasar lo que haya tras el caracter '=' a la directiva de configuracin

$ php -d max_execution_time=20
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(2) "20"
$ php
-d max_execution_time=doesntmakesense
-r '$foo = ini_get("max_execution_time"); var_dump($foo);'
string(15) "doesntmakesense"

-e --profile-info Activa el modo de informacin expandida, para usar con un depurador/perfilador.

Analiza y ejecuta el fichero proporcionado. El modificador -f es opcional y puede ser

-f --file omitido - es suficiente con solo poner el nombre del fichero a ejecutar.

Nota:

4 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opcin Opcin Larga Descripcin

Para pasar argumentos a un script, el primer argumento debe ser --, sino PHP
los interpretar como opciones de PHP.

Muestra una lista de opciones de lnea de comandos, con descripciones de una lnea sobre
-h y -? --help y --usage
lo que hace.
Invoca a phpinfo(), y muestra el resultado. Si PHP no funcionara correctamente, es
aconsejable utilizar php -i para ver donde se muestre cualquier mensaje de error antes o
-i --info
en el lugar de las tablas de informacin. Tenga en cuenta que al usarse en modo CGI la
salida es en HTML y por lo tanto muy larga.

Provee un mtodo conveniente para realizar solamente una revisin de sintxis del cdigo
proporcionado de PHP. En caso de xito, se muestra el texto No syntax errors detected in
<filename> en la salida estndar y se devuelve un cdigo de retorno 0. Si fallara, se
mostrara el texto Errors parsing <filename>, adems del mensaje de error de anlisis
correspondiente en la salida estndar, y se retornara el cdigo -1.
-l --syntax-check
Esta opcin no encuentra errores fatales (como funciones no definidas). Utilice el
modificador -f si se desea tambin comprobar errores fatales.

Nota:

Esta opcin no funciona junto con la opcin -r .

Ejemplo #1 Muestra los mdulos PHP y Zend incorporados (y habilitados)

$ php -m
[PHP Modules]
xml
tokenizer
standard
-m --modules session
posix
pcre
overload
mysql
mbstring
ctype

[Zend Modules]

Permite ejecutar PHP desde la lnea de comandos. Las etiquetas de inicio y fin (<?php y ?>)
no son necesarias y provocarn un error sintctico si estuvieran presentes.

Nota:

Debe tenerse cuidado al usar PHP de esta forma para no colisionar con
sustituciones de variables de lnea de comandos hechas por la propia consola.

Ejemplo #2 Obteniendo un error sintctico usando comillas dobles

-r --run
$ php -r "$foo = get_defined_constants();"
PHP Parse error: syntax error, unexpected '=' in Command line code on line 1

Parse error: syntax error, unexpected '=' in Command line code on line 1

El problema aqu es que sh/bash lleva a cabo una sustitucin de variables

incluso si estamos usando comillas dobles ". Puesto que la variable $foo no
est definida, no se sustituye por nada, haciendo que el cdigo real que se le
pasa a la ejecucin de PHP sea:

$ php -r " = get_defined_constants();"

5 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opcin Opcin Larga Descripcin

La forma correcta sera usar comillas simples '. Las variables de texto en
comillas simples no se sustituyen en sh/bash.

Ejemplo #3 Usando comillas simples para prevenir la sustitucin de

variables de la consola

$ php -r '$foo = get_defined_constants(); var_dump($foo);'

array(370) {
["E_ERROR"]=>
int(1)
["E_WARNING"]=>
int(2)
["E_PARSE"]=>
int(4)
["E_NOTICE"]=>
int(8)
["E_CORE_ERROR"]=>
[...]

Si se est usando una consola diferente de sh/bash, es posible experimentar

otros errores. Le animamos a enviar un informe de error a
http://bugs.php.net/. Tenga en cuenta que es muy fcil verse en problemas al
tratar de utilizar variables (de la consola o de PHP) en cdigo de lnea de
comandos, o al usar el caracter de barra invertida (\) para escapar caracteres,
as que tome mucho cuidado haciendo eso. Ha sido advertido!

Nota:

-r est disponible en CLI SAPI, pero no en CGI SAPI.

Nota:

Esta opcin est pensada unicamente para cdigo muy bsico, as que algunas
directivas de configuracin (tales como auto_prepend_file y auto_append_file)
se ignoran en este modo.

-B --process-begin Cdigo PHP a ejecutar antes de procesar la entrada. Aadido en PHP 5.

Cdigo PHP a ejecutar por cada lnea de entrada. Aadido en PHP 5.

-R --process-code Hay dos variables especiales disponibles en este modo: $argn y $argi. $argn contendr la
lnea que PHP est procesando en un momento dado, mientras que $argi contendr el
nmero de lnea.

-F --process-file Fichero PHP a ejecutar por cada lnea de entrada. Aadido en PHP 5.

Cdigo PHP a ejecutar tras procesar cada lnea. Aadido en PHP 5.

Ejemplo #4 Usando las opciones -B , -R y -E para contar el nmero de lneas de un

-E --process-end proyecto.

$ find my_proj | php -B '$l=0;' -R '$l += count(@file($argn));' -E 'echo "Total Lines: $l\n";'
Total Lines: 37328

-S --server Inicia el servidor web interno. Disponible a partir de PHP 5.4.0.

6 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opcin Opcin Larga Descripcin

Especifiva la raz del documento para el servidor web interno. Disponible a partir de PHP
-t --docroot
5.4.0.

Mostrar el cdigo fuente destacando la sintaxis en color.

Esta opcin utiliza los mecanismos internos de anlisis del ficheros y escribe una versin
--syntax-
HTML coloreada y la muestra en la salida estndar. Tenga en cuenta que todo lo que hace
highlight y
-s es generar un bloque de etiquetas HTML <code> [...] </code>, sin cabeceras HTML.
--syntax-
highlighting Nota:

Esta opcin no puede funcionar junto con la opcin -r .

Ejemplo #5 Al usar -v obtenemos el nombre de la SAPI y la versin de PHP y Zend

-v --version $ php -v
PHP 5.3.1 (cli) (built: Dec 11 2009 19:55:07)
Copyright (c) 1997-2009 The PHP Group
Zend Engine v2.3.0, Copyright (c) 1998-2009 Zend Technologies

Mostrar cdigo fuente sin comentarios ni lneas en blanco.

-w --strip Nota:

Esta opcin no puede usarse junto con la opcin -r .

Carga una extensin Zend. Si slo se proporciona un nombre de fichero, PHP trata de
cargar la extensin en el directorio de bibliotecas por defecto de su sistema (normalmente
se especifica en /etc/ld.so.conf en sistemas Linux, por ejemplo). Si se proporciona un
-z --zend-extension
nombre de fichero con la ruta absoluta no se usarn las rutas de bibliotecas del sistema.
Un nombre de fichero relativo que incluya algn directorio le indicar a PHP que slo trate
de cargar la extensin a partir del directorio actual.

Mostrar el nombre del fichero de configuracin y de los directorios analizados. Disponible

desde PHP 5.2.3.

Ejemplo #6 Ejemplo de --ini

--ini
$ php --ini
Configuration File (php.ini) Path: /usr/dev/php/5.2/lib
Loaded Configuration File: /usr/dev/php/5.2/lib/php.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed: (none)

Mostrar informacin de la funcin o mtodo proporcionado (p.ej. nmero y nombre de los

parmetros). Disponible desde PHP 5.1.2.

Esta opcin slo est disponible si se compil PHP con soporte para Reflection.

Ejemplo #7 Uso bsico de --rf

--rf --rfunction
$ php --rf var_dump
Function [ <internal> public function var_dump ] {

- Parameters [2] {
Parameter #0 [ <requerido> $var ]
Parameter #1 [ <opcional> $... ]
}

7 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opcin Opcin Larga Descripcin

}

Muestra informacin de la clase dada (lista de constantes, propiedades y mtodos).

Disponible desde PHP 5.1.2.

Esta opcin slo est disponible si se compil PHP con soporte para Reflection.

Ejemplo #8 Ejemplo de --rc

$ php --rc Directory

Class [ <internal:standard> class Directory ] {

- Constants [0] {
}

- Static properties [0] {

}
--rc --rclass
- Static methods [0] {
}

- Properties [0] {
}

- Methods [3] {
Method [ <internal> public method close ] {
}

Method [ <internal> public method rewind ] {

}

Method [ <internal> public method read ] {

}
}
}

Muestra informacin de la extensin dada (lista de opciones en php.ini, funciones

definidas, constantes y clases). Disponible desde PHP 5.1.2.

Esta opcin slo est disponible si se compil PHP con soporte para Reflection .

Ejemplo #9 Ejemplo de --re

--re --rextension $ php --re json

Extension [ <persistent> extension #19 json version 1.2.1 ] {

- Functions {
Function [ <internal> function json_encode ] {
}
Function [ <internal> function json_decode ] {
}
}
}

Mostrar la informacin de configuracin para la extensin Zend proporcionada (la misma

--rz --rzendextension informacin que es devuelta por la funcin phpinfo()). Disponible como parte de PHP
5.4.0.

Mostrar informacin de configuracin de la extensin dada (la misma informacin que

muestra phpinfo()). Disponible desde PHP 5.2.2. La informacin relevante est disponible
usando "main" como nombre de extensin.
--ri --rextinfo
Ejemplo #10 Ejemplo de --ri

$ php --ri date

8 de 9 10/04/14 11:36
PHP: Opciones - Manual http://php.net/manual/es/features.commandline.optio...

Opcin Opcin Larga Descripcin

date

date/time support => enabled

"Olson" Timezone Database Version => 2009.20
Timezone Database => internal
Default timezone => Europe/Oslo

Directive => Local Value => Master Value

date.timezone => Europe/Oslo => Europe/Oslo
date.default_latitude => 59.930972 => 59.930972
date.default_longitude => 10.776699 => 10.776699
date.sunset_zenith => 90.583333 => 90.583333
date.sunrise_zenith => 90.583333 => 90.583333

Nota:

Las opciones -rBRFEH, --ini y --r[fcezi] slo estn disponibles en CLI.

add a note

User Contributed Notes

There are no user contributed notes for this page.

Copyright 2001-2014 The PHP Group

My PHP.net
Contact
Other PHP.net sites
Mirror sites
Privacy policy

9 de 9 10/04/14 11:36