From a87b8e4fec4cb98dc3d06a08dd6d3aa34738771f Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 25 Aug 2026 10:28:41 +0200 Subject: [PATCH 1/2] docs(install): modernize Apache httpd 2.x installation guide - Rename title to "Apache httpd 2.x" - Replace warn.apache2.compat with a PHP-FPM recommendation warning - Drop Apache 2.2 and PHP 7 references (EOL content) - Update listitem 3 to mention prefork requirement and PHP-FPM alternative - Remove worker MPM section; replace with MPM Compatibility note - Multiple para-to-simpara conversions throughout - Fix FilesMatch regex for phtml files - Remove "available in Apache 2.4.4" from FallbackResource simpara - Remove orphaned warn.apache2.compat entity from language-snippets.ent - Update EN-Revision to fd1f9d85122cd85854f4afdf5a57ab7da38ff69c --- install/unix/apache2.xml | 254 ++++++++++++++++++++------------------- language-snippets.ent | 5 - 2 files changed, 132 insertions(+), 127 deletions(-) diff --git a/install/unix/apache2.xml b/install/unix/apache2.xml index feff07cad..80603c0b2 100644 --- a/install/unix/apache2.xml +++ b/install/unix/apache2.xml @@ -1,46 +1,71 @@ - + - Apache 2.x en sistemas Unix - + Apache httpd 2.x en sistemas Unix + Esta sección contiene las notas y consejos de instalación de PHP con el servidor - Apache 2.x en sistemas Unix. - - - &warn.apache2.compat; - - + Apache HTTP Server 2.x en sistemas Linux y similares a Unix. + + + + Usar PHP-FPM en su lugar + + No utilice mod_php para nuevas + instalaciones. Las instrucciones de esta página se mantienen + como referencia histórica y para los casos excepcionales en que se requiere + incrustar PHP directamente en el proceso de Apache httpd. + + + Para todos los despliegues modernos, use + PHP-FPM (FastCGI Process Manager) + con el módulo mod_proxy_fcgi de Apache httpd. PHP-FPM + ofrece una mejor gestión de recursos, aislamiento de procesos, reinicio + independiente de PHP sin reiniciar Apache httpd, y compatibilidad con el + MPM event de Apache httpd (el predeterminado desde + Apache httpd 2.4). Las principales distribuciones Linux lo incluyen como + configuración por defecto. + + + El método mod_php incrusta PHP directamente en cada + proceso worker de Apache httpd. A menos que PHP se compile con seguridad + de hilos (--enable-zts), mod_php + requiere el MPM prefork, lo que limita significativamente + la concurrencia. Si se procede con mod_php, se deben + comprender plenamente las implicaciones de rendimiento y seguridad. + + + + La Documentación Apache - es la mejor fuente de información sobre el servidor Apache 2.x. - La mayoría de la información sobre las opciones de instalación de Apache + es la mejor fuente de información sobre el servidor Apache httpd 2.x. + La mayoría de la información sobre las opciones de instalación de Apache httpd puede encontrarse allí. - + - - La versión más reciente del servidor HTTP Apache puede obtenerse + + La versión más reciente de Apache httpd puede obtenerse desde la página de descarga de Apache, y una versión adaptada de PHP desde los enlaces anteriores. - Esta guía cubre únicamente las bases de funcionamiento de Apache 2.x con PHP. + Esta guía cubre únicamente las bases de funcionamiento de Apache httpd 2.x con PHP. Para más información, leer la documentación Apache. Los números de versión se omiten aquí, para asegurarse de que las instrucciones no sean incorrectas. En los ejemplos a continuación, 'NN' deberá ser reemplazado - por la versión específica de Apache a utilizar. - + por la versión específica de Apache httpd a utilizar. + - - Actualmente hay 2 versiones de Apache 2.x - 2.4 y 2.2. - Hay varias razones para elegir una sobre la otra; sin embargo, la versión - 2.4 es actualmente la última versión disponible y también la que recomendamos. Sin embargo, las instrucciones - contenidas en esta guía deberían funcionar para la versión 2.4 así como para la versión 2.2. Nota: Apache httpd 2.2 está oficialmente en Fin de Vida, no habrá más desarrollo ni parches para esta versión. - + + Estas instrucciones se aplican a Apache httpd 2.4, que es la única rama de + versión compatible de Apache httpd. Las versiones anteriores (2.2 y anteriores) + están en fin de vida y no deben utilizarse. + - - Descargue el servidor HTTP Apache desde el sitio anterior y descomprímalo : - + + Descargue Apache httpd desde el sitio anterior y descomprímalo: + @@ -52,9 +77,9 @@ tar -xzf httpd-2.x.NN.tar.gz - - De la misma manera, descargue y descomprima las fuentes de PHP : - + + De la misma manera, descargue y descomprima las fuentes de PHP: + @@ -66,16 +91,22 @@ tar -xzf php-NN.tar.gz - - Compile e instale Apache. Consulte la documentación sobre la instalación - de Apache para más detalles sobre la compilación de este software. - + + Compile e instale Apache httpd. Consulte la documentación sobre la instalación + de Apache httpd para más detalles sobre la compilación de este software. + Tenga en cuenta que mod_php requiere el MPM + prefork a menos que PHP sea compilado con seguridad de + hilos (--enable-zts). Si tiene intención de usar PHP-FPM + (recomendado), puede usar el MPM event predeterminado y + pasar directamente a las + instrucciones de instalación de PHP-FPM. + @@ -85,10 +116,10 @@ make install - Ahora que se tiene Apache 2.x.NN disponible bajo /usr/local/apache2, - configúrelo con soporte para la carga de módulos, así como el - MPM prefork estándar. Para probar la instalación, utilice el procedimiento - normal para iniciar el servidor Apache, es decir: + Ahora que se tiene Apache httpd 2.x.NN disponible bajo /usr/local/apache2, + configurado con soporte para la carga de módulos y el MPM prefork. + Para probar la instalación, utilice el procedimiento + normal para iniciar el servidor Apache httpd, es decir: @@ -97,7 +128,7 @@ make install ]]> - y deténgalo para continuar con la configuración de PHP : + y deténgalo para continuar con la configuración de PHP: @@ -111,19 +142,20 @@ make install - + Ahora, configure y compile PHP. Será en este momento cuando se podrá personalizar PHP con las diversas opciones disponibles, como la lista de extensiones a activar. Ejecute ./configure --help para obtener la lista de opciones disponibles. En nuestro ejemplo, realizaremos - una configuración simple, con Apache 2 y soporte MySQL. - + una configuración simple, con Apache httpd y soporte MySQL. + - - Si se ha construido Apache desde las fuentes, tal como se describe anteriormente, + + Si se ha construido Apache httpd desde las fuentes, tal como se describe anteriormente, el siguiente ejemplo debería ser correcto en cuanto a las rutas hacia apxs, pero si - se ha instalado Apache de otra manera, se deberán tener en cuenta las especificidades y ajustar las rutas apxs en consecuencia. Tenga en cuenta que, según las distribuciones, podría ser necesario renombrar apxs a apxs2. - + se ha instalado Apache httpd de otra manera, se deberán tener en cuenta las especificidades y ajustar las rutas apxs en consecuencia. Tenga en cuenta que, según las distribuciones, podría ser necesario renombrar apxs a apxs2. + + - + Si se decide modificar las opciones de configuración después de la instalación, se deberán ejecutar nuevamente las etapas configure, make y make install. Entonces solo se necesitará reiniciar Apache para que el nuevo módulo surta efecto. - Una recompilación de Apache no es necesaria. - + Una recompilación de Apache httpd no es necesaria. + Tenga en cuenta que, salvo indicaciones contrarias, make install también instalará @@ -153,9 +185,9 @@ make install - + Configurar el archivo php.ini - + @@ -165,47 +197,33 @@ cp php.ini-development /usr/local/lib/php.ini - + Se debe editar el archivo .ini para definir las opciones PHP. Si se prefiere colocar php.ini en otro directorio, utilice la opción --with-config-file-path=/some/path en la etapa 5. - + - + Si se elige el archivo php.ini-production, asegúrese de leer la lista de modificaciones correspondiente ya que puede afectar considerablemente la forma en que PHP funcionará. - + - + Edite el archivo httpd.conf para cargar el módulo PHP. La ruta especificada - a la derecha de la cadena LoadModule, debe corresponder a la ruta del sistema del módulo - PHP. make install anterior debería haber realizado esta operación + a la derecha de la cadena LoadModule, debe corresponder a la ruta del sistema del módulo + PHP. El comando make install anterior debería haber realizado esta operación por usted, pero una simple verificación permitirá asegurarse. - + - - Para PHP 8: - - - - - - - Para PHP 7: - - - @@ -214,16 +232,16 @@ LoadModule php7_module modules/libphp5.so - - Indique a Apache que analice ciertas extensiones como scripts PHP. - Por ejemplo, deje que Apache pase a PHP los archivos cuya extensión es + + Indique a Apache httpd que analice ciertas extensiones como scripts PHP. + Por ejemplo, deje que Apache httpd pase a PHP los archivos cuya extensión es .php. En lugar de utilizar solo la directiva AddType de Apache, se desea evitar cualquier riesgo potencialmente peligroso, cuando se descarga y crea un archivo como exploit.php.jpg, de ejecución PHP. Utilizando este ejemplo, se puede tener cualquier extensión analizada por PHP. Se ha añadido .php para el ejemplo. - + @@ -235,17 +253,17 @@ LoadModule php7_module modules/libphp5.so - + O, si se desea permitir que los archivos .php, .php2, .php3, .php4, .php5, .php6, y .phtml sean - analizados por PHP, pero nada más, se utilizará esto : - + analizados por PHP, pero nada más, se utilizará esto: + + SetHandler application/x-httpd-php ]]> @@ -255,7 +273,7 @@ LoadModule php7_module modules/libphp5.so Y para permitir que los archivos .phps sean manejados por el filtro del código fuente de PHP, y así, ser mostrados como código fuente con coloración - sintáctica, utilice esto : + sintáctica, utilice esto: @@ -272,7 +290,6 @@ LoadModule php7_module modules/libphp5.so Para permitir el uso de un archivo PHP como manejador por defecto cuando no se encuentra ningún otro manejador, por ejemplo al utilizar un motor de enrutamiento, se puede usar la directiva FallbackResource. - Está disponible en Apache 2.4.4 y versiones posteriores. @@ -300,7 +317,7 @@ FallbackResource /index.php mod_rewrite puede ser utilizado para permitir que cualquier archivo .php - sea mostrado como código fuente con coloración sintáctica, sin necesidad de renombrarlo o copiarlo con una extensión .phps. : + sea mostrado como código fuente con coloración sintáctica, sin necesidad de renombrarlo o copiarlo con una extensión .phps: @@ -321,9 +338,9 @@ RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source] - - Utilice el procedimiento normal para iniciar el servidor Apache, es decir: - + + Utilice el procedimiento normal para iniciar el servidor Apache httpd, es decir: + @@ -346,47 +363,40 @@ service httpd restart - + Si se han seguido los pasos anteriores, ahora se tiene un servidor web - Apache2 funcional con soporte PHP como módulo SAPI. + Apache httpd funcional con soporte PHP como módulo SAPI. Por supuesto, hay una multitud de otras opciones de configuración disponibles - con Apache y PHP. Para más información, introduzca el comando + con Apache httpd y PHP. Para más información, introduzca el comando ./configure --help en el árbol de fuentes correspondiente. - - - Apache puede ser compilado en modo multithread, seleccionando - el MPM worker, en lugar del estándar - MPM prefork. Esto se hace añadiendo la siguiente opción al argumento de ./configure, en la etapa 3 anterior: - - - - - - - - Esto no debería emprenderse sin ser consciente de las consecuencias, - y teniendo al menos una justa comprensión de lo que implica. - La documentación de Apache sobre - MPM-Modules - proporcionará información importante que permitirá tomar - la decisión. - + + - - La FAQ Apache - MultiViews trata sobre el uso de MultiViews con PHP. - + Compatibilidad MPM + + A menos que PHP sea compilado con Zend Thread Safety + (--enable-zts), mod_php requiere + el MPM prefork. + Para más información, leer la entrada FAQ correspondiente sobre el uso de + Apache httpd con un MPM + multi-hilo. + + + + La mayoría de los paquetes de distribución de + mod_php no se compilan con ZTS, por lo que + prefork suele ser necesario. Si se necesita un MPM + multi-hilo (recomendado para mejor rendimiento bajo carga), use + PHP-FPM con + mod_proxy_fcgi en su lugar. + + - - Para compilar una versión multithread de Apache, el sistema de destino - debe soportar threads. En este caso, PHP también debe ser construido - con Zend Thread Safety (ZTS). Bajo esta configuración, no todas las extensiones - estarán disponibles. Recomendamos compilar Apache con el - prefork MPM-Module. - + + La FAQ Apache + MultiViews trata sobre el uso de MultiViews con PHP. + -No se recomienda el uso de PHP -en un entorno thread MPM, con Apache 2. Utilice el modo prefork MPM, que es -el MPM predeterminado para Apache 2.0 y 2.2. Para -saber por qué, lea la entrada de la FAQ correspondiente a la -utilización de Apache 2 en un entorno thread MPM.'> Las versiones provenientes de terceros son consideradas no oficiales y From 894bfbb67b2445bdb766f25db2628ec7c5e82375 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 25 Aug 2026 11:05:36 +0200 Subject: [PATCH 2/2] [Sync EN] remove unused entities --- language-snippets.ent | 33 +-------------------------------- 1 file changed, 1 insertion(+), 32 deletions(-) diff --git a/language-snippets.ent b/language-snippets.ent index 5605b7f44..4d22670c3 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -1,13 +1,9 @@ - + - -4.2.0El generador -de números aleatorios se inicializa automáticamente.'> - 8.4.0 @@ -90,10 +86,6 @@ Windows no soportan ciertos caracteres en los nombres de fichero, como punto final no son soportados. A diferencia de algunas herramientas de extracción, este método no reemplaza estos caracteres con un guión bajo, sino que falla al extraer tales ficheros.'> - En lugar de un nombre de función, un -array que contenga una referencia de objeto y un nombre de método también puede ser -utilizado.'> - Las devoluciónes de llamada registradas con funciones como call_user_func y call_user_func_array no serán llamadas si una excepción no es interceptada cuando ha sido lanzada en una función de devolución de llamada anterior.'> @@ -242,11 +234,6 @@ Esta extensión debe ser utilizada bajo su propio riesgo.'> - Esta funcionalidad está -OBSOLETA a partir de PHP 5.3.0 y ha sido ELIMINADA -a partir de PHP 5.4.0.'> - Esta funcionalidad está OBSOLETA a partir de PHP 5.6.0. Depender de esta funcionalidad @@ -269,11 +256,6 @@ xmlns="http://docbook.org/ns/docbook"> Esta función está ELIMINADA a partir de PHP 7.2.0. Depender de esta función está altamente desaconsejado.'> - Esta funcionalidad está -OBSOLETA a partir de PHP 7.2.0. Depender de esta funcionalidad -está altamente desaconsejado.'> - Esta funcionalidad está OBSOLETA a partir de PHP 7.2.0, y ELIMINADA a partir de PHP 8.0.0. Depender de esta funcionalidad @@ -360,9 +342,6 @@ ciertamente eliminada Este alias está OBSOLETO a partir de PHP 5.4.0. Depender de este alias está fuertemente desaconsejado.'> - Este alias está -OBSOLETO a partir de PHP 5.4.0. y ha sido ELIMINADO a partir de PHP 7.0.0.'> - Esta función ha sido ELIMINADA a partir de PHP 7.0.0.'> @@ -475,10 +454,6 @@ evitar su uso. Resultado del ejemplo anterior en PHP 5:'> -Resultado del ejemplo anterior en PHP 5.3:'> - -Resultado del ejemplo anterior en PHP 5.4:'> - Resultado del ejemplo anterior en PHP 5.5:'> Resultado del ejemplo anterior en PHP 5.6:'> @@ -1434,10 +1409,6 @@ zonas horarias pueden ser eliminadas de la base de datos IANA de zonas horarias Cada llamada a una función de fecha/hora generará un diagnóstico de tipo E_WARNING si la zona horaria no es válida. Ver también date_default_timezone_set'> -5.1.0 -Emite un mensaje de tipo E_STRICT y E_NOTICE -durante errores de zonas horarias.'> - timestamp El parámetro opcional timestamp es un @@ -1959,8 +1930,6 @@ o argumentos nombrados. Esta extensión no define ninguna directiva de configuración.'> -Esta extensión no define ningún recurso.'> -Esta extensión no define ninguna constante.'> No se requiere ninguna biblioteca externa para compilar esta extensión.'> No hay instalación necesaria para usar estas funciones, son parte del núcleo de PHP.'>