Esta lista incluye las directivas del núcleo de php.ini que se pueden establecer para la configuración de PHP. Las directivas para extensiones están listadas y detalladas en las páginas de la documentación de las extensiones. La información sobre las directivas de sesión, por ejemplo, pueden ser encontradas en la página de sesiones.
Nombre | Valor predeterminado | Se puede cambiar en | Registro de cambios |
---|---|---|---|
async_send | "0" | PHP_INI_ALL |
Nombre | Valor predeterminado | Se puede cambiar en | Registro de cambios |
---|---|---|---|
short_open_tag | "1" | PHP_INI_ALL | PHP_INI_ALL en PHP 4.0.0. PHP_INI_PERDIR en PHP < 5.3.0 |
asp_tags | "0" | PHP_INI_PERDIR | PHP_INI_ALL en PHP 4.0.0. |
precision | "14" | PHP_INI_ALL | |
y2k_compliance | "1" | PHP_INI_ALL | |
allow_call_time_pass_reference | "1" | PHP_INI_PERDIR | PHP_INI_ALL en PHP en 4.0.0. |
disable_functions | "" | Solo en php.ini | Disponible desde PHP 4.0.1. |
disable_classes | "" | Solo en php.ini | Disponible desde PHP 4.3.2. |
expose_php | "1" | Solo en php.ini | |
zend.ze1_compatibility_mode | "0" | PHP_INI_ALL | Disponible desde PHP 5.0.0. Suprimido en PHP 5.3.0 |
detect_unicode | "1" | PHP_INI_ALL | Disponible desde PHP 5.1.0. Esta opción obsoleta será sin duda eliminada en el futuro. |
He aquí una breve explicación de las directivas de configuración.
Indica a PHP si las etiquetas cortas (<? ?>
)
de apertura de PHP están activadas. Si quiere utilizar PHP en combinación con XML,
puede desactivar esta opción para poder usar <?xml ?>
.
Si no, puede usar PHP para mostrar xml, por ejemplo <?php echo '<?xml
version="1.0"?>'; ?>
. Si por lo contrario está desactivado, debe
usar siempre la forma larga de abrir la etiqueta PHP (<?php ?>
).
Note:
Esta directiva también afecta el código
<?=
, que es lo mismo que<? echo
. El uso de esta forma corta requiere queshort_open_tag
esté on.
Sirve para indicar cuando se pasan argumentos por referencia en el momento que se llama a la función. Se recomienda especificar cuando los argumentos son pasados por referencia en la declaración de la función. Le animamos a que desactive esta opción (Off) para asegurarse de que sus scripts funcionarán en futuras versiones del lenguaje. (si está desactivada se mostrará un warning cada vez que utilice esta opción).
Pasar argumentos por referencia en el momento que se llama a la función quedó obsoleto por razones de limpieza en el código. La función puede usar argumentos por referencia sin tener que indicarlo. Pero para prevenir efectos secundarios es mejor especificar que los argumentos son pasados por referencia solamente en la declaración de la función.
En PHP5, allow_call_time_pass_reference está obsoleto, en versiones anteriores a PHP 5.3.0, usar esta opción provocará un E_COMPILE_WARNING, y en PHP 5.3.0+, el warning es un notice E_DEPRECATED.
Vea también Explicando las referencias.
Indica cuando mostrar que PHP está instalado en el servidor (ejemplo: añadiendo su firma en el encabezado del servidor). Esto no es una brecha de seguridad ni mucho menos, pero hace posible determinar si está usando PHP en su servidor o no.
Note: Nota de disponibilidad
Esta directiva seguramente estará disponible en PHP 4.3.2
Activa el modo de compatibilidad con Zend Engine 1 (PHP 4). Esto afecta a la clonación, conversión, (objectos sin propiedades son convertidos a FALSE o 0), y comparación de objectos. En este modo, los objectos son pasados por valor en lugar de por referencia por defecto.
Vea también la sección titulada Migrando de PHP 4 a PHP 5.
Esta característica ha quedado OBSOLETA y fue REMOVIDA a partir de PHP 5.3.0.
Comprueba el BOM (Byte Order Mark) y mira si el fichero contiene caracteres multibyte válidos. La detección se hace antes del proceso de __halt_compiler(). Está disponible solamente en Zend modo multibyte.
Nombre | Valor predeterminado | Se pueda cambiar en | Registro de cambios |
---|---|---|---|
memory_limit | "128M" | PHP_INI_ALL | "8M" antes de PHP 5.2.0, "16M" en PHP 5.2.0 |
He aquí una breve explicación de las directivas de configuración.
Establece el máximo de memoria en bytes que un script puede consumir. Ayuda a prevenir que scripts mal programados consuman toda la memoria disponible en el servidor. Nota para no tener límite de memoria, establezca esta directiva a -1.
En versiones anteriores a PHP 5.2.1, para usar esta directiva se tenía compilar php usando la opción --enable-memory-limit . Esta flag en tiempo de ejecucción también era requerida para definir las funciones memory_get_usage() y memory_get_peak_usage() en versiones anteriores a PHP 5.2.1.
Cuando se usa un número entero, el valor del mismo es medido en bytes. También se puede usar la notación reducida tal como se describe en esta FAQ.Vea también: max_execution_time.
Nombre | Valor predeterminado | Cambiable en | Registro de cambios |
---|---|---|---|
realpath_cache_size | "16K" | PHP_INI_SYSTEM | Disponible desde PHP 5.1.0. |
realpath_cache_ttl | "120" | PHP_INI_SYSTEM | Disponible desde PHP 5.1.0. |
He aquí una breve explicación de las directivas de configuración.
Determina el tamaño de la caché de realpath que va a ser usada por PHP. Este valor debe ser incrementado en sistemas donde PHP abre muchos ficheros, para reflejar la cantidad de operaciones realizadas con ficheros.
Duración en tiempo (en segundos) para cachear la información del realpath para un determinado fichero o directorio. Para sistemas que raramente cambian ficheros, considere incrementar este valor.
Nombre | Valor predeterminado | Cambiable en | Registro de cambios |
---|---|---|---|
track_vars | "On" | PHP_INI_?? | |
arg_separator.output | "&" | PHP_INI_ALL | Disponible desde PHP 4.0.5. |
arg_separator.input | "&" | PHP_INI_PERDIR | Disponible desde PHP 4.0.5. |
variables_order | "EGPCS" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 5.0.5. |
request_order | "" | PHP_INI_SYSTEM|PHP_INI_PERDIR | Disponible desde PHP 5.3.0 |
auto_globals_jit | "1" | PHP_INI_PERDIR | Disponible desde PHP 5.0.0. |
register_globals | "0" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
register_argc_argv | "1" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
register_long_arrays | "1" | PHP_INI_PERDIR | Disponible desde PHP 5.0.0. Obsoleto en PHP 5.3.0. Eliminado en PHP 6.0.0. |
post_max_size | "8M" | PHP_INI_PERDIR | PHP_INI_SYSTEM en PHP <= 4.2.3. Disponible desde PHP 4.0.3. |
gpc_order | "GPC" | PHP_INI_ALL | |
auto_prepend_file | NULL | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
auto_append_file | NULL | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
default_mimetype | "text/html" | PHP_INI_ALL | |
default_charset | "" | PHP_INI_ALL | |
always_populate_raw_post_data | "0" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. Disponible desde PHP 4.1.0. |
allow_webdav_methods | "0" | PHP_INI_PERDIR |
He aquí una breve explicación de las directivas de configuración.
si está activado, las variables de entorno, GET POST, Cookie y variables de servidor pueden encontrarse en los siguientes arrays asociativos globales $_ENV, $_GET, $_POST, $_COOKIE, y $_SERVER.
Note que desde PHP 4.0.3, track_vars
siempre está activado.
El separador usado en PHP para separar argumentos en URLs generadas.
Lista de separador(es) usados por PHP para convertir datos de URLs en variables.
Note:
¡Atención: cada caracter en esta directiva es considerado como separador!
Establece el orden de interpretación de variables EGPCS (Entorno, Get, Post, Cookie, and Server). Por ejemplo, si variables_order es "SP" entonces PHP creará superglobals $_SERVER y $_POST, pero no creará $_ENV, $_GET, y $_COOKIE. Si lo asiganmos "" las variables superglobals no estarán disponibles.
Si la directiva obsoleta register_globals está activada, entonces variables_order también configura el orden de las variables ENV, GET, POST, COOKIE y SERVER y están disponibles de forma global. Por ejemplo si variables_order está establecido a "EGPCS", register_globals está activado, y los dos $_GET['action'] y $_POST['action'] existen, entonces $action contendrá el valor de $_POST['action'] como P viene después de G en el ejemplo que mostramos.
En los dos casos CGI y FastCGI SAPI, $_SERVER también es complimentado con los valores de entorno; S siempre es equivalente a ES a pesar de la posición de E en cualquier otro lugar en la directiva.
Note:
El contenido y el orden de $_REQUEST también es afectado por esta directiva.
Esta directiva describe el orden en que PHP registra las variables GET, POST y Cookie en el array _REQUEST. El registro se hace de izquierda a derecha, los nuevos valores reemplazan los valores más antiguos.
Si esta directiva no está definida, variables_order se usa para el contenido de $_REQUEST contents.
Observe que la distribución por defecto de los ficheros php.ini no contienen 'C' para cookies, por motivos de seguridad.
Cuando está activado, las variables SERVER y EVN son creadas la primera vez que se necesitan (justo a tiempo) en lugar de crearse cuando el script empieza. Si estas variables no son usadas cuando empieza el script, esta directiva afectará a la mejora del rendimiento.
Las directivas PHP register_globals, register_long_arrays, y register_argc_argv deben estar desactivadas para que esta directiva tenga efecto. Desde PHP 5.1.3 no es necesario tener register_argc_argv desactivado.
El uso de las variables SERVER y ENV se comprueba durante el tiempo de ejecucción, quiere decir que usándolas vía por ejemplo: variable variables no causará su inicialización.
Registre o no registre las variables EGPS (Entorno, GET, POST, Cookie, Server) son globales.
En » PHP 4.2.0, esta directiva está por defecto off.
Para información relacionada por favor lea el capítulo de seguridar en Using register_globals.
Por favor, note que register_globals
no puede ser defindio en tiempo de ejecucción
(ini_set()). Aún así, puede usar
.htaccess si el servidor se lo permite, tal como
se muestra debajo. Un ejemplo de entrada .htaccess:
php_flag register_globals off
.
Note:
register_globals
es afectado por la directiva variables_order.
Esta opción ha sido declarada OBSOLETA desde PHP 5.3.0. Su uso está totalmente desaconsejado.
Esta opción ha sido declarada OBSOLETA desde PHP 5.3.0. Su uso está totalmente desaconsejado.
Note:
PHP acepta abreviaturas para algunos valores, incluyendo K (kilo), M (mega) y g (giga). PHP hará las conversión automaticamente si utiliza cualquiera de estas abreviaturas. Tenga cuidad de no execeder enteros más de 32 bits (si está usando veriones 32bits) esto causará que us script falle.
Orden en que se interpretan las variables GET/POST/COOKIE. Por defecto esta directiva está establecida a "GPC". Si la cambia a "GP", por ejemplo, causará que PHP ignore cookies y sobreescriba cualquier variable del método GET con el mismo nombre en la variable del método POST.
Note:
Esta opción no está disponible en PHP 4. Utilice variables_order en su lugar.
Nombre del fichero que será automaticamente interpretado antes del fichero principal. El fichero es incluido como si fuera llamado con la función require(), include_path es usado.
El valor especial none desactiva el auto-prepending.
Nombre del fichero que será automaticamente interpretado después del fichero principal. El fichero es incluido como si fuera llamado con la función require(), include_path es usado.
El valo especial none desactiva auto-appending.
Note: Si el script finaliza con exit(), auto-append no será ejecutado.
PHP siempre muestra el tipo de encoding por defecto en Content-type, en el encabezado. Para desactivar el charset simplemente deje el parámetro vacío.
Rellena la variable $HTTP_RAW_POST_DATA con el contenido crudo de los datos POST. Sino, la variable contendrá solamente tipos de datos MIME no reconocidos. De cualquier forma, la mejor forma de acceder a los datos crudos de POST es vía php://input $HTTP_RAW_POST_DATA no está disponible con datos enctype="multipart/form-data".
Permite aceptar peticiones http WebDAV en scripts PHP (ej: PROPFIND, PROPPATCH, MOVE, COPY, etc.). Esta directiva no existe a partir de PHP 4.3.2. Si quiere obtener los datos post de estas peticiones, debe activar también always_populate_raw_post_data.
Vea también: magic_quotes_gpc, magic_quotes_runtime, y magic_quotes_sybase.
Nombre | Valor predeterminado | Se puede cambiar en | Lista de cambios |
---|---|---|---|
include_path | ".;/path/to/php/pear" | PHP_INI_ALL | |
open_basedir | NULL | PHP_INI_ALL | PHP_INI_SYSTEM en PHP < 5.3.0 |
doc_root | NULL | PHP_INI_SYSTEM | |
user_dir | NULL | PHP_INI_SYSTEM | |
extension_dir | "/path/to/php" | PHP_INI_SYSTEM | |
extension | NULL | Solo en php.ini | |
zend_extension | NULL | Solo en php.ini | |
zend_extension_debug | NULL | Solo en php.ini | |
zend_extension_debug_ts | NULL | Solo en php.ini | |
zend_extension_ts | NULL | Solo en php.ini | |
cgi.check_shebang_line | "1" | PHP_INI_SYSTEM | Disponible desde PHP 5.2.0. |
cgi.fix_pathinfo | "1" | PHP_INI_SYSTEM | Disponible desde PHP 4.3.0. PHP_INI_ALL antes de PHP 5.2.1. |
cgi.force_redirect | "1" | PHP_INI_SYSTEM | Disponible desde PHP 4.2.0. PHP_INI_ALL antes de PHP 5.2.1. |
cgi.redirect_status_env | NULL | PHP_INI_SYSTEM | Disponible desde PHP 4.2.0. PHP_INI_ALL antes de PHP 5.2.1. |
fastcgi.impersonate | "0" | PHP_INI_SYSTEM | Disponible desde PHP 4.3.0. PHP_INI_ALL antes de PHP 5.2.1. |
fastcgi.logging | "1" | PHP_INI_SYSTEM | Disponible desde PHP 4.3.0. PHP_INI_ALL antes de PHP 5.2.1. |
cgi.rfc2616_headers | "0" | PHP_INI_ALL | Disponible desde PHP 4.3.0. |
He aquí una breve explicación de las directivas de configuración.
Especifica la lista de directorios donde las funciones require(), include(), fopen(), file(), readfile() y file_get_contents() buscan por ficheros. El formato es como la variable de sistema PATH variable de entorno: lista de directorios separados por dos puntos en Unix o separados por punto y coma en Windows.
PHP busca en cada entrada del include path cuando está buscando ficheros a incluir. Primero buscará en la primera ruta, y si no lo encuentra ahí, buscará en la siguiente, hasta que encuentre el fichero o devuelva un warning o un error. Quizá quiera modificar su include path en tiempo de ejecucción usando set_include_path().
Example #1 include_path de Unix
include_path=".:/php/includes"
Example #2 include_path de Windows
include_path=".;c:\php\includes"
El uso de . en el include path permite el uso de includes relativos y significa el directorio actual. De todas formas, es más eficiente usar explícitamente el include './file' que hacer a PHP comprobar el directorio actual para cada include.
Límite de ficheros que pueden ser abiertos por PHP en el especificado árbol del directorio, incluyendo el fichero así mismo. Esta directiva NO es afectada cuando Safe Mode está On o Off.
Cuando un script intenta abrir un fichero, con por ejemplo, fopen() o gzopen(), se comprueba la localización del fichero. Si el fichero está fuera del directorio especificado, PHP se negará abrirlo. Todos los enlaces simbólicos son resueltos, entonces no es posible omitir esta restricción usando enlaces simbólicos. Si el fichero no existe el enlace simbólico no podrá ser resuelto y el nombre del fichero es comparado o resuelto a open_basedir .
El valor especial .
indica que el directorio de trabajo del script será usado como directorio base.
Esto es, sin embargo, un poco peligroso ya que el directorio del script puede
ser fácilmente cambiado con la función chdir().
En httpd.conf, open_basedir se puede desactivar (ej. para algunos virtual hosts) de la misma manera que cualquier otra directiva de configuración con "php_admin_value open_basedir none".
Bajo Windows, separe los directorios con punto y coma. En cualquier otro sistema, separe los directorios con dos puntos. Como en el módulo Apache, las rutas de los directorios principales de open_basedir heredan automáticamente.
La restricción especificada en open_basedir es realmente un comodín, no el nombre de un directorio. Esto quiere decir que "open_basedir = /dir/incl" también tiene acceso a "/dir/include" si existe. Cuando quiera restringir el acceso a un único directorio, finalícelo con una barra. Por ejemplo: open_basedir = /dir/incl/
Por defecto permite a abrir cualquier tipo de ficheros.
Note:
A partir de PHP 5.3.0 open_basedir puede ser usado en tiempo de ejecucción. Esto significa que si open_basedir está establecido como /www/ en php.ini un script puede cambiar la configuración en tiempo de ejecucción a /www/tmp/ con ini_set()
"Directorio raíz" de PHP en el servidor. En uso solamente si no está vacío. Si PHP está configurado con safe mode, ningún otro fichero fuera de este directorio será servido. Si PHP no se compiló con FORCE_REDIRECT, debería establecer doc_root si está usando PHP como GCI bajo cualquier tipo de servidor (que no sea IIS). La alternativa es usar cgi.force_redirect vea la configuración a continuación.
Nombre del directorio base usado en el directorio principal del usuario para ficheros PHP, por ejemplo public_html
En que directorio PHP debería buscar por extensiones que se pueden cargar dinámicamente. Vea también: enable_dl, y dl().
Que extensiones se cargarán dinámicamente cuando se inicie PHP.
Ruta absolute donde cargar una extensión dinámica Zend (por ejemplo APD) se cargará cuando se inicie PHP.
Variante de zend_extension para extensiones compiladas con información de depuración
Variante de zend_extension para extensiones compiladas con información de depuración y peticiones seguras.
Variant of zend_extension para extensiones compiladas con peticiones seguras.
Controla cuando CGI PHP comprueba por la línea que empieza por #! (shebang) en el inicio del script que se está ejecutando. Esta línea quizá se necesita si el script soporta los dos modos, stand-alone y vía PHP CGI. El modo PHP en CGI omite esta línea e ignora el contenido de esta directiva si está activada.
Proporciona soporte real PATH_INFO/ PATH_TRANSLATED para CGI. Anteriormente PHP estaba establecido de PATH_TRANSLATED a SCRIPT_FILENAME y PATH_INFO no funcionaba de la manera que lo hace ahora. Para más información sobre PATH_INFO vea las especificaciones CGI. Si establece el valor de esta directiva a 1, PHP CGI arreglará sus rutas conforme a las especificaciones. Si lo establece a 0, funcionará como anteriormente. Por defecto es 0. Debería usar en sus scripts SCRIPT_FILENAME en lugar de PATH_TRANSLATED.
cgi.force_redirect es necesario para proporcionar seguridad al ejecutar PHP bajo CGI en la mayoría de servidores. Si no lo define, PHP activa esta variable por defecto. Puede cambiarlo a off asumiendo su propio riesgo.
Note:
Para usuarios de Windows: Puede desactivar esta opción con seguridad para IIS, de hecho, debería hacerlo. Para que funcione OmniHTTPD or Xitami debe desactivar esta directiva.
Si cgi.force_redirect está on, y no lo está ejecutando bajo servidores web Apache o Netscape (iPlanet), quizá necesite definir una variable de entorno que PHP buscará para saber si es está bien continuar con la ejecucción.
Note:
Definir esta variable quizá causa problemas de seguridad, no la cambie a no ser que sepa lo que está haciendo.
FastCGI bajo IIS (en SO basados en WINNT) soporta la habilidad de impersonar tokens de seguridad de la llamada del cliente. Esto permite a IIS definir la seguridad en la que la petición funciona. mod_fastgci bajo Apache actualmente no soporta esta característica (17/03/2002) Establézcalo a 1 si funciona bajo IIS. Por defecto es cero.
Activa SAPI logging cuando se usa FastCGI. Por defecto logging está activado.
Dice a PHP que tipo de encabezados usar cuando envía el código de respuesta HTTP. Si está establecido a 0, PHP envía el estado: Encabezado soportado por Apache y otros servidores web. Cuando esta opción está establecida a 1, PHP enviará encabezados compatible con » RFC 2616. Déjelo a 0 a no ser que sepa lo que está haciendo.
Nombre | Valor predeterminado | Se puede cambiar en | Lista de cambios |
---|---|---|---|
file_uploads | "1" | PHP_INI_SYSTEM | PHP_INI_ALL en PHP <= 4.2.3. Disponible desde PHP 4.0.3. |
upload_tmp_dir | NULL | PHP_INI_SYSTEM | |
upload_max_filesize | "2M" | PHP_INI_PERDIR | PHP_INI_ALL en PHP <= 4.2.3. |
max_file_uploads | 20 | PHP_INI_SYSTEM | Disponible desde PHP 5.2.12. |
He aquí una breve explicación de las directivas de configuración.
Cuando o no activar HTTPS file uploads. Ver también upload_max_filesize, upload_tmp_dir, y post_max_size directivas.
Cuando se usa un número entero, el valor del mismo es medido en bytes. También se puede usar la notación reducida tal como se describe en esta FAQ.Directorio temporal usado para guardar los ficheros durante el proceso de subida. Debe tener permisos de escritura para el usuario que está ejecutando PHP. Si no está especificado PHP usará el predeterminado del sistema.
El tamaño máximo a subir un fichero.
Cuando se usa un número entero, el valor del mismo es medido en bytes. También se puede usar la notación reducida tal como se describe en esta FAQ.Número máximo de ficheros permitidos para subir simulatáneamente.
Nombre | Valor predeterminado | Cambiable en | Lista de cambios |
---|---|---|---|
sql.safe_mode | "0" | PHP_INI_SYSTEM |
He aquí una breve explicación de las directivas de configuración.
Si está activado, las funciones de conexión a bases de datos usarán la configuración por defecto en lugar de los párametros definidos. Para ver cuales son los valores por defecto vea la documentación de las funciones para la base de datos en concreto.