Opciones e Informaci贸n de PHP

CXIV. Opciones e Informaci贸n de PHP

Introducci贸n

Estas funciones le dan la capacidad de obtener una gran cantidad de informaci贸n sobre PHP mismo, p.ej. configuraci贸n de tiempo de ejecuci贸n, extensiones cargadas, versiones y mucho m谩s. Tambi茅n encontrar谩 funciones para establecer opciones para su int茅rprete PHP en ejecuci贸n. La que es probablemente la funci贸n mejor conocida de PHP - phpinfo() - puede ser encontrada aqu铆.

Requisitos

No se necesitan bibliotecas externas para construir esta extensi贸n

Instalaci贸n

No se necesita ninguna instalaci贸n para usar estas funciones, son parte del n煤cleo de PHP.

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 del sistema de informaci贸n PHP

NombrePredeterminadoModificableCambios
assert.active"1"PHP_INI_ALL 
assert.bail"0"PHP_INI_ALL 
assert.warning"1"PHP_INI_ALL 
assert.callbackNULLPHP_INI_ALL 
assert.quiet_eval"0"PHP_INI_ALL 
enable_dl"1"PHP_INI_SYSTEM 
max_execution_time"30"PHP_INI_ALL 
max_input_time"-1"PHP_INI_PERDIRDisponible desde PHP 4.3.0.
magic_quotes_gpc"1"PHP_INI_PERDIRPHP_INI_ALL en PHP <= 4.2.3.
magic_quotes_runtime"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.

assert.active boolean

Habilitar la evaluaci贸n assert().

assert.bail boolean

Terminar la ejecuci贸n del script cuando las aserciones fallen.

assert.warning boolean

Producir una advertencia PHP para cada aserci贸n fallida.

assert.callback string

Funci贸n de usuario a llamar cuando las aserciones fallen.

assert.quiet_eval boolean

Usar el valor actual de error_reporting() durante la evaluaci贸n de expresiones asertivas. Si se habilita, no se muestran errores durante la evaluaci贸n (implicit error_reporting(0)). Si se deshabilita, los errores son mostrados de acuerdo a los valores de error_reporting().

enable_dl boolean

Esta directiva es 煤til en realidad 煤nicamente en la versi贸n de m贸dulo de Apache de PHP. Puede habilitar y deshabilitar la carga din谩mica de extensiones PHP con dl() para cada servidor virtual o por directorio.

La raz贸n principal para deshabilitar la carga din谩mica es la seguridad. Con la carga din谩mica, es posible ignorar todas las restricciones open_basedir. El comportamiento predeterminado es permitir la carga din谩mica, excepto cuando se usa safe mode. En safe mode, siempre es imposible usar dl().

max_execution_time integer

Este valor define el tiempo m谩ximo en segundos que se le permite correr a un script, antes de que sea detenido por el int茅rprete. Esto ayuda a prevenir que scripts pobremente escritos congestionen el servidor. El valor predeterminado es 30.

El tiempo m谩ximo de ejecuci贸n no es afectado por llamadas del sistema, operaciones de secuencias etc. Por favor consulte la funci贸n set_time_limit() para m谩s detalles.

No puede modificar este par谩metro con ini_set() cuando est谩 corriendo bajo safe mode. El 煤nico modo de evitar este contratiempo es deshabilitar el modo seguro, o cambiar el tiempo l铆mite en php.ini.

Su servidor web puede tener otros tiempos de espera. Por ejemplo, Apache tiene la directiva Timeout, IIS tiene la funci贸n timeout CGI, y ambos valores predeterminados son de 300 segundos. Vea la documentaci贸n del servidor web para consultar su significado.

max_input_time integer

Este valor establece el tiempo m谩ximo en segundos con el que cuenta un script para procesar datos de entrada, como POST, GET y cargas de archivos.

magic_quotes_gpc boolean

Establece el estado de magic_quotes para las operaciones GPC (Get/Post/Cookie). Cuando magic_quotes se encuentra activo, todos los caracteres ' (comilla-simple), " (comilla doble), \ (barra invertida) y NULs son escapados con una barra invertida autom谩ticamente.

Nota: Si la directiva magic_quotes_sybase se encuentra activa tambi茅n, sobrescribir谩 completamente el valor de magic_quotes_gpc. Tener ambas directivas activas quiere decir que solo las comillas simples son escapadas como ''. Las comillas dobles, las barras invertidas y NULs permanecer谩n intactos y sin escapar.

Vea tambi茅n get_magic_quotes_gpc().

magic_quotes_runtime boolean

Si magic_quotes_runtime est谩 habilitado, la mayor铆a de funciones que devuelven datos de alguna clase de fuente externa, incluyendo bases de datos y archivos de texto, tendr谩n las comillas escapadas con barras invertidas. Si magic_quotes_sybase se encuentra habilitado tambi茅n, una comilla sencilla es escapada con una comilla sencilla en lugar de una barra invertida.

Tipos de recursos

Esta extensi贸n no tiene ning煤n tipo de recurso definido.

Constantes predefinidas

Las constantes listadas aqui est谩n siempre disponibles a trav茅s del "n煤cleo PHP".

Tabla 2. Constantes predefinidas de phpcredits()

