From e5f772f427fee3efecea9219a76349a379404ab9 Mon Sep 17 00:00:00 2001 From: Louis-Arnaud Date: Tue, 15 Sep 2026 09:27:23 +0200 Subject: [PATCH] [Sync-En] opcache: document huge page use by the shared memory segment --- reference/opcache/ini.xml | 53 ++++++++++++++++++++++----------------- 1 file changed, 30 insertions(+), 23 deletions(-) diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml index 7d968a1e1..9f6887a19 100644 --- a/reference/opcache/ini.xml +++ b/reference/opcache/ini.xml @@ -1,5 +1,5 @@ - + &reftitle.runtime; @@ -27,7 +27,7 @@ opcache.enable_cli 0 INI_SYSTEM - Entre PHP 7.1.2 y 7.1.6 inclusive, el valor por omisión era 1 + Entre PHP 7.1.2 y 7.1.6 inclusive, el valor por omisión era 1 opcache.memory_consumption @@ -99,7 +99,7 @@ opcache.optimization_level "0x7FFEBFFF" INI_SYSTEM - Modificado desde 0x7FFFBFFF en PHP 7.3.0 + Modificado desde 0x7FFFBFFF en PHP 7.3.0 opcache.inherited_hack @@ -129,7 +129,7 @@ opcache.consistency_checks 0 INI_ALL - >Desactivado a partir de PHP 8.1.18 y 8.2.5. Eliminado a partir de PHP 8.3.0. + Desactivado a partir de PHP 8.1.18 y 8.2.5. Eliminado a partir de PHP 8.3.0. opcache.force_restart_timeout @@ -171,7 +171,7 @@ opcache.mmap_base &null; INI_SYSTEM - + Solo para Windows. opcache.restrict_api @@ -205,7 +205,7 @@ opcache.file_cache - NULL + &null; INI_SYSTEM @@ -411,6 +411,14 @@ El valor mínimo permisible es "8", que se fuerza si se define un valor más pequeño. + + Cuando el JIT está activado, el segmento de memoria compartida también + contiene el búfer del JIT, por lo que su tamaño total es este valor más + opcache.jit_buffer_size. + OPcache intenta primero asignar el segmento utilizando HUGE PAGES y, + si el sistema operativo no ha reservado suficientes, recurre + silenciosamente a páginas normales. + @@ -442,8 +450,7 @@ números primos { 223, 463, 983, 1979, 3907, 7963, 16229, 32531, 65407, 130987, 262237, 524521, 1048793 } que sea mayor o igual que el valor configurado. El valor mínimo es 200. - El valor máximo es 100000 en PHP < 5.5.6, y 1000000 en versiones - posteriores. + El valor máximo es 1000000. Los valores fuera de este intervalo se ajustan al intervalo permitido. @@ -526,7 +533,7 @@ Si está desactivado, los archivos en caché existentes que usan el mismo include_path serán reutilizados. - También, si un archivo con el mismo nombre está en otro lugar en el + Por lo tanto, si un archivo con el mismo nombre está en otro lugar en el include_path, no será encontrado. @@ -983,6 +990,11 @@ function getA() { return A; } Activa o desactiva la copia de código PHP (segmento de texto) en HUGE PAGES. Esto debería mejorar el rendimiento, pero requiere una configuración adecuada del sistema operativo. + Solo se vuelve a mapear el segmento de texto del binario de PHP; el + segmento de memoria compartida descrito en + opcache.memory_consumption + no se ve afectado por esta directiva. Si el remapeo falla, OPcache emite + un E_WARNING. Disponible en Linux a partir de PHP 7.0.0, y en FreeBSD a partir de PHP 7.4.0. @@ -1021,7 +1033,7 @@ function getA() { return A; } Activa y define el directorio de caché de segundo nivel. Esto debería mejorar el rendimiento cuando la memoria SHM está llena, al reiniciar - el servidor o reinicializar SMH. + el servidor o reinicializar SHM. El valor por omisión "" desactiva el almacenamiento en caché basado en archivos. @@ -1062,7 +1074,7 @@ function getA() { return A; } - Sugiere opcache.file_cache_only=1 para un proceso determinado que ha fallado al + Implica opcache.file_cache_only=1 para un proceso determinado que ha fallado al unirse a la memoria compartida (solo para Windows). Se requiere el caché de archivos activado explícitamente. @@ -1094,8 +1106,8 @@ function getA() { return A; } - Impide las colisiones de nombres en entornos `chroot`. Esto debería - ser activado en todos los entornos `chroot` para impedir el acceso + Impide las colisiones de nombres en entornos chroot. Esto debería + ser activado en todos los entornos chroot para impedir el acceso a archivos fuera del chroot. @@ -1154,9 +1166,6 @@ function getA() { return A; } Para IIS, diferentes grupos de aplicaciones pueden tener su propia instancia OPcache utilizando la variable de entorno APP_POOL_ID como opcache.cache_id. - For IIS, different application pools can have their own OPcache instance - by using the environment variable APP_POOL_ID as - opcache.cache_id. @@ -1168,7 +1177,7 @@ function getA() { return A; } - Para un uso típico, esta opción acepta una de las cuatro siguientes valores string: + Para un uso típico, esta opción acepta uno de los cuatro siguientes valores string: disable: Desactivado completamente, no puede ser activado durante el tiempo de ejecución. @@ -1267,7 +1276,7 @@ function getA() { return A; } - Una máscara de bits que especifica qué salida de depuración de JIT activar + Una máscara de bits que especifica qué salida de depuración de JIT activar. Para los valores posibles, consulte zend_jit.h (ver las definiciones de macro que comienzan con ZEND_JIT_DEBUG). @@ -1313,7 +1322,7 @@ function getA() { return A; } Número máximo de trazas raíz (root traces). La traza raíz es un flujo de ejecución que toma - primero un camino a través del código, que es una unidad de la compilación JIT. JIT no compilara + primero un camino a través del código, que es una unidad de la compilación JIT. JIT no compilará nuevo código si alcanza este límite. @@ -1447,8 +1456,7 @@ function getA() { return A; } - - Número máximo de llamadas recursivas desenrolladas en un bucle. + Número máximo de bucles de llamadas recursivas desenrollados. @@ -1459,8 +1467,7 @@ function getA() { return A; } - - Número máximo de retornos recursivos desenrollados en un bucle. + Número máximo de bucles de retornos recursivos desenrollados.