LVI. 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í.

Requirimientos

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 H.

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 recibir 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

Hosting by: hurra.com
Generated: 2007-01-26 18:00:53