Documentación Commerce Guía de instalación

[On-Premise]{class="badge informative" title="Solo se aplica a los proyectos locales de Adobe Commerce."}

Instalación de Apache para implementaciones locales apache

Last update: Wed Apr 01 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Temas:
Configuración

Creado para:

Experimentado
Administrador
Desarrollador

Esta guía le explica cómo instalar Apache para Adobe Commerce en implementaciones locales y cómo configurar Apache que Commerce requiere. Incluye requisitos compartidos de Apache y procedimientos específicos del sistema operativo para Ubuntu y CentOS. Adobe recomienda seguir las instrucciones de configuración proporcionadas en esta guía para conservar la funcionalidad y la seguridad de la aplicación de Commerce.

Adobe es compatible con las versiones de Apache enumeradas en requisitos del sistema para su versión de Adobe Commerce. Las versiones compatibles varían según la versión. Apache también requiere una configuración de PHP compatible. Para ver los requisitos de PHP relacionados, consulte Configuración de PHP.

Comience con la sección que coincida con su entorno:

Si Apache ya está instalado, comience con Revisar los requisitos de Apache.
Si necesita instalar o actualizar Apache en Ubuntu, vaya a Instalar o actualizar Apache en Ubuntu.
Si necesita instalar Apache en CentOS, vaya a Instalar Apache en CentOS.

Revise los requisitos de Apache

Complete estos requisitos en cualquier servidor Apache que aloje Adobe Commerce.

Configuración de directivas requeridas

Establezca AllowEncodedSlashes en la configuración del servidor (de forma global) o en las configuraciones del host virtual para evitar descodificar las barras oblicuas codificadas que pueden causar problemas en las direcciones URL. Por ejemplo, al recuperar productos con una barra oblicua en el SKU mediante la API, no desea que se convierta la barra oblicua. El siguiente bloque de ejemplo no está completo y se requieren otras directivas.

<VirtualHost *:443>
  # Allow encoded slashes
  AllowEncodedSlashes NoDecode
</VirtualHost>

Configurar reescrituras y .htaccess apache-rewrites-and-htaccess

Utilice esta sección para habilitar las reescrituras de Apache y configurar el archivo distribuido .htaccess. Adobe Commerce usa las reescrituras del servidor y .htaccess para proporcionar instrucciones a nivel de directorio para Apache.

IMPORTANT

Si no se habilita esta configuración, no se muestran estilos en la tienda o el administrador. También puede impedir que Apache aplique las protecciones de seguridad de Adobe Commerce definidas en .htaccess.

Habilite el módulo de reescritura de Apache:

code language-bash
`a2enmod rewrite`

Habilite la aplicación para utilizar el archivo de configuración distribuido .htaccess.

En Ubuntu, edite /etc/apache2/sites-available/000-default.conf. Para otros diseños de Apache o si se requieren parámetros adicionales, consulte la documentación de Apache y la documentación de control de acceso de Apache.
Agregue o actualice la directiva AllowOverride para el directorio en el que planea instalar Adobe Commerce.

Por ejemplo, si instala Adobe Commerce en el docroot predeterminado, agregue el siguiente bloque a 000-default.conf:

code language-conf
`<Directory "/var/www/html"> AllowOverride All </Directory>`

note note
NOTE
Si ha actualizado desde una versión anterior de Apache, busque primero un bloque `<Directory "/var/www/html">` o `<Directory "/var/www">` existente en `000-default.conf`. Si instala Adobe Commerce en un(a) `docroot` diferente, actualice el bloque `<Directory>` correspondiente para esa ruta.

Reinicie Apache para aplicar los cambios:

code language-bash
`service apache2 restart`

Instalación de los módulos necesarios

Adobe Commerce requiere que se instalen los siguientes módulos Apache:

Verificar que Apache esté instalado

Para comprobar que Apache está instalado y ver la versión actual, introduzca:

apache2 -v

El resultado muestra información similar a la siguiente:

Server version: Apache/<installed-version>
Server built: <build-date>

Si Apache está no instalado, consulte:
- Instalación o actualización de Apache en Ubuntu
- Instalación de Apache en CentOS

Instalación o actualización de Apache en Ubuntu installing-or-upgrading-apache-on-ubuntu

La instalación y configuración de Apache en Ubuntu es un proceso de tres pasos:

Instale el software.
Habilitar reescrituras.
Especifique .htaccess directivas.

Al configurar las reescrituras del servidor Apache, debe especificar el tipo de directivas que se pueden utilizar en .htaccess, que la aplicación utiliza para especificar reglas de reescritura y protecciones de seguridad.

Instalar Apache en Ubuntu

Instale Apache si aún no lo ha hecho:

code language-bash
`apt-get -y install apache2`

Compruebe la instalación:

code language-bash
`apache2 -v`

Se muestran mensajes similares a los siguientes para confirmar que la instalación se ha realizado correctamente:

code language-text
`Server version: Apache/<installed-version> Server built: <build-date>`

Continúe con la siguiente sección.

note note
NOTE
Incluso si Apache se proporciona de forma predeterminada con Ubuntu, consulte la siguiente sección para configurarlo.

Actualizar Apache en Ubuntu

Si Apache ya está instalado y utiliza una versión anterior a 2.4, actualice a Apache 2.4 o a la versión más reciente compatible con la versión de Adobe Commerce que haya implementado. Consulte requisitos del sistema.

Actualizar información del paquete:

code language-bash
`apt-get -y update`

Añada un repositorio que proporcione una versión de Apache compatible para su entorno, si es necesario.

Instale o actualice Apache:

code language-bash
`apt-get install -y apache2`

note note
NOTE
Si el comando `apt-get install` falla debido a dependencias no satisfechas, consulte la documentación del paquete del sistema operativo o los recursos de soporte de distribución.

Compruebe la instalación:

code language-bash
`apache2 -v`

Confirme que la versión instalada coincide con la versión compatible con su versión de Adobe Commerce en requisitos del sistema.
Habilite reescrituras y .htaccess para Ubuntu.

Habilitar reescrituras y .htaccess para Ubuntu

Abra el archivo /etc/apache2/sites-available/000-default.conf para editarlo:

code language-bash
`vim /etc/apache2/sites-available/000-default.conf`

Busque el bloque que comienza con:

code language-conf
`<Directory "/var/www/html">`

Cambie el valor de AllowOverride a All.

Por ejemplo:

code language-conf
`<Directory "/var/www/html"> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny Allow from all </Directory>`

Guarde el archivo y salga del editor de texto.

Configure Apache para que use el módulo mod_rewrite:

code language-bash
`cd /etc/apache2/mods-enabled`

code language-bash
`ln -s ../mods-available/rewrite.load`

Reinicie Apache para aplicar los cambios:

code language-bash
`service apache2 restart`

IMPORTANT

Instalación de Apache en CentOS installing-apache-on-centos

La instalación y configuración de Apache en CentOS es un proceso de tres pasos:

Instalación del software
Habilitar reescrituras
Especifique .htaccess directivas.