DocumentazioneCommerceGuida all’installazione

[On-premise]{class="badge informative" title="Applicabile solo ai progetti locali di Adobe Commerce."}

Installare Apache per le distribuzioni locali apache

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

Creato per:

  • Esperto
  • Amministratore
  • Sviluppatore

Questa guida illustra come installare Apache per le distribuzioni Adobe Commerce on-premise e configurare le impostazioni Apache richieste da Commerce. Include i requisiti Apache condivisi e le procedure specifiche per il sistema operativo per Ubuntu e CentOS. Adobe consiglia di seguire le istruzioni di configurazione fornite in questa guida per preservare sia la funzionalità che la sicurezza dell’applicazione Commerce.

Adobe supporta le versioni di Apache elencate in requisiti di sistema per la versione di Adobe Commerce in uso. Le versioni supportate variano a seconda della versione. Apache richiede anche una configurazione PHP supportata. Per i requisiti PHP correlati, vedere Impostazioni PHP.

Inizia con la sezione corrispondente al tuo ambiente:

Verifica i requisiti di Apache

Completa questi requisiti su qualsiasi server Apache che ospita Adobe Commerce.

Configurare le direttive richieste

Impostare AllowEncodedSlashes nella configurazione del server (a livello globale) o nelle configurazioni dell'host virtuale per evitare di decodificare le barre codificate che possono causare problemi per gli URL. Ad esempio, quando recuperi prodotti con una barra nello SKU tramite l’API, non desideri convertire la barra. Il seguente blocco di esempio non è completo e sono necessarie altre direttive.

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

Configurare riscritture e .htaccess apache-rewrites-and-htaccess

Utilizzare questa sezione per abilitare Apache riscrive e configurare il file .htaccess distribuito. Adobe Commerce utilizza le riscritture del server e .htaccess per fornire istruzioni a livello di directory per Apache.

IMPORTANT
Se non si attivano queste impostazioni, in genere non vengono visualizzati stili nella vetrina o nell’amministratore. Può anche impedire ad Apache di applicare le protezioni di sicurezza di Adobe Commerce definite in .htaccess.

  1. Abilita il modulo di riscrittura Apache:

    code language-bash 
    a2enmod rewrite

  2. Abilitare l'applicazione per utilizzare il file di configurazione .htaccess distribuito.

    1. In Ubuntu, modificare /etc/apache2/sites-available/000-default.conf. Per altri layout Apache o se sono necessari parametri aggiuntivi, consulta la documentazione Apache e la documentazione sul controllo degli accessi Apache.

    2. Aggiungere o aggiornare la direttiva AllowOverride per la directory in cui si intende installare Adobe Commerce.

    Se ad esempio si installa Adobe Commerce nel docroot predefinito, aggiungere il blocco seguente a 000-default.conf:

    code language-conf 
    <Directory "/var/www/html">
  AllowOverride All
</Directory>
    note note
    NOTE
    Se hai eseguito l'aggiornamento da una versione precedente di Apache, cerca prima un blocco <Directory "/var/www/html"> o <Directory "/var/www"> esistente in 000-default.conf. Se installi Adobe Commerce in un altro docroot, aggiorna il blocco <Directory> corrispondente per quel percorso.

  3. Riavvia Apache per applicare le modifiche:

    code language-bash 
    service apache2 restart

Installare i moduli richiesti

Adobe Commerce richiede l’installazione dei seguenti moduli Apache:

Verifica che Apache sia installato

Per verificare che Apache sia installato e visualizzare la versione corrente, immetti:

apache2 -v

Il risultato mostra informazioni simili alle seguenti:

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

Installare o aggiornare Apache su Ubuntu installing-or-upgrading-apache-on-ubuntu

L’installazione e la configurazione di Apache su Ubuntu è un processo in tre fasi:

  1. Installare il software.
  2. Abilita riscritture.
  3. Specificare .htaccess direttive.

Quando si configura la riscrittura del server Apache, è necessario specificare il tipo di direttive che è possibile utilizzare in .htaccess, utilizzate dall'applicazione per specificare le regole di riscrittura e le protezioni di sicurezza.

Installare Apache su Ubuntu

  1. Installa Apache se non lo hai già fatto:

    code language-bash 
    apt-get -y install apache2

  2. Verificare l'installazione:

    code language-bash 
    apache2 -v

    Vengono visualizzati messaggi simili al seguente per confermare che l’installazione è andata a buon fine:

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

  3. Procedi alla sezione successiva.

    note note
    NOTE
    Anche se Apache viene fornito per impostazione predefinita con Ubuntu, consulta la sezione seguente per configurarlo.

Aggiornamento di Apache su Ubuntu

Se Apache è già installato e si utilizza una versione precedente a 2.4, eseguire l'aggiornamento ad Apache 2.4 o alla versione più recente supportata dalla versione di Adobe Commerce distribuita. Consulta requisiti di sistema.

  1. Aggiorna informazioni pacchetto:

    code language-bash 
    apt-get -y update

  2. Se necessario, aggiungi un archivio che fornisce una versione supportata di Apache per il tuo ambiente.

  3. Installare o aggiornare Apache:

    code language-bash 
    apt-get install -y apache2
    note note
    NOTE
    Se il comando apt-get install non riesce a causa di dipendenze non soddisfatte, consultare la documentazione del pacchetto del sistema operativo o le risorse di supporto per la distribuzione.

  4. Verificare l'installazione:

    code language-bash 
    apache2 -v

  5. Verifica che la versione installata corrisponda alla versione supportata per la tua versione di Adobe Commerce in requisiti di sistema.

  6. Abilita riscritture e .htaccess per Ubuntu.

Abilita riscritture e .htaccess per Ubuntu

  1. Apri il file /etc/apache2/sites-available/000-default.conf per la modifica:

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

  2. Individua il blocco che inizia con:

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

  3. Modificare il valore di AllowOverride in All.

    Ad esempio:

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

  4. Salvate il file e uscite dall'editor di testo.

  5. Configurare Apache per l'utilizzo del modulo mod_rewrite:

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

  6. Riavvia Apache per applicare le modifiche:

    code language-bash 
    service apache2 restart
IMPORTANT
Se non si attivano queste impostazioni, in genere non vengono visualizzati stili nella vetrina o nell’amministratore. Può anche impedire ad Apache di applicare le protezioni di sicurezza di Adobe Commerce definite in .htaccess.

Installare Apache su CentOS installing-apache-on-centos

L’installazione e la configurazione di Apache su CentOS è un processo in tre fasi:

  1. Installare il software
  2. Abilita riscritture
  3. Specificare .htaccess direttive.

Quando si configura la riscrittura del server Apache, è necessario specificare il tipo di direttive che è possibile utilizzare in .htaccess, utilizzate dall'applicazione per specificare le regole di riscrittura e le protezioni di sicurezza.

Installazione di Apache

  1. Se non lo hai già fatto, installa Apache.

    code language-bash 
    yum -y install httpd

  2. Verificare l'installazione:

    code language-bash 
    httpd -v

    Vengono visualizzati messaggi simili al seguente per confermare che l’installazione è andata a buon fine:

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

  3. Procedi alla sezione successiva.

    note note
    NOTE
    Anche se Apache viene fornito per impostazione predefinita con CentOS, consulta la sezione seguente per configurarlo.

Abilita riscritture e .htaccess per CentOS

  1. Apri il file /etc/httpd/conf/httpd.conf per la modifica:

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

  2. Individua il blocco che inizia con:

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

  3. Modificare il valore di AllowOverride in All.

    Ad esempio:

    code language-conf 
    <Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Allow from all
</Directory>
    note note
    NOTE
    I valori precedenti per Order potrebbero non funzionare in tutti i casi. Per ulteriori informazioni, consulta la documentazione di Apache.

  4. Salvate il file e uscite dall'editor di testo.

  5. Per applicare le impostazioni Apache, riavvia Apache.

    code language-bash 
    systemctl restart httpd
IMPORTANT
Se non si attivano queste impostazioni, in genere non vengono visualizzati stili nella vetrina o nell’amministratore. Può anche impedire ad Apache di applicare le protezioni di sicurezza di Adobe Commerce definite in .htaccess.

Risoluzione degli errori 403 (non consentito)

Se rilevi 403 errori non consentiti durante il tentativo di accesso al sito, puoi aggiornare la configurazione Apache o l’host virtuale per abilitare i visitatori al sito:

Risolvere gli errori non consentiti 403 per Apache

Per consentire ai visitatori del sito Web di accedere al sito, utilizzare una delle direttive obbligatorie.

Ad esempio:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
I valori precedenti per Order potrebbero non funzionare in tutti i casi. Per ulteriori informazioni, consulta la documentazione di Apache.
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995