The manual states above:
<<<
The default is to allow dynamic loading, except when using safe mode. In safe mode, it's always impossible to use dl().
>>>
...however, on the manual page for dl(), it states:
<<<
Note: dl() is not supported in multithreaded Web servers. Use the extensions statement in your php.ini when operating under such an environment. However, the CGI and CLI build are not affected !
Note: As of PHP 5, the dl() function is deprecated in every SAPI except CLI. Use Extension Loading Directives method instead.
Note: Since PHP 6 this function is disabled in all SAPIs, except CLI, CGI and embed.
>>>
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
| 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 | |
| max_execution_time | "30" | PHP_INI_ALL | |
| max_input_time | "-1" | PHP_INI_PERDIR | Disponible desde PHP 4.3.0. |
| magic_quotes_gpc | "1" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
| magic_quotes_runtime | "0" | PHP_INI_ALL |
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()
| 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. |
Tabla 3. 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. |
- 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
Note: when magic_quotes_gpc is ON, it will also slash values inside both $_SERVER['QUERY_STRING'] and $_SERVER['SCRIPT_NAME'] (and equivalents) will also be slashed.
You probably don't want to set "magic_quotes_runtime" because it affects even binary file read/write operations. This is especially problematic if you include someone else's library that depends on binary read/write. If you enable "magic_quotes_runtime", be sure to use set_magic_quotes_runtime() function call to disable it before calling someone else's library that does binary read/write.
