From 4e83c23187d46d3f3fad38d8b2d3a207fa2d826d Mon Sep 17 00:00:00 2001 From: Philippe Delente Date: Fri, 7 Feb 2025 14:49:18 +0100 Subject: [PATCH] add file untranslate page in appendice folder --- appendices/ini.core.xml | 1554 ++++++++++++++++++++++++ appendices/ini.list.xml | 841 +++++++++++++ appendices/migration82.xml | 52 + appendices/migration83.xml | 54 + appendices/migration84.xml | 57 + appendices/reserved.constants.core.xml | 673 ++++++++++ language/types.xml | 2 +- 7 files changed, 3232 insertions(+), 1 deletion(-) create mode 100644 appendices/ini.core.xml create mode 100644 appendices/ini.list.xml create mode 100644 appendices/migration82.xml create mode 100644 appendices/migration83.xml create mode 100644 appendices/migration84.xml create mode 100644 appendices/reserved.constants.core.xml diff --git a/appendices/ini.core.xml b/appendices/ini.core.xml new file mode 100644 index 000000000..c20ba173a --- /dev/null +++ b/appendices/ini.core.xml @@ -0,0 +1,1554 @@ + + + + +
+ Descripción de las directivas internas del &php.ini; + + Esta lista incluye las directivas internas del &php.ini; que puede + definir para personalizar su configuración de PHP. Las directivas + gestionadas por las extensiones se enumeran y detallan en las páginas de + documentación respectivas de las extensiones; la información sobre las + directivas en las sesiones, por ejemplo, se puede encontrar en la + página de documentación de las sesiones. + + + + Los valores predeterminados enumerados aquí se utilizarán cuando &php.ini; + no se carga; los valores de los archivos &php.ini; en entornos de producción + y desarrollo pueden variar. + + + +
+ Opciones del lenguaje + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + short_open_tag + "1" + INI_ALL + + + + precision + "14" + INI_ALL + + + + serialize_precision + "-1" + INI_ALL + + Antes de PHP 7.1.0, el valor predeterminado era 17. + + + + disable_functions + "" + INI_SYSTEM solo + + + + disable_classes + "" + &php.ini; solo + + + + exit_on_timeout + "" + INI_ALL + + + + expose_php + "1" + &php.ini; solo + + + + hard_timeout + "2" + INI_SYSTEM + Disponible a partir de 7.1.0. + + + zend.exception_ignore_args + "0" + INI_ALL + Disponible a partir de 7.4.0 + + + zend.multibyte + "0" + INI_ALL + + + + zend.script_encoding + NULL + INI_ALL + + + + zend.detect-unicode + NULL + INI_ALL + + + + zend.signal_check + "0" + INI_SYSTEM + + + + zend.assertions + "1" + INI_ALL con restricciones + + + + zend.exception_string_param_max_len + "15" + INI_ALL + Disponible a partir de PHP 8.0.0. + + + +
+ + + &ini.descriptions.title; + + + + + + short_open_tag + bool + + + + Define si las etiquetas cortas de apertura de PHP (<? ?>) están permitidas o no. Si desea usar PHP con XML, debe desactivar esta opción de configuración para poder usar <?xml ?>. De lo contrario, puede escribirlo usando PHP, por ejemplo: <?php echo '<?xml version="1.0">'; ?>. Si esta opción está desactivada, debe usar la versión larga de las etiquetas de apertura de PHP (<?php ?>). + + + + Esta directiva no afecta el uso de <?=, que siempre está disponible. + + + + + + + + precision + int + + + + El número de decimales significativos que se mostrarán en los números de coma flotante. -1 significa que se utilizará el mejor algoritmo para redondear este número. + + + + + + + serialize_precision + int + + + + El número de dígitos significativos conservados al serializar números de coma flotante. -1 significa que se utilizará el mejor algoritmo para redondear este número. + + + + + + + expose_php + bool + + + + Expone a todos los clientes el hecho de que PHP está instalado en el servidor. Esto incluye la versión de PHP en los encabezados HTTP de la respuesta (X-Powered-By: PHP/5.3.7). + + + + + + + disable_functions + string + + + + Esta directiva le permite deshabilitar ciertas funciones. Toma una lista de nombres de funciones separados por comas. + + + Solo las funciones internas pueden deshabilitarse usando esta directiva. Las funciones definidas por el usuario no se ven afectadas. + + + Esta directiva debe definirse en el &php.ini;. Por ejemplo, no puede definirse en el archivo &httpd.conf;. + + + + + + + disable_classes + string + + + + Esta directiva le permite deshabilitar ciertas clases. Toma una lista de nombres de clases separados por comas. + + + Esta directiva debe definirse en el &php.ini;. Por ejemplo, no puede definirse en el archivo &httpd.conf;. + + + + + + + zend.assertions + int + + + + Cuando se establece en 1, se generará el código de aserción (en modo de desarrollo). Cuando se establece en 0, se generará el código de aserción, pero se ignorará (no se ejecutará) durante la ejecución. Cuando se establece en -1, el código de aserción no se generará, haciendo que las aserciones sean completamente neutrales (en modo de producción). + + + + Si un proceso se inicia en modo de producción, zend.assertions no puede cambiarse en tiempo de ejecución, ya que el código para las aserciones no se ha generado. + + + Si un proceso se inicia en modo de desarrollo, zend.assertions no puede establecerse en -1 en tiempo de ejecución. + + + + + + + + zend.exception_string_param_max_len + int + + + + La longitud máxima de los argumentos de función de cadenas en los trazas de pila convertidos en cadenas. Debe estar en el rango entre "0" y "1000000". + + + + + + + hard_timeout + int + + + + Cuando se alcanza el tiempo de espera establecido en max_execution_time, el tiempo de ejecución de PHP destruirá los recursos de manera elegante. Si algo se bloquea cuando esto ocurre, se activará el tiempo de espera forzado durante el número de segundos establecido. Cuando se alcanza el tiempo de espera forzado, PHP saldrá de manera no elegante. Cuando se establece en 0, el tiempo de espera forzado nunca se activará. + + + Cuando PHP finaliza con un tiempo de espera forzado, se verá algo así: + + + + + + + + + zend.exception_ignore_args + bool + + + + Excluye los argumentos en los trazas de pila generados desde las excepciones. + + + + + + + zend.multibyte + bool + + + + Activa el análisis léxico de archivos PHP en codificaciones multibyte. Activar zend.multibyte es necesario para usar ciertas codificaciones de caracteres como SJIS, BIG5, etc., que contienen caracteres especiales en codificación multibyte. Las codificaciones compatibles con ISO-8859-1 como UTF-8, EUC, etc., no requieren esta opción. + + + Activar zend.multibyte requiere la extensión mbstring. + + + + + + + zend.script_encoding + string + + + + Este valor se usará a menos que una directiva declare(encoding=...) aparezca en la parte superior del script. Cuando se usa una codificación incompatible con ISO-8859-1, se deben usar las opciones zend.multibyte y zend.script_encoding. + + + Las cadenas de caracteres se convertirán desde zend.script_encoding a mbstring.internal_encoding, como si se hubiera llamado a la función mb_convert_encoding. + + + + + + + zend.detect_unicode + bool + + + + Verifica el BOM (Byte Order Mark) y mira si el archivo contiene caracteres multibyte válidos. Esta detección se realiza antes de que se ejecute la función __halt_compiler. Disponible solo en modo multibyte de Zend. + + + + + + + zend.signal_check + bool + + + + Verifica si se está utilizando un manejador de señales de reemplazo al detenerse. + + + + + + + exit_on_timeout + bool + + + + Esta es una directiva solo para Apache1 mod_php que fuerza a los hilos de Apache a salir si ocurre un tiempo de espera de expiración de PHP. Tal expiración produce internamente una llamada a longjmp() en Apache1 que puede dejar algunas extensiones en un estado no consistente. Al terminar el proceso, todos los bloqueos y la memoria se limpiarán. + + + + + + +
+ +
+ Límite de recursos + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + memory_limit + "128M" + INI_ALL + + + + +
+ + + &ini.descriptions.title; + + + + + + memory_limit + int + + + + Esta opción determina la memoria límite, en bytes, que un script está permitido asignar. Esto evita que un script mal codificado use toda la memoria. Tenga en cuenta que para no tener ningún límite, debe establecer esta directiva en -1. + + + &ini.shorthandbytes; + + + + + + + Véase también: max_execution_time. + +
+ +
+ Ajuste de rendimiento + + + Ajuste de rendimiento + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + realpath_cache_size + "4M" + INI_SYSTEM + Antes de PHP 7.0.16 y 7.1.2, el valor predeterminado era "16K" + + + realpath_cache_ttl + "120" + INI_SYSTEM + + + + +
+ + + Usar open_basedir desactivará la caché realpath. + + + + &ini.descriptions.title; + + + + + realpath_cache_size + int + + + + Determina el tamaño de la caché de realpath que usará PHP. Este valor debería aumentarse en sistemas donde PHP abre varios archivos, para reflejar la cantidad de operaciones realizadas en los archivos. + + + El tamaño representa el número total de bytes en la cadena almacenada del camino, más el tamaño de los datos asociados con la entrada de la caché. Esto significa que para almacenar caminos largos en la caché, el tamaño de la caché debe ser lo suficientemente grande. Este valor no controla directamente el número de caminos distintos que pueden almacenarse en caché. + + + El tamaño necesario para los datos de la entrada de la caché depende del sistema. + + + + + + realpath_cache_ttl + int + + + + Tiempo (en segundos) durante el cual persiste la información de la caché de realpath para un archivo o directorio dado. Para sistemas con archivos que cambian poco, considere aumentar este valor. + + + + + +
+ +
+ Manejo de datos + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + arg_separator.output + "&" + INI_ALL + + + + arg_separator.input + "&" + INI_PERDIR + + + + variables_order + "EGPCS" + INI_PERDIR + + + + request_order + "" + INI_SYSTEM|INI_PERDIR + + + + auto_globals_jit + "1" + INI_PERDIR + + + + register_argc_argv + "1" + INI_PERDIR + + + + enable_post_data_reading + "1" + INI_PERDIR + + + + post_max_size + "8M" + INI_PERDIR + + + + auto_prepend_file + NULL + INI_PERDIR + + + + auto_append_file + NULL + INI_PERDIR + + + + default_mimetype + "text/html" + INI_ALL + + + + default_charset + "UTF-8" + INI_ALL + + + + input_encoding + "" + INI_ALL + + + + output_encoding + "" + INI_ALL + + + + internal_encoding + "" + INI_ALL + + + + +
+ + + &ini.descriptions.title; + + + + + + arg_separator.output + string + + + + El separador utilizado cuando PHP genera las URL para separar los argumentos. + + + + + + + arg_separator.input + string + + + + Lista de separadores utilizados por PHP para analizar las URL entrantes y deducir los valores. + + + + ¡Cada carácter de esta directiva se considera un separador! + + + + + + + + variables_order + string + + + + Define el orden de análisis de las variables EGPCS (Environment, Get, Post, Cookie y Server). Por ejemplo, si variables_order se establece en "SP", entonces PHP creará &link.superglobals; $_SERVER y $_POST, pero no creará $_ENV, $_GET y $_COOKIE. Establecer este orden en "" significa que ninguna &link.superglobals; se definirá. + + + + En las SAPIs CGI y FastCGI, $_SERVER también se llena con valores del entorno; S siempre es equivalente a ES en lo que respecta a la posición de E en cualquier otro lugar en esta directiva. + + + + + El contenido y el orden de $_REQUEST también se ven afectados por esta directiva. + + + + + + + + request_order + string + + + + Esta directiva describe el orden en el que PHP coloca las variables GET, POST y Cookie en la matriz _REQUEST. La colocación se realiza de izquierda a derecha, con los valores más recientes sobrescribiendo los valores más antiguos. + + + Si esta directiva no está definida, se utiliza variables_order para el contenido de $_REQUEST. + + + Tenga en cuenta que los archivos php.ini de la distribución predeterminada no contienen 'C' para las cookies, por razones de seguridad. + + + + + + + auto_globals_jit + bool + + + + Cuando esta directiva está activada, las variables SERVER, REQUEST y ENV se crean cuando se usan: solo si es necesario. Si estas variables no se usan en un script, el script verá un aumento en el rendimiento. + + + + El uso de las variables SERVER, REQUEST y ENV se verifica durante la compilación. Por lo tanto, usarlas con, por ejemplo, variables dinámicas no provocará su inicialización. + + + + + + + + register_argc_argv + bool + + + + Le dice a PHP si debe declarar o no las variables argv y argc (que contendrán la información GET). + + + Véase también las líneas de comando. + + + + + + + enable_post_data_reading + bool + + + + Si se desactiva esta opción, las variables $_POST y $_FILES no se poblarán. La única forma de leer los datos transmitidos será usando el manejador de flujo php://input. Esto puede ser interesante para las solicitudes a través de un proxy o para analizar los datos transmitidos directamente en la memoria. + + + + + + + post_max_size + int + + + + Define el tamaño máximo de los datos recibidos por el método POST. Esta opción también afecta a los archivos cargados. Para cargar archivos grandes, este valor debe ser mayor que el valor de upload_max_filesize. + + + De manera general, memory_limit debe ser mayor que post_max_size. + + + &ini.shorthandbytes; + + + Si el tamaño de los datos recibidos por el método POST es mayor que post_max_size, las superglobales $_POST y $_FILES estarán vacías. Esto se puede monitorear de diferentes formas, por ejemplo, pasando una variable $_GET al script que procesa los datos, es decir, <form action="edit.php?processed=1">, y luego verificar si $_GET['processed'] está definido. + + + + + PHP permite palabras clave para los bytes, incluyendo K (kilo), M (mega) y G (giga). PHP realiza la conversión automáticamente si usa estas palabras clave. Tenga cuidado de no exceder el límite de un entero con signo de 32 bits (si usa las versiones de 32 bits), en cuyo caso su script fallará. + + + + + + Historial para <literal>post_max_size</literal> + + + + &Version; + &Description; + + + + + 5.3.4 + + post_max_size = 0 no desactivará el límite cuando el tipo de contenido es application/x-www-form-urlencoded o no está registrado con PHP. + + + + 5.3.2 , 5.2.12 + + Permite un tamaño de envío ilimitado estableciendo post_max_size en 0. + + + + +
+ + + + + + + auto_prepend_file + string + + + + Especifica el nombre de un archivo que se recorrerá automáticamente antes del archivo principal. Este archivo se incluye como si se hubiera incluido con la función require, por lo que se usa include_path. + + + El valor especial none desactiva la adición automática. + + + + + + + auto_append_file + string + + + + Especifica el nombre del archivo que se recorrerá automáticamente después del archivo principal. Este archivo se incluye como si se hubiera incluido con la función require, por lo que se usa include_path. + + + El valor especial none desactiva la adición automática. + + + Si el script termina con la función exit, no se realizará la adición automática. + + + + + + + + + default_mimetype + string + + + + Por defecto, PHP enviará el tipo de medio usando el encabezado Content-Type. Para desactivar esto, deje este valor vacío. + + + El tipo de medio predeterminado en PHP es text/html. + + + + + + + default_charset + string + + + + "UTF-8" es el valor predeterminado y se usa como el conjunto de caracteres predeterminado para las funciones y módulos. PHP siempre enviará un conjunto de caracteres predeterminado para htmlentities, html_entity_decode y htmlspecialchars si se omite el parámetro encoding. El valor de default_charset también se usará para establecer el conjunto de caracteres predeterminado para las funciones iconv si las opciones de configuración iconv.input_encoding, iconv.output_encoding y iconv.internal_encoding no están definidas, y para las funciones mbstring si las opciones de configuración mbstring.http_input, mbstring.http_output y mbstring.internal_encoding no están definidas. + + + Todas las versiones de PHP usarán este valor como el conjunto de caracteres predeterminado en el encabezado Content-Type predeterminado enviado por PHP si el encabezado no se sobrescribe a través de una llamada a la función header. + + + No se recomienda establecer un default_charset en un valor vacío. + + + + + + + input_encoding + string + + + + Este parámetro se usa para los módulos multibyte como mbstring e iconv. Vacío por defecto. + + + + + + + output_encoding + string + + + + Este parámetro se usa para los módulos multibyte como mbstring e iconv. Vacío por defecto. + + + + + + + internal_encoding + string + + + + Este parámetro se usa para los módulos multibyte como mbstring e iconv. Vacío por defecto. Si está vacío, se usa default_charset. + + + + + + +
+ +
+ Rutas y directorios + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + include_path + ".;/ruta/a/php/pear" + INI_ALL + + + + open_basedir + NULL + INI_ALL + + + + doc_root + NULL + INI_SYSTEM + + + + user_dir + NULL + INI_SYSTEM + + + + user_ini.cache_ttl + "300" + INI_SYSTEM + + + + user_ini.filename + ".user.ini" + INI_SYSTEM + + + + extension_dir + "/ruta/a/php" + INI_SYSTEM + + + + extension + NULL + &php.ini; solo + + + + zend_extension + NULL + &php.ini; solo + + + + cgi.check_shebang_line + "1" + INI_SYSTEM + + + + cgi.discard_path + "0" + INI_SYSTEM + + + + cgi.fix_pathinfo + "1" + INI_SYSTEM + + + + cgi.force_redirect + "1" + INI_SYSTEM + + + + cgi.nph + "0" + INI_SYSTEM + + + + cgi.redirect_status_env + NULL + INI_SYSTEM + + + + cgi.rfc2616_headers + "0" + INI_ALL + + + + fastcgi.impersonate + "0" + INI_SYSTEM + + + + fastcgi.logging + "1" + INI_SYSTEM + + + + +
+ + + &ini.descriptions.title; + + + + + + include_path + string + + + + Especifica una lista de directorios donde las funciones require, include, fopen, file, readfile y file_get_contents buscarán los archivos. El formato es idéntico a la variable de entorno del sistema PATH: una lista de directorios separados por dos puntos (:) en Unix o por un punto y coma (;) en Windows. + + + PHP considera cada entrada del camino de inclusión por separado al buscar archivos para incluir. Verificará el primer camino y, si no encuentra el archivo, verificará el siguiente camino, hasta encontrar el archivo para incluir o devolver una alerta de tipo E_WARNING o de tipo E_ERROR usando la función set_include_path. + + + + include_path en Unix + + + + + + + + include_path en Windows + + + + + + + El uso de un punto (.) en el camino de inclusión le permite hacer inclusiones relativas al directorio actual. Sin embargo, es más eficiente incluir explícitamente un archivo con include './file' que pedirle a PHP que verifique el directorio actual en cada inclusión. + + + + Las variables ENV también están disponibles en los archivos .ini. Por lo tanto, es posible hacer referencia al directorio home usando la sintaxis ${LOGIN} y ${USER}. + + + Las variables de entorno pueden variar según las APIs del servidor, así como según los entornos. + + + + + include_path en Unix usando la variable de entorno ${USER} + + + + + + + + + + + open_basedir + string + + + + Limita los archivos que pueden ser accedidos por PHP a una estructura de directorios específica, incluyendo el archivo mismo. + + + Cuando un script intenta acceder a un archivo con, por ejemplo, la función include o la función fopen, la ruta al archivo se analiza. Cuando el archivo se encuentra fuera de la estructura de directorios especificada, PHP se negará a acceder a él. Todos los enlaces simbólicos se resuelven, por lo que no es posible eludir esta restricción con un enlace simbólico. Si el archivo no existe, entonces el enlace simbólico no se puede resolver y el nombre del archivo se compara con . + + + La opción puede afectar más que las funciones del sistema de archivos; por ejemplo, si MySQL está configurado para usar el controlador mysqlnd, LOAD DATA INFILE se verá afectado por la opción . La mayoría de las extensiones de PHP usan la opción open_basedir de esta manera. + + + El valor especial . indica que se usará el directorio actual del script como directorio base. Sin embargo, esto es ligeramente peligroso en el sentido de que el directorio actual puede cambiarse fácilmente con la función chdir. + + + En el archivo httpd.conf, puede desactivarse (por ejemplo, para algunos hosts virtuales) de la misma manera que cualquier directiva de configuración con "php_admin_value open_basedir none". + + + En Windows, separe los directorios con un punto y coma. En todos los demás sistemas, separe los directorios con dos puntos. Al usar Apache como módulo, los caminos de desde los directorios padres ahora se heredan automáticamente. + + + La restricción especificada con es un nombre de directorio, no un prefijo. + + + De manera predeterminada, todos los archivos pueden abrirse. + + + + puede afinarse en el momento de la ejecución. Esto significa que si se establece en /www/ en el archivo &php.ini;, un script puede afinar la configuración en /www/tmp/ en el momento de la ejecución usando la función ini_set. Al recorrer varios directorios, puede usar la constante PATH_SEPARATOR según el sistema operativo. + + + A partir de PHP 8.3.0, ya no acepta rutas que contengan el directorio padre (..) cuando se establece en tiempo de ejecución. + + + + + Usar open_basedir establecerá realpath_cache_size a 0 y, por lo tanto, desactivará la caché realpath. + + + + + open_basedir es solo una medida de protección adicional y no es de ninguna manera exhaustiva, y no debe dependerse de ella cuando se necesita seguridad. + + + + + + + + doc_root + string + + + + El directorio raíz de PHP en el servidor. Solo se usa si no está vacío. Si PHP no se compiló con FORCE_REDIRECT, debe definir el doc_root si usa PHP como CGI bajo cualquier servidor web (distinto de IIS). Alternativamente, puede usar la configuración cgi.force_redirect. + + + + + + + user_ini.cache_ttl + int + + + + + + + + + + user_ini.filename + string + + + + + + + + + + user_dir + string + + + + El nombre base del directorio usado en un directorio de usuario para los archivos PHP, por ejemplo, public_html. + + + + + + + extension_dir + string + + + + Especifica el directorio donde PHP debe buscar extensiones externas para cargar. Se recomienda especificar una ruta absoluta. Véase también enable_dl y dl. + + + + + + + extension + string + + + + Qué extensiones deben cargarse dinámicamente al iniciar PHP. + + + + + + + zend_extension + string + + + + Nombre de la extensión Zend cargable dinámicamente (por ejemplo, XDebug) que se cargará al iniciar PHP. + + + + + + + cgi.check_shebang_line + bool + + + + Controla si PHP CGI verifica la línea que comienza con #! (shebang) en la parte superior del script ejecutado. Esta línea es necesaria si el script está destinado a ejecutarse de forma independiente y a través de un PHP CGI. PHP en modo CGI no lee esta línea y omite su contenido si esta directiva está activa. + + + + + + + cgi.discard_path + bool + + + + Si está activado, el binario PHP CGI puede colocarse fuera del árbol web de manera segura y las personas no podrán eludir la seguridad .htaccess. + + + + + + + cgi.fix_pathinfo + bool + + + + Proporciona un real PATH_INFO/PATH_TRANSLATED para CGI. El comportamiento anterior de PHP era establecer PATH_TRANSLATED en SCRIPT_FILENAME y no llenar PATH_INFO. Para obtener más información sobre PATH_INFO, consulte las especificaciones CGI. Si se establece en 1, PHP CGI corregirá este camino según las especificaciones. Si se establece en 0, PHP aplicará el comportamiento anterior. De manera predeterminada, esta directiva está activada. Debe modificar sus scripts para usar SCRIPT_FILENAME en lugar de PATH_TRANSLATED. + + + + + + + cgi.force_redirect + bool + + + + cgi.force_redirect es necesario por razones de seguridad al usar PHP en modo CGI bajo la mayoría de los servidores web. Si no lo establece, PHP lo activará automáticamente de manera predeterminada. Puede desactivarlo bajo su propio riesgo. + + + + Usuarios de Windows: Al usar IIS, esta opción debe desactivarse; lo mismo ocurre con OmniHTTPD y Xitami. + + + + + + + + cgi.nph + bool + + + + Si cgi.nph está activado, forzará a CGI a enviar siempre el estado: 200 con cada solicitud. + + + + + + + cgi.redirect_status_env + string + + + + Si cgi.force_redirect está activado y no está ejecutando un servidor web Apache o Netscape (iPlanet), debería definir un nombre de variable de entorno que PHP usará para verificar si todo está correcto para continuar la ejecución. + + + + Definir esta variable puede tener consecuencias de seguridad. Saber lo que hace antes de hacerlo. + + + + + + + + cgi.rfc2616_headers + bool + + + + Le dice a PHP qué tipo de encabezado usar al enviar el código de respuesta HTTP. Si está desactivado, PHP enviará un encabezado "Status:" (RFC 3875) que es compatible con Apache y otros servidores web. Cuando está activado, PHP enviará un encabezado que cumple con la especificación RFC 2616. + + + Si esta opción está activada y está ejecutando PHP en un entorno CGI (por ejemplo, PHP-FPM), no debe usar los encabezados de respuesta HTTP "status" RFC 2616, sino usar el equivalente RFC 3875, es decir, en lugar del encabezado ("HTTP/1.0 404 Not found"), use ("Status: 404 Not Found"). + + + Deje este parámetro desactivado a menos que sepa exactamente lo que está haciendo. + + + + + + + fastcgi.impersonate + bool + + + + FastCGI en IIS (en sistemas operativos basados en WINNT) admite la capacidad de determinar la marca de seguridad del cliente que llama. Esto permite que IIS establezca el contexto de seguridad en el que se ejecutará la solicitud. mod_fastcgi en Apache no admite actualmente esta funcionalidad (03/17/2002). Active si se ejecuta en IIS. De manera predeterminada, está desactivado. + + + + + + + fastcgi.logging + bool + + + + Activa el registro SAPI con FastCGI. Activado de manera predeterminada. + + + + + +
+ +
+ Carga de archivos + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + file_uploads + "1" + INI_SYSTEM + + + + upload_tmp_dir + NULL + INI_SYSTEM + + + + max_input_nesting_level + 64 + INI_PERDIR + + + + max_input_vars + 1000 + INI_PERDIR + + + + upload_max_filesize + "2M" + INI_PERDIR + + + + max_file_uploads + 20 + INI_PERDIR + + + + +
+ + + &ini.descriptions.title; + + + + + + file_uploads + bool + + + + Permite o no la carga de archivos por HTTP. Véase también las directivas upload_max_filesize, upload_tmp_dir y post_max_size. + + + + + + + upload_tmp_dir + string + + + + El directorio temporal usado para almacenar archivos durante la carga. El usuario bajo el cual se ejecuta PHP debe tener permisos de escritura en este directorio. Si no se especifica, PHP usará el directorio temporal predeterminado del sistema. + + + Si el directorio especificado aquí no es accesible en escritura, PHP recurrirá al directorio temporal predeterminado del sistema. Si open_basedir está activado, entonces el directorio temporal predeterminado del sistema debe estar permitido para que la carga de archivos funcione. + + + + + + + upload_max_filesize + int + + + + El tamaño máximo en bytes de un archivo subido. + + + post_max_size debe ser mayor que este valor. + + + &ini.shorthandbytes; + + + + + + + max_file_uploads + int + + + + El número máximo de archivos que pueden enviarse simultáneamente. Los campos de carga que se dejan vacíos al enviar no se cuentan en el cálculo de este límite. + + + + + +
+ +
+ SQL general + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + sql.safe_mode + "0" + INI_SYSTEM + Eliminado a partir de PHP 7.2.0 + + + +
+ + + &ini.descriptions.title; + + + + + + sql.safe_mode + bool + + + + Si está activado, las funciones de conexión a la base de datos que especifican valores predeterminados usarán estos valores en lugar de los argumentos proporcionados. Para los valores predeterminados, consulte la documentación de las funciones de conexión para la base de datos correspondiente. + + + + ¡Esta funcionalidad ha sido ELIMINADA a partir de PHP 7.2.0! + + + + + + +
+ +
+ Específico de Windows + + + Opciones de configuración específicas de Windows + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + windows.show_crt_warning + "0" + INI_ALL + + + + +
+ + + &ini.descriptions.title; + + + + + + windows.show_crt_warning + bool + + + + Esta directiva muestra las advertencias de CRT de Windows cuando está activada. + + + + + +
+ +
+ + diff --git a/appendices/ini.list.xml b/appendices/ini.list.xml new file mode 100644 index 000000000..18d8a1c86 --- /dev/null +++ b/appendices/ini.list.xml @@ -0,0 +1,841 @@ + + + +
+ Lista de directivas del &php.ini; + + Esta lista incluye las directivas del &php.ini; que pueden ser utilizadas + para configurar PHP. + + + La columna "&Changeable;" muestra los modos que determinan cuándo y dónde se puede definir una directiva. Ver la sección sobre los + valores del modo modificable + para sus definiciones. + + + + Opciones de configuración + + + + &Name; + &Default; + &Changeable; + &Changelog; + + + + + allow_url_fopen + "1" + INI_SYSTEM + + + + allow_url_include + "0" + INI_SYSTEM + Obsoleto a partir de PHP 7.4.0. + + + arg_separator.input + "&" + INI_PERDIR + + + + arg_separator.output + "&" + INI_ALL + + + + assert.active + "1" + INI_ALL + + + + assert.bail + "0" + INI_ALL + + + + assert.callback + &null; + INI_ALL + + + + assert.exception + "0" + INI_ALL + + + + assert.quiet_eval + "0" + INI_ALL + Eliminado a partir de PHP 8.0.0. + + + assert.warning + "1" + INI_ALL + + + + auto_append_file + &null; + INI_PERDIR + + + + auto_detect_line_endings + "0" + INI_ALL + + + + auto_globals_jit + "1" + INI_PERDIR + + + + auto_prepend_file + &null; + INI_PERDIR + + + + + browscap + &null; + INI_SYSTEM + + + + cgi.check_shebang_line + "1" + INI_SYSTEM + + + + cgi.discard_path + "0" + INI_SYSTEM + + + + cgi.fix_pathinfo + "1" + INI_SYSTEM + + + + cgi.force_redirect + "1" + INI_SYSTEM + + + + cgi.nph + "0" + INI_ALL + + + + cgi.redirect_status_env + &null; + INI_SYSTEM + + + + cgi.rfc2616_headers + "0" + INI_ALL + + + + child_terminate + "0" + INI_ALL + + + + + + + + + + default_charset + "UTF-8" + INI_ALL + Por defecto "UTF-8". + + + input_encoding + "" + INI_ALL + + + + output_encoding + "" + INI_ALL + + + + internal_encoding + "" + INI_ALL + + + + default_mimetype + "text/html" + INI_ALL + + + + default_socket_timeout + "60" + INI_ALL + + + + disable_classes + "" + &php.ini; solo + + + + disable_functions + "" + &php.ini; solo + + + + display_errors + "1" + INI_ALL + + + + display_startup_errors + "1" + INI_ALL + + Anterior a PHP 8.0.0, el valor predeterminado era "0". + + + + docref_ext + "" + INI_ALL + + + + docref_root + "" + INI_ALL + + + + doc_root + &null; + INI_SYSTEM + + + + enable_dl + "1" + INI_SYSTEM + &removed.php.future; + + + enable_post_data_reading + On + INI_PERDIR + + + + engine + "1" + INI_ALL + + + + error_append_string + &null; + INI_ALL + + + + error_log + &null; + INI_ALL + + + + error_log_mode + 0o644 + INI_ALL + Disponible a partir de PHP 8.2.0 + + + error_prepend_string + &null; + INI_ALL + + + + error_reporting + &null; + INI_ALL + + + + + exit_on_timeout + "" + INI_ALL + + + + + expose_php + "1" + &php.ini; solo + + + + extension + &null; + &php.ini; solo + + + + extension_dir + "/path/to/php" + INI_SYSTEM + + + + fastcgi.impersonate + "0" + INI_SYSTEM + + + + fastcgi.logging + "1" + INI_SYSTEM + + + + file_uploads + "1" + INI_SYSTEM + + + + + from + "" + INI_ALL + + + + + + hard_timeout + "2" + INI_SYSTEM + Disponible a partir de 7.1.0. + + + highlight.comment + "#FF8000" + INI_ALL + + + + highlight.default + "#0000BB" + INI_ALL + + + + highlight.html + "#000000" + INI_ALL + + + + highlight.keyword + "#007700" + INI_ALL + + + + highlight.string + "#DD0000" + INI_ALL + + + + html_errors + "1" + INI_ALL + + + + + + + ignore_repeated_errors + "0" + INI_ALL + + + + ignore_repeated_source + "0" + INI_ALL + + + + ignore_user_abort + "0" + INI_ALL + + + + implicit_flush + "0" + INI_ALL + + + + include_path + ".:/path/to/php/pear" + INI_ALL + + + + + last_modified + "0" + INI_ALL + + + + + log_errors + "0" + INI_ALL + + + + log_errors_max_len + "1024" + INI_ALL + + + + mail.add_x_header + "0" + INI_PERDIR + + + + mail.force_extra_parameters + &null; + &php.ini; solo + + + + mail.log + "" + INI_PERDIR + + + + max_execution_time + "30" + INI_ALL + + + + max_input_nesting_level + "64" + INI_PERDIR + + + + max_input_vars + 1000 + INI_PERDIR + + + + max_input_time + "-1" + INI_PERDIR + + + + + + + memory_limit + "128M" + INI_ALL + + + + + + + + + + open_basedir + &null; + INI_ALL + + + + output_buffering + "0" + INI_PERDIR + + + + output_handler + &null; + INI_PERDIR + + + + + + + + + post_max_size + "8M" + INI_PERDIR + + + + precision + "14" + INI_ALL + + + + realpath_cache_size + "16K" + INI_SYSTEM + + + + realpath_cache_ttl + "120" + INI_SYSTEM + + + + register_argc_argv + "1" + INI_PERDIR + + + + report_memleaks + "1" + INI_ALL + + + + report_zend_debug + "1" + INI_ALL + + + + request_order + "" + INI_PERDIR + + + + + sendmail_from + &null; + INI_ALL + + + + sendmail_path + "/usr/sbin/sendmail -t -i" + INI_SYSTEM + + + + serialize_precision + "-1" + INI_ALL + + Anterior a PHP 7.1.0, el valor predeterminado era 17. + + + + + short_open_tag + "1" + INI_PERDIR + + + + SMTP + "localhost" + INI_ALL + + + + smtp_port + "25" + INI_ALL + + + + + sql.safe_mode + "0" + INI_SYSTEM + Eliminado a partir de PHP 7.2.0 + + + + syslog.facility + "LOG_USER" + INI_SYSTEM + Disponible a partir de PHP 7.3.0. + + + syslog.filter + "no-ctrl" + INI_ALL + Disponible a partir de PHP 7.3.0. + + + syslog.ident + "php" + INI_SYSTEM + Disponible a partir de PHP 7.3.0. + + + sys_temp_dir + "" + INI_SYSTEM + + + + + + track_errors + "0" + INI_ALL + Obsoleto a partir de PHP 7.2.0, eliminado a partir de PHP 8.0.0. + + + + uploadprogress.file.filename_template + "/tmp/upt_%s.txt" + INI_ALL + + + + upload_max_filesize + "2M" + INI_PERDIR + + + + max_file_uploads + 20 + INI_SYSTEM + + + + upload_tmp_dir + &null; + INI_SYSTEM + + + + url_rewriter.hosts + "" + INI_ALL + Disponible a partir de PHP 7.1.0. + + + url_rewriter.tags + "form=" + INI_ALL + Anterior a PHP 7.1.0, el valor predeterminado era "a=href,area=href,frame=src,form=,fieldset=". + + + user_agent + &null; + INI_ALL + + + + user_dir + &null; + INI_SYSTEM + + + + user_ini.cache_ttl + "300" + INI_SYSTEM + + + + user_ini.filename + ".user.ini" + INI_SYSTEM + + + + + variables_order + "EGPCS" + INI_PERDIR + + + + windows.show_crt_warning + "0" + INI_ALL + + + + xbithack + "0" + INI_ALL + + + + xmlrpc_errors + "0" + INI_SYSTEM + + + + xmlrpc_error_number + "0" + INI_ALL + + + + yaz.keepalive + "120" + INI_ALL + + + + yaz.log_mask + &null; + INI_ALL + Disponible a partir de yaz 1.0.3. + + + zend.assertions + "1" + INI_ALL + + + + zend.detect_unicode + "1" + INI_ALL + + + + zend.enable_gc + "1" + INI_ALL + + + + zend.max_allowed_stack_size + "0" + INI_SYSTEM + Disponible a partir de PHP 8.3.0 + + + fiber.stack_size + + INI_ALL + Disponible a partir de PHP 8.1.0 + + + zend.multibyte + "0" + INI_PERDIR + + + + zend.script_encoding + &null; + INI_ALL + + + + zend.signal_check + "0" + INI_SYSTEM + + + + zend_extension + &null; + &php.ini; solo + + + + + +
+ +
+ + diff --git a/appendices/migration82.xml b/appendices/migration82.xml new file mode 100644 index 000000000..0eca2f37c --- /dev/null +++ b/appendices/migration82.xml @@ -0,0 +1,52 @@ + + + + + Migración de PHP 8.1.x a PHP 8.2.x + + + Esta nueva versión menor aporta un cierto número de + nuevas funcionalidades y + algunas incompatibilidades + que deberían ser probadas antes de cambiar de versión de PHP en entornos de producción. + + + + &manual.migration.seealso; + 7.1.x, + 7.2.x, + 7.3.x, + 7.4.x, + 8.0.x, + 8.1.x. + + + &appendices.migration82.new-features; + &appendices.migration82.new-functions; + &appendices.migration82.constants; + &appendices.migration82.incompatible; + &appendices.migration82.deprecated; + &appendices.migration82.other-changes; + &appendices.migration82.windows-support; + + + diff --git a/appendices/migration83.xml b/appendices/migration83.xml new file mode 100644 index 000000000..44746aa80 --- /dev/null +++ b/appendices/migration83.xml @@ -0,0 +1,54 @@ + + + + + Migración de PHP 8.2.x a PHP 8.3.x + + + Esta nueva versión menor aporta un cierto número de + nuevas funcionalidades y + algunas incompatibilidades + que deberían ser probadas antes de cambiar de versión de PHP en entornos de producción. + + + + &manual.migration.seealso; + 7.1.x, + 7.2.x, + 7.3.x, + 7.4.x, + 8.0.x, + 8.1.x, + 8.2.x. + + + &appendices.migration83.new-features; + &appendices.migration83.new-classes; + &appendices.migration83.new-functions; + &appendices.migration83.constants; + &appendices.migration83.incompatible; + &appendices.migration83.deprecated; + &appendices.migration83.other-changes; + &appendices.migration83.windows-support; + + + diff --git a/appendices/migration84.xml b/appendices/migration84.xml new file mode 100644 index 000000000..fd8390dd2 --- /dev/null +++ b/appendices/migration84.xml @@ -0,0 +1,57 @@ + + + + + Migración de PHP 8.3.x a PHP 8.4.x + + + Esta nueva versión menor aporta un cierto número de + nuevas funcionalidades y + algunas incompatibilidades + que deberían ser probadas antes de cambiar de versión de PHP en + entornos de producción. + + + + &manual.migration.seealso; + 7.1.x, + 7.2.x, + 7.3.x, + 7.4.x, + 8.0.x, + 8.1.x, + 8.2.x, + 8.3.x. + + + &appendices.migration84.new-features; + &appendices.migration84.new-classes; + &appendices.migration84.new-functions; + &appendices.migration84.constants; + &appendices.migration84.incompatible; + &appendices.migration84.deprecated; + &appendices.migration84.removed-extensions; + &appendices.migration84.other-changes; + &appendices.migration84.windows-support; + + + diff --git a/appendices/reserved.constants.core.xml b/appendices/reserved.constants.core.xml new file mode 100644 index 000000000..b55afa9f0 --- /dev/null +++ b/appendices/reserved.constants.core.xml @@ -0,0 +1,673 @@ + + + + + Constantes predefinidas + + Estas constantes están definidas por el núcleo de PHP. Esto incluye PHP, + el motor Zend y los módulos SAPI. + + + + + PHP_VERSION + (string) + + + + La versión actual de PHP como una cadena en la notación "mayor.menor.lanzamiento[extra]". + + + + + + PHP_MAJOR_VERSION + (int) + + + + La versión mayor actual de PHP como una cadena (por ejemplo, int(5) desde la versión "5.2.7-extra"). + + + + + + PHP_MINOR_VERSION + (int) + + + + La versión menor actual de PHP como una cadena (por ejemplo, int(2) desde la versión "5.2.7-extra"). + + + + + + PHP_RELEASE_VERSION + (int) + + + + La versión de lanzamiento actual de PHP como una cadena (por ejemplo, int(7) desde la versión "5.2.7-extra"). + + + + + + PHP_VERSION_ID + (int) + + + + La versión actual de PHP como un entero, útil para la comparación de versiones (por ejemplo, int(50207) desde la versión "5.2.7-extra"). + + + + + + PHP_EXTRA_VERSION + (string) + + + + La versión "extra" actual de PHP como una cadena (por ejemplo, '-extra' desde la versión "5.2.7-extra"). Ocasionalmente utilizada por los empaquetadores de distribuciones para indicar una versión de paquete. + + + + + + ZEND_THREAD_SAFE + (bool) + + + + Indica si la versión actual de PHP se compiló con soporte para subprocesos. + + + + + + ZEND_DEBUG_BUILD + (bool) + + + + Indica si la versión actual de PHP es una compilación de depuración. + + + + + + PHP_ZTS + (bool) + &Alias; ZEND_THREAD_SAFE + + + + Indica si la versión actual de PHP se compiló con soporte para subprocesos. + + + + + + PHP_DEBUG + (bool) + &Alias; ZEND_DEBUG_BUILD + + + + Indica si la versión actual de PHP es una compilación de depuración. + + + + + + DEBUG_BACKTRACE_PROVIDE_OBJECT + (int) + + + + Reemplaza el índice "object". + + + + + + DEBUG_BACKTRACE_IGNORE_ARGS + (int) + + + + No incluye información de argumentos para las funciones en la traza de la pila. + + + + + + PHP_MAXPATHLEN + (int) + + + + La longitud máxima de los nombres de archivo (incluyendo el camino) soportada por este binario de PHP. + + + + + + PHP_OS + (string) + + + + El sistema operativo para el que se compiló PHP. + + + + + + PHP_OS_FAMILY + (string) + + + + La familia del sistema operativo para el que se compiló PHP. Uno de 'Windows', 'BSD', 'Darwin', 'Solaris', 'Linux' o 'Unknown'. Disponible desde PHP 7.2.0. + + + + + + PHP_SAPI + (string) + + + + La API del servidor para este binario de PHP. Véase también php_sapi_name. + + + + + + PHP_EOL + (string) + + + + El carácter de nueva línea correcto para esta plataforma. + + + + + + PHP_INT_MAX + (int) + + + + El entero más grande soportado por este binario de PHP. Habitualmente, int(2147483647) en sistemas de 32 bits y int(9223372036854775807) en sistemas de 64 bits. + + + + + + PHP_INT_MIN + (int) + + + + El entero más pequeño soportado en esta versión de PHP. Habitualmente, int(-2147483648) en sistemas de 32 bits y int(-9223372036854775808) en sistemas de 64 bits. Habitualmente, PHP_INT_MIN === ~PHP_INT_MAX. + + + + + + PHP_INT_SIZE + (int) + + + + El tamaño de un entero, en bytes, en esta versión de PHP. + + + + + + PHP_FLOAT_DIG + (int) + + + + Número de dígitos decimales de precisión en un número de punto flotante y devueltos sin pérdida de precisión. Disponible desde PHP 7.2.0. + + + + + + PHP_FLOAT_EPSILON + (float) + + + + El número de punto flotante positivo más pequeño x, de modo que x + 1.0 != 1.0. Disponible desde PHP 7.2.0. + + + + + + PHP_FLOAT_MIN + (float) + + + + El número de punto flotante positivo más pequeño. Si necesita la representación negativa más pequeña de un número de punto flotante, use - PHP_FLOAT_MAX. Disponible desde PHP 7.2.0. + + + + + + PHP_FLOAT_MAX + (float) + + + + El número de punto flotante positivo más grande. Disponible desde PHP 7.2.0. + + + + + + DEFAULT_INCLUDE_PATH + (string) + + + + + + + + + + PEAR_INSTALL_DIR + (string) + + + + + + + + + + PEAR_EXTENSION_DIR + (string) + + + + + + + + + + PHP_EXTENSION_DIR + (string) + + + + El directorio predeterminado donde buscar extensiones cargables dinámicamente (a menos que se sobrescriba con extension_dir). Por defecto PHP_PREFIX (o PHP_PREFIX . "\\ext" en Windows). + + + + + + PHP_PREFIX + (string) + + + + El valor de que se definió durante la configuración. En Windows, es el valor de que se definió durante la configuración. + + + + + + PHP_BINDIR + (string) + + + + El valor de que se definió durante la configuración. En Windows, es el valor de que se definió durante la configuración. + + + + + + PHP_SBINDIR + (string) + + + + El valor definido por durante la configuración. En Windows, es el valor definido por durante la configuración. Disponible desde PHP 8.4.0. + + + + + + PHP_BINARY + (string) + + + + Especifica el camino hacia el binario de PHP durante la ejecución del script. + + + + + + PHP_MANDIR + (string) + + + + Especifica el camino de instalación de las páginas man. + + + + + + PHP_LIBDIR + (string) + + + + + + + + + + PHP_DATADIR + (string) + + + + + + + + + + PHP_SYSCONFDIR + (string) + + + + + + + + + + PHP_LOCALSTATEDIR + (string) + + + + + + + + + + PHP_CONFIG_FILE_PATH + (string) + + + + + + + + + + PHP_CONFIG_FILE_SCAN_DIR + (string) + + + + + + + + + + PHP_SHLIB_SUFFIX + (string) + + + + El sufijo de la plataforma de compilación para bibliotecas compartidas, como "so" (en sistemas Unix) o "dll" (en Windows). + + + + + + PHP_FD_SETSIZE + (int) + + + + Número máximo de descriptores de archivo para seleccionar funciones de sistema. Disponible desde PHP 7.1.0. + + + + + + E_ERROR + (int) + + + E_WARNING + (int) + + + E_PARSE + (int) + + + E_NOTICE + (int) + + + E_CORE_ERROR + (int) + + + E_CORE_WARNING + (int) + + + E_COMPILE_ERROR + (int) + + + E_COMPILE_WARNING + (int) + + + E_USER_ERROR + (int) + + + E_USER_WARNING + (int) + + + E_USER_NOTICE + (int) + + + E_RECOVERABLE_ERROR + (int) + + + E_DEPRECATED + (int) + + + E_USER_DEPRECATED + (int) + + + E_ALL + (int) + + + E_STRICT + (int) + + + + Constantes de informe de errores. + + + + + + __COMPILER_HALT_OFFSET__ + (int) + + + + + + + + + + &true; + (bool) + + + + Ver Booleanos. + + + + + + &false; + (bool) + + + + Ver Booleanos. + + + + + + &null; + (null) + + + + Ver Null. + + + + + + PHP_WINDOWS_EVENT_CTRL_C + (int) + + + + Evento de Windows + CTRL + C + . Disponible desde PHP 7.4.0 (solo Windows). + + + + + + PHP_WINDOWS_EVENT_CTRL_BREAK + (int) + + + + Evento de Windows + CTRL + BREAK + . Disponible desde PHP 7.4.0 (solo Windows). + + + + + + PHP_CLI_PROCESS_TITLE + (bool) + + + + Indica si el establecimiento y la recuperación del título del proceso están disponibles. Disponible solo en la API CLI. + + + + + + STDERR + (resource) + + + + Un flujo ya abierto hacia stderr. Disponible solo en la API CLI. + + + + + + STDIN + (resource) + + + + Un flujo ya abierto hacia stdin. Disponible solo en la API CLI. + + + + + + STDOUT + (resource) + + + + Un flujo ya abierto hacia stdout. Disponible solo en la API CLI. + + + + + + Véase también las + constantes mágicas. + + + diff --git a/language/types.xml b/language/types.xml index 0776ecbc0..7e0f0df66 100644 --- a/language/types.xml +++ b/language/types.xml @@ -110,7 +110,7 @@ if (is_string($un_bool)) { &language.types.void; &language.types.never; &language.types.relative-class-types; - &language.types.value; + &language.types.singleton; &language.types.iterable; &language.types.declarations; &language.types.type-juggling;