ConstanteValorDescripci贸n
CREDITS_GROUP1Una lista de los desarrolladores centrales
CREDITS_GENERAL2 Cr茅ditos generales: Dise帽o y concepto del lenguaje, autores de PHP y del m贸dulo SAPI.
CREDITS_SAPI4 Una lista de los m贸dulos API de servidor para PHP, y sus autores.
CREDITS_MODULES8 Una lista de m贸dulos de extensi贸n de PHP, y sus autores.
CREDITS_DOCS16 Los cr茅ditos para el equipo de documentaci贸n.
CREDITS_FULLPAGE32 Usualmente usado en combinaci贸n con las otras banderas. Indica que es necesario imprimir una p谩gina HTML independiente que incluya la informaci贸n indicada por las otras banderas.
CREDITS_QA64 Los cr茅ditos para el equipo de revisi贸n de calidad.
CREDITS_ALL-1 Todos los cr茅ditos, equivalente a usar: CREDITS_DOCS + CREDITS_GENERAL + CREDITS_GROUP + CREDITS_MODULES + CREDITS_QA CREDITS_FULLPAGE. Genera una p谩gina HTML independiente completa con las etiquetas apropiadas. Este es el valor predeterminado.

Tabla 3. Constantes phpinfo()

ConstanteValorDescripci贸n
INFO_GENERAL1 La l铆nea de configuraci贸n, ubicaci贸n de php.ini, fecha de compilaci贸n, Servidor Web, Sistema y m谩s.
INFO_CREDITS2 Cr茅ditos PHP. Vea tambi茅n phpcredits().
INFO_CONFIGURATION4 Valores Locales y Maestros actuales de las directivas PHP. Vea tambi茅n ini_get().
INFO_MODULES8 M贸dulos cargados y sus respectivos par谩metros.
INFO_ENVIRONMENT16 Informaci贸n de Variables de Entorno, que tambi茅n est谩 disponible en $_ENV.
INFO_VARIABLES32 Muestra todas las variables predefinidas de EGPCS (Entorno, GET, POST, Cookie, Servidor).
INFO_LICENSE64 Informaci贸n de la Licencia PHP. Vea tambi茅n el faq de licencia.
INFO_ALL-1 Muestra todo lo anterior. Este es el valor predeterminado.

ASSERT_ACTIVE (integer)

ASSERT_CALLBACK (integer)

ASSERT_BAIL (integer)

ASSERT_WARNING (integer)

ASSERT_QUIET_EVAL (integer)

Tabla de contenidos
assert_options -- Establecer/obtener las varias banderas de aserci贸n
assert -- Revisa si la aserci贸n es evaluada a FALSE
dl -- Carga una extensi贸n PHP en tiempo de ejecuci贸n
extension_loaded -- Encontrar si una extensi贸n est谩 cargada
get_cfg_var --  Obtiene el valor de una opci贸n de configuraci贸n de PHP
get_current_user --  Obtiene el nombre del due帽o del script PHP actual
get_defined_constants --  Devuelve una matriz asociativa con los nombres de todas las constantes y sus valores
get_extension_funcs --  Devuelve una matriz con los nombres de funciones de un m贸dulo
get_include_path --  Obtiene la opci贸n de configuraci贸n include_path actual
get_included_files --  Devuelve una matriz con los nombres de los archivos incluidos o requeridos
get_loaded_extensions --  Devuelve una matriz con los nombres de todos los m贸dulos compilados y cargados
get_magic_quotes_gpc --  Obtiene el valor actual de configuraci贸n de la comillas m谩gicas gpc
get_magic_quotes_runtime --  Obtiene el valor de configuraci贸n activo actual de magic_quotes_runtime
get_required_files -- Alias of get_included_files()
getenv -- Obtiene el valor de una variable de entorno
getlastmod -- Obtiene la hora de la 煤ltima modificaci贸n de la p谩gina
getmygid -- Obtener el GID del due帽o del script PHP
getmyinode -- Obtiene el inode del script actual
getmypid -- Obtiene el ID del proceso PHP
getmyuid -- Obtiene el UID del due帽o del script PHP
getopt -- Obtiene opciones de la lista de argumentos desde la l铆nea de comandos
getrusage -- Obtiene los usos de recursos actuales
ini_alter -- Alias of ini_set()
ini_get_all -- Obtiene todas las opciones de configuraci贸n
ini_get -- Obtiene el valor de una opci贸n de configuraci贸n
ini_restore -- Restablece el valor de una opci贸n de configuraci贸n
ini_set -- Establece el valor de una opci贸n de configuraci贸n
main -- P谩gina predeterminada para main()
memory_get_usage -- Devuelve la cantidad de memoria ubicada para PHP
php_ini_scanned_files -- Devolver una lista de archivos .ini procesados del directorio ini adicional
php_logo_guid -- Obtiene el valor guid del logo
php_sapi_name --  Devuelve el tipo de interfaz entre el servidor web y PHP
php_uname --  Devuelve informaci贸n sobre el sistema operativo en el que est谩 corriendo PHP
phpcredits -- Imprime los cr茅ditos de PHP
phpinfo -- Imprime cantidades de informaci贸n sobre PHP
phpversion -- Obtiene la versi贸n de PHP actual
putenv -- Establece el valor de una variable de entorno
restore_include_path --  Restablece el valor de la opci贸n de configuraci贸n include_path
set_include_path --  Establece la opci贸n de configuraci贸n include_path
set_magic_quotes_runtime --  Establece el valor de configuraci贸n activo actual de magic_quotes_runtime
set_time_limit -- Limita el tiempo m谩ximo de ejecuci贸n
version_compare --  Compara dos cadenas de n煤mero de versi贸n "PHP-est谩ndar"
zend_logo_guid -- Obtiene el valor guid de Zend
zend_version -- Obtiene la versi贸n del motor Zend actual