DocumentaçãoCommerceGuia de instalação

[No local]{class="badge informative" title="Aplicável somente a projetos locais do Adobe Commerce."}

Instalar o Apache para implantações locais apache

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

Criado para:

  • Experiente
  • Administrador
  • Desenvolvedor

Este guia aborda a instalação do Apache para implantações locais do Adobe Commerce e a definição das configurações do Apache exigidas pelo Commerce. Ele inclui requisitos compartilhados do Apache e procedimentos específicos do sistema operacional para Ubuntu e CentOS. A Adobe recomenda seguir as instruções de configuração fornecidas neste guia para preservar a funcionalidade e a segurança do aplicativo do Commerce.

O Adobe oferece suporte às versões do Apache listadas nos requisitos do sistema da sua versão do Adobe Commerce. As versões compatíveis variam de acordo com a versão. O Apache também requer uma configuração PHP compatível. Para obter os requisitos do PHP relacionados, consulte configurações do PHP.

Comece com a seção que corresponde ao seu ambiente:

Revisar requisitos do Apache

Conclua esses requisitos em qualquer servidor Apache que hospede o Adobe Commerce.

Configurar as diretivas necessárias

Defina AllowEncodedSlashes na configuração do servidor (globalmente) ou nas configurações do host virtual para evitar a decodificação das barras codificadas que podem causar problemas para URLs. Por exemplo, ao recuperar produtos com uma barra na SKU por meio da API, você não deseja converter a barra. O bloco de exemplo a seguir não está completo e outras diretivas são necessárias.

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

Configurar regravações e .htaccess apache-rewrites-and-htaccess

Use esta seção para habilitar regravações do Apache e configurar o arquivo .htaccess distribuído. O Adobe Commerce usa substituições de servidor e .htaccess para fornecer instruções no nível do diretório para o Apache.

IMPORTANT
A falha em ativar essas configurações normalmente resulta na exibição de estilos na vitrine eletrônica ou no Administrador. Também pode impedir que o Apache aplique as proteções de segurança do Adobe Commerce definidas em .htaccess.

  1. Habilite o módulo de regravação do Apache:

    code language-bash 
    a2enmod rewrite

  2. Habilite o aplicativo para usar o arquivo de configuração .htaccess distribuído.

    1. No Ubuntu, edite /etc/apache2/sites-available/000-default.conf. Para outros layouts do Apache ou se forem necessários parâmetros adicionais, consulte a documentação do Apache e a documentação de controle de acesso do Apache.

    2. Adicione ou atualize a diretiva AllowOverride para o diretório onde você planeja instalar o Adobe Commerce.

    Por exemplo, se você instalar o Adobe Commerce no docroot padrão, adicione o seguinte bloco ao 000-default.conf:

    code language-conf 
    <Directory "/var/www/html">
  AllowOverride All
</Directory>
    note note
    NOTE
    Se você atualizou de uma versão anterior do Apache, primeiro procure um bloco existente <Directory "/var/www/html"> ou <Directory "/var/www"> em 000-default.conf. Se você instalar o Adobe Commerce em um docroot diferente, atualize o bloco <Directory> correspondente para esse caminho.

  3. Reinicie o Apache para aplicar as alterações:

    code language-bash 
    service apache2 restart

Instalar os módulos necessários

O Adobe Commerce requer que os seguintes módulos do Apache sejam instalados:

Verificar se o Apache está instalado

Para verificar se o Apache está instalado e visualizar a versão atual, insira:

apache2 -v

O resultado exibe informações semelhantes às seguintes:

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

Instalar ou atualizar o Apache no Ubuntu installing-or-upgrading-apache-on-ubuntu

A instalação e a configuração do Apache no Ubuntu são um processo de três etapas:

  1. Instale o software.
  2. Habilitar regravações.
  3. Especifique as diretivas .htaccess.

Ao configurar regravações do servidor Apache, você deve especificar o tipo de diretivas que podem ser usadas em .htaccess, que o aplicativo usa para especificar regras de regravação e proteções de segurança.

Instalar o Apache no Ubuntu

  1. Instale o Apache se ainda não tiver feito isso:

    code language-bash 
    apt-get -y install apache2

  2. Verifique a instalação:

    code language-bash 
    apache2 -v

    Mensagens semelhantes às seguintes são exibidas para confirmar que a instalação foi bem-sucedida:

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

  3. Prossiga para a próxima seção.

    note note
    NOTE
    Mesmo que o Apache seja fornecido por padrão com o Ubuntu, consulte a seção a seguir para configurá-lo.

Atualização do Apache no Ubuntu

Se o Apache já estiver instalado e você estiver usando uma versão anterior ao 2.4, atualize para o Apache 2.4 ou para a versão mais recente com suporte da versão do Adobe Commerce que você implantou. Consulte requisitos de sistema.

  1. Atualizar informações do pacote:

    code language-bash 
    apt-get -y update

  2. Adicione um repositório que forneça uma versão do Apache compatível com seu ambiente, se necessário.

  3. Instalar ou atualizar o Apache:

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Se o comando apt-get install falhar devido a dependências não atendidas, consulte a documentação do pacote do sistema operacional ou os recursos de suporte à distribuição.

  4. Verifique a instalação:

    code language-bash 
    apache2 -v

  5. Confirme se a versão instalada corresponde à versão com suporte para sua versão do Adobe Commerce em requisitos do sistema.

  6. Habilitar regravações e .htaccess para Ubuntu.

Habilite regravações e .htaccess para Ubuntu

  1. Abra o arquivo /etc/apache2/sites-available/000-default.conf para edição:

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

  2. Localize o bloco que começa com:

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

  3. Altere o valor de AllowOverride para All.

    Por exemplo:

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

  4. Salve o arquivo e saia do editor de texto.

  5. Configure o Apache para usar o módulo mod_rewrite:

    code language-bash 
    cd /etc/apache2/mods-enabled
    code language-bash 
    ln -s ../mods-available/rewrite.load

  6. Reinicie o Apache para aplicar as alterações:

    code language-bash 
    service apache2 restart
IMPORTANT
A falha em ativar essas configurações normalmente resulta na exibição de estilos na vitrine eletrônica ou no Administrador. Também pode impedir que o Apache aplique as proteções de segurança do Adobe Commerce definidas em .htaccess.

Instalar o Apache no CentOS installing-apache-on-centos

A instalação e configuração do Apache no CentOS é um processo de três etapas:

  1. Instalar o software
  2. Habilitar regravações
  3. Especifique as diretivas .htaccess.

Ao configurar regravações do servidor Apache, você deve especificar o tipo de diretivas que podem ser usadas em .htaccess, que o aplicativo usa para especificar regras de regravação e proteções de segurança.

Instalação do Apache

  1. Instale o Apache se ainda não tiver feito isso.

    code language-bash 
    yum -y install httpd

  2. Verifique a instalação:

    code language-bash 
    httpd -v

    Mensagens semelhantes às seguintes são exibidas para confirmar que a instalação foi bem-sucedida:

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

  3. Prossiga para a próxima seção.

    note note
    NOTE
    Mesmo que o Apache seja fornecido por padrão com o CentOS, consulte a seção a seguir para configurá-lo.

Habilitar regravações e .htaccess para CentOS

  1. Abra o arquivo /etc/httpd/conf/httpd.conf para edição:

    code language-bash 
    vim /etc/httpd/conf/httpd.conf

  2. Localize o bloco que começa com:

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

  3. Altere o valor de AllowOverride para All.

    Por exemplo:

    code language-conf 
    <Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>
    note note
    NOTE
    Os valores anteriores para Order podem não funcionar em todos os casos. Para obter mais informações, consulte a documentação do Apache.

  4. Salve o arquivo e saia do editor de texto.

  5. Para aplicar as configurações do Apache, reinicie o Apache.

    code language-bash 
    systemctl restart httpd
IMPORTANT
A falha em ativar essas configurações normalmente resulta na exibição de estilos na vitrine eletrônica ou no Administrador. Também pode impedir que o Apache aplique as proteções de segurança do Adobe Commerce definidas em .htaccess.

Resolvendo erros 403 (Proibido)

Se você encontrar erros 403 Proibido ao tentar acessar o site, poderá atualizar sua configuração do Apache ou a configuração do host virtual para permitir que os visitantes do site:

Resolver erros 403 proibidos do Apache

Para permitir que visitantes do site acessem seu site, use uma das Diretivas necessárias.

Por exemplo:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Os valores anteriores para Order podem não funcionar em todos os casos. Para obter mais informações, consulte a documentação do Apache.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995