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.

**Opciones de Configuración del sistema de información PHP**
Nombre	Predeterminado	Modificable	Cambios
assert.active	"1"	PHP_INI_ALL
assert.bail	"0"	PHP_INI_ALL
assert.warning	"1"	PHP_INI_ALL
assert.callback	NULL	PHP_INI_ALL
assert.quiet_eval	"0"	PHP_INI_ALL
enable_dl	"1"	PHP_INI_SYSTEM	Eliminada en PHP 6.0.0.
max_execution_time	"30"	PHP_INI_ALL
max_input_time	"-1"	PHP_INI_PERDIR	Disponible desde PHP 4.3.0.
max_input_nesting_level	"64"	PHP_INI_PERDIR	Disponible desde PHP 4.4.8. Eliminada en PHP 5.0.0.
magic_quotes_gpc	"1"	PHP_INI_PERDIR	PHP_INI_ALL en PHP <= 4.2.3. Eliminada en PHP 6.0.0.
magic_quotes_runtime	"0"	PHP_INI_ALL	Eliminada en PHP 6.0.0.

For further details and definitions of the PHP_INI_* constants, see the Directivas de php.ini.

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.

max_input_nesting_level integer

Establece la profundidad máxima de anidamiento de las variables de entrada (es decir, $_GET, $_POST..)

magic_quotes_gpc boolean

Warning

This feature is DEPRECATED and REMOVED as of PHP 6.0.0. Relying on this feature is highly discouraged.

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.

Note: En PHP 4, las variables $_ENV son escapadas.

Note: 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

Warning

This feature is DEPRECATED and REMOVED as of PHP 6.0.0. Relying on this feature is highly discouraged.

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

**Constantes predefinidas de phpcredits()**
Constante	Valor	Descripción
CREDITS_GROUP	1	Una lista de los desarrolladores centrales
CREDITS_GENERAL	2	Créditos generales: Diseño y concepto del lenguaje, autores de PHP y del módulo SAPI.
CREDITS_SAPI	4	Una lista de los módulos API de servidor para PHP, y sus autores.
CREDITS_MODULES	8	Una lista de módulos de extensión de PHP, y sus autores.
CREDITS_DOCS	16	Los créditos para el equipo de documentación.
CREDITS_FULLPAGE	32	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_QA	64	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.

**Constantes phpinfo()**
Constante	Valor	Descripción
INFO_GENERAL	1	La línea de configuración, ubicación de `php.ini`, fecha de compilación, Servidor Web, Sistema y más.
INFO_CREDITS	2	Créditos PHP. Vea también phpcredits().
INFO_CONFIGURATION	4	Valores Locales y Maestros actuales de las directivas PHP. Vea también ini_get().
INFO_MODULES	8	Módulos cargados y sus respectivos parámetros.
INFO_ENVIRONMENT	16	Información de Variables de Entorno, que también está disponible en `$_ENV`.
INFO_VARIABLES	32	Muestra todas las variables predefinidas de EGPCS (Entorno, GET, POST, Cookie, Servidor).
INFO_LICENSE	64	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)

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_peak_usage — Returns the peak of memory allocated by PHP
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
sys_get_temp_dir — Returns directory path used for temporary files
version_compare — Compara dos cadenas de número de versión "PHP-estándar"
zend_logo_guid — Obtiene el valor guid de Zend
zend_thread_id — Returns a unique identifier for the current thread
zend_version — Obtiene la versión del motor Zend actual