Apache 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.

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 puede encontrarse allí.

La versión más reciente del servidor HTTP Apache 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. 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.

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.

1. Descargue el servidor HTTP Apache desde el sitio anterior y descomprímalo :

   tar -xzf httpd-2.x.NN.tar.gz
   

2. De la misma manera, descargue y descomprima las fuentes de PHP :

   tar -xzf php-NN.tar.gz
   

3. 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.

   cd httpd-2_x_NN
   ./configure --enable-so
   make
   make install
   

4. 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:

   /usr/local/apache2/bin/apachectl start
   

   y deténgalo para continuar con la configuración de PHP :

   /usr/local/apache2/bin/apachectl stop
   

5. 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. En nuestro ejemplo, realizaremos una configuración simple, con Apache 2 y soporte MySQL.

   Si se ha construido Apache desde las fuentes, tal como se describe anteriormente, el siguiente ejemplo debería ser correcto en cuanto a las rutas hacia los 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.

   cd ../php-NN
   ./configure --with-apxs2=/usr/local/apache2/bin/apxs --with-pdo-mysql
   make
   make install
   

   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.

   Tenga en cuenta que, salvo indicaciones contrarias, la etapa "make install" también instalará PEAR, así como diversas herramientas PHP como phpsize, PHP CLI y mucho más.

6. Configurar el archivo php.ini

   cp php.ini-development /usr/local/lib/php.ini
   

   Se debe editar el archivo .ini para definir las opciones PHP. Si se prefiere colocar este archivo 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á.

7. 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. La etapa "make install" anterior debería haber realizado esta operación por usted, pero una simple verificación permitirá asegurarse.

   Para PHP 8:

   LoadModule php_module modules/libphp.so

   Para PHP 7:

   LoadModule php7_module modules/libphp5.so

8. Indique a Apache que analice ciertas extensiones como scripts PHP. Por ejemplo, deje que Apache 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.

   <FilesMatch \.php$>
       SetHandler application/x-httpd-php
   </FilesMatch>

   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 :

   <FilesMatch "\.ph(p[2-6]?|tml)$">
       SetHandler application/x-httpd-php
   </FilesMatch>

   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 :

   <FilesMatch "\.phps$">
       SetHandler application/x-httpd-php-source
   </FilesMatch>

   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. :

   RewriteEngine On
   RewriteRule (.*\.php)s$ $1 [H=application/x-httpd-php-source]

   El filtro de código fuente PHP no debería estar activo en sistemas de producción, ya que puede exponer código confidencial o información sensible contenida en el código fuente.

9. Utilice el procedimiento normal para iniciar el servidor Apache, es decir:

   /usr/local/apache2/bin/apachectl start
   

   O

   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. Por supuesto, hay una multitud de otras opciones de configuración disponibles con Apache 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 la comando "./configure", en la etapa 3 anterior :

--with-mpm=worker

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.

Nota:

La FAQ Apache MultiViews trata sobre el uso de MultiViews con PHP.

Nota:

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.