DocumentatieCommerceInstallatiehandleiding

[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Nginx

Last update: Tue Oct 14 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Ervaren
  • Beheerder
  • Ontwikkelaar

Adobe Commerce steunt nginx 1.x (of de ​ recentste belangrijkste belangrijkste versie ​). U moet ook de nieuwste versie van php-fpm installeren.

De installatie-instructies variëren afhankelijk van het besturingssysteem dat u gebruikt. Zie ​ PHP ​ voor informatie.

Ubuntu

In de volgende sectie wordt beschreven hoe u Adobe Commerce 2.x op Ubuntu kunt installeren met nginx, PHP en MySQL.

Nginx installeren

sudo apt -y install nginx

U kunt ​ ook bouwen nginx van bron ​

Na de voltooiing van de volgende secties en het installeren van de toepassing, zullen wij een dossier van de steekproefconfiguratie gebruiken om ​ te vormen nginx ​.

Pfp-fpm installeren en configureren

Adobe Commerce vereist verscheidene ​ PHP uitbreidingen ​ om behoorlijk te functioneren. Naast deze extensies moet u ook de extensie php-fpm installeren en configureren als u nginx gebruikt.

U installeert en configureert php-fpm als volgt:

  1. Installeren php-fpm en php-cli :

    code language-bash 
    apt-get -y install php7.2-fpm php7.2-cli
    note note
    NOTE
    Deze opdracht installeert de nieuwste beschikbare versie van PHP 7.2.X. Zie ​ systeemvereisten ​ voor gesteunde PHP versies.

  2. Open de php.ini bestanden in een editor:

    code language-bash 
    vim /etc/php/7.2/fpm/php.ini
    code language-bash 
    vim /etc/php/7.2/cli/php.ini

  3. Bewerk beide bestanden om deze af te stemmen op de volgende regels:

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    We raden u aan de geheugenlimiet in te stellen op 2 G wanneer u Adobe Commerce test. Verwijs naar ​ Vereiste PHP montages ​ voor meer informatie.

  4. Sla de editor op en sluit deze af.

  5. Start de service php-fpm opnieuw:

    code language-bash 
    systemctl restart php7.2-fpm

MySQL installeren en configureren

Verwijs naar ​ MySQL ​ voor meer informatie.

Installeren en configureren

U kunt Adobe Commerce op verschillende manieren downloaden, waaronder:

In dit voorbeeld ziet u een op composers gebaseerde installatie die de opdrachtregel gebruikt.

  1. Als ​ eigenaar van het dossiersysteem ​, login aan uw toepassingsserver.

  2. Wijzig de hoofdmap van de webserver of een map die u hebt geconfigureerd als een virtueel hoofddocument van de host. In dit voorbeeld gebruiken we de standaardinstelling Ubuntu /var/www/html .

    code language-bash 
    cd /var/www/html

  3. Composer wereldwijd installeren. Composer moet afhankelijkheden bijwerken voordat Adobe Commerce kan worden geïnstalleerd:

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Maak een Composer-project met het Adobe Commerce-metapakket.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    Wanneer ertoe aangezet, ga uw ​ authentificatietoetsen ​ in. Uw openbare sleutel is uw gebruikersbenaming; uw privé sleutel is uw wachtwoord.

  5. Stel lees- en schrijfmachtigingen in voor de webservergroep voordat u de toepassing installeert. Dit is nodig, zodat de opdrachtregel bestanden naar het bestandssysteem kan schrijven.

    code language-bash 
    cd /var/www/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :www-data . # Ubuntu
    code language-bash 
    chmod u+x bin/magento

  6. Installeer van de ​ bevellijn ​. In dit voorbeeld wordt ervan uitgegaan dat de installatiemap de naam magento2ee heeft, db-host zich op dezelfde computer bevindt (localhost) en db-name , db-user en db-password alle magento zijn:

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--backend-frontname=admin \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1 \
--search-engine=elasticsearch7 \
--elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

  7. Overschakelen naar de modus Ontwikkelaar:

    code language-bash 
    cd /var/www/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Nginx configureren

We raden u aan om nginx te configureren met behulp van het configuratiebestand van nginx.conf.sample dat beschikbaar is in de installatiemap en de virtuele nginx-host.

In deze instructies wordt ervan uitgegaan dat u de standaardlocatie Ubuntu voor de virtuele nginx-host (bijvoorbeeld /etc/nginx/sites-available ) en de standaarddocroot Ubuntu (bijvoorbeeld /var/www/html ) gebruikt, maar u kunt deze locaties aanpassen aan uw omgeving.

  1. Maak een nieuwe virtuele host voor uw site:

    code language-bash 
    vim /etc/nginx/sites-available/magento

  2. Voeg de volgende configuratie toe:

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php/php7.2-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /var/www/html/magento2;
  include /var/www/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    De instructie include moet verwijzen naar het voorbeeldconfiguratiebestand voor nginx in de installatiemap.

  3. Vervang www.magento-dev.com door uw domeinnaam. Dit moet overeenkomen met de basis-URL die u hebt opgegeven bij de installatie van Adobe Commerce.

  4. Sla de editor op en sluit deze af.

  5. Activeer de nieuwe virtuele host door er een symlink naar te maken in de map /etc/nginx/sites-enabled :

    code language-bash 
    ln -s /etc/nginx/sites-available/magento /etc/nginx/sites-enabled

  6. Controleer of de syntaxis correct is:

    code language-bash 
    nginx -t

  7. Nginx opnieuw starten:

    code language-bash 
    systemctl restart nginx

De installatie controleren

Open Webbrowser en navigeer aan basis URL van uw plaats om ​ de installatie ​ te verifiëren.

CentOS 7

In de volgende sectie wordt beschreven hoe u Adobe Commerce 2.x op CentOS 7 kunt installeren met nginx, PHP en MySQL.

Nginx installeren

yum -y install epel-release

yum -y install nginx

Start nginx nadat de installatie is voltooid en configureer deze om te starten op het moment van opstarten:

systemctl start nginx

systemctl enable nginx

Na de voltooiing van de volgende secties en het installeren van de toepassing, zullen wij een dossier van de steekproefconfiguratie gebruiken om nginx te vormen.

Pfp-fpm installeren en configureren

Adobe Commerce vereist verscheidene ​ PHP ​ uitbreidingen om behoorlijk te functioneren. Naast deze extensies moet u ook de extensie php-fpm installeren en configureren als u nginx gebruikt.

  1. Installeren php-fpm:

    code language-bash 
    yum -y install php70w-fpm

  2. Open het /etc/php.ini -bestand in een editor.

  3. Verwijder de commentaarmarkering van de regel cgi.fix_pathinfo en wijzig de waarde in 0 .

  4. Bewerk het bestand zodat dit overeenkomt met de volgende regels:

    code language-conf 
    memory_limit = 2G
max_execution_time = 1800
zlib.output_compression = On
    note note
    NOTE
    We raden u aan de geheugenlimiet in te stellen op 2 G wanneer u Adobe Commerce test. Verwijs naar ​ Vereiste PHP montages ​ voor meer informatie.

  5. Verwijder de commentaarmarkering van de map met het sessiepad en stel het pad in:

    code language-conf 
    session.save_path = "/var/lib/php/session"

  6. Sla de editor op en sluit deze af.

  7. Open /etc/php-fpm.d/www.conf in een editor.

  8. Bewerk het bestand zodat dit overeenkomt met de volgende regels:

    code language-conf 
    user = nginx
group = nginx
listen = /run/php-fpm/php-fpm.sock
listen.owner = nginx
listen.group = nginx
listen.mode = 0660

  9. Verwijder de commentaarmarkering van de omgevingsregels:

    code language-conf 
    env[HOSTNAME] = $HOSTNAME
env[PATH] = /usr/local/bin:/usr/bin:/bin
env[TMP] = /tmp
env[TMPDIR] = /tmp
env[TEMP] = /tmp

  10. Sla de editor op en sluit deze af.

  11. Maak een map voor het PHP-sessiepad en wijzig de eigenaar in apache user and group:

    code language-bash 
    mkdir -p /var/lib/php/session/
    code language-bash 
    chown -R apache:apache /var/lib/php/

  12. Maak een map voor het PHP-sessiepad en wijzig de eigenaar in apache user and group:

    code language-bash 
    mkdir -p /run/php-fpm/
    code language-bash 
    chown -R apache:apache /run/php-fpm/

  13. Start de php-fpm -service en configureer deze zo dat deze op het moment van opstarten start:

    code language-bash 
    systemctl start php-fpm
    code language-bash 
    systemctl enable php-fpm

  14. Controleer of de service php-fpm wordt uitgevoerd:

    code language-bash 
    netstat -pl | grep php-fpm.sock

MySQL installeren en configureren

Verwijs naar ​ MySQL ​ voor meer informatie.

Installeren en configureren

U kunt de Adobe Commerce op verschillende manieren downloaden, waaronder:

In dit voorbeeld ziet u een op composers gebaseerde installatie die de opdrachtregel gebruikt.

  1. Als ​ eigenaar van het dossiersysteem ​, login aan uw toepassingsserver.

  2. Wijzig de hoofdmap van de webserver of een map die u hebt geconfigureerd als een virtueel hoofddocument van de host. In dit voorbeeld gebruiken we de standaardinstelling Ubuntu /var/www/html .

    code language-bash 
    cd /var/www/html

  3. Composer wereldwijd installeren. Composer moet afhankelijkheden bijwerken voordat Adobe Commerce kan worden geïnstalleerd:

    code language-bash 
    curl -sS https://getcomposer.org/installer | sudo php -- --install-dir=/usr/bin --filename=composer

  4. Maak een Composer-project met het Adobe Commerce-metapakket.

    Magento Open Source

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-community-edition <install-directory-name>

    Adobe Commerce

    code language-bash 
    composer create-project --repository=https://repo.magento.com/ magento/project-enterprise-edition <install-directory-name>

    Wanneer ertoe aangezet, ga uw ​ authentificatietoetsen ​ in. Uw openbare sleutel is uw gebruikersbenaming; uw privé sleutel is uw wachtwoord.

  5. Stel lees- en schrijfmachtigingen in voor de webservergroep voordat u de toepassing installeert. Dit is nodig, zodat de opdrachtregel bestanden naar het bestandssysteem kan schrijven.

    code language-bash 
    cd /var/www/html/<magento install directory>
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type f -exec chmod g+w {} +
    code language-bash 
    find var generated vendor pub/static pub/media app/etc -type d -exec chmod g+ws {} +
    code language-bash 
    chown -R :www-data . # Ubuntu
    code language-bash 
    chmod u+x bin/magento

  6. Installeer van de ​ bevellijn ​. In dit voorbeeld wordt ervan uitgegaan dat de installatiemap de naam magento2ee heeft, db-host zich op dezelfde computer bevindt (localhost) en db-name , db-user en db-password alle magento zijn:

    code language-bash 
    bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--backend-frontname=admin \
--admin-firstname=admin \
--admin-lastname=admin \
--admin-email=admin@admin.com \
--admin-user=admin \
--admin-password=admin123 \
--language=en_US \
--currency=USD \
--timezone=America/Chicago \
--use-rewrites=1

  7. Overschakelen naar de modus Ontwikkelaar:

    code language-bash 
    cd /var/www/html/magento2/bin
    code language-bash 
    ./magento deploy:mode:set developer

Nginx configureren

We raden u aan om nginx te configureren met behulp van het configuratiebestand van nginx.conf.sample dat beschikbaar is in de installatiemap en de virtuele nginx-host.

In deze instructies wordt ervan uitgegaan dat u de standaardlocatie van CentOS voor de virtuele nginx-host (bijvoorbeeld /etc/nginx/conf.d ) en de standaarddocroot (bijvoorbeeld /usr/share/nginx/html ) gebruikt, maar u kunt deze locaties aanpassen aan uw omgeving.

  1. Maak een nieuwe virtuele host voor uw site:

    code language-bash 
    vim /etc/nginx/conf.d/magento.conf

  2. Voeg de volgende configuratie toe:

    code language-conf 
    upstream fastcgi_backend {
  server  unix:/run/php-fpm/php-fpm.sock;
}

server {

  listen 80;
  server_name www.magento-dev.com;
  set $MAGE_ROOT /usr/share/nginx/html/magento2;
  include /usr/share/nginx/html/magento2/nginx.conf.sample;
}
    note note
    NOTE
    De instructie include moet verwijzen naar het voorbeeldconfiguratiebestand voor nginx in de installatiemap.

  3. Vervang www.magento-dev.com door uw domeinnaam.

  4. Sla de editor op en sluit deze af.

  5. Controleer of de syntaxis correct is:

    code language-bash 
    nginx -t

  6. Nginx opnieuw starten:

    code language-bash 
    systemctl restart nginx

SELinux en Firewalld configureren

SELinux is standaard ingeschakeld in CentOS 7. Gebruik het volgende bevel om te zien of loopt het:

sestatus

Om SELinux en firewalld te vormen:

  1. SELinux-beheertools installeren:

    code language-bash 
    yum -y install policycoreutils-python

  2. Voer de volgende opdrachten uit om de beveiligingscontext voor de installatiemap te wijzigen:

    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/app/etc(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/var(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/media(/.*)?'
    code language-bash 
    semanage fcontext -a -t httpd_sys_rw_content_t '/usr/share/nginx/html/magento2/pub/static(/.*)?'
    code language-bash 
    restorecon -Rv '/usr/share/nginx/html/magento2/'

  3. Installeer het firewalld-pakket:

    code language-bash 
    yum -y install firewalld

  4. Start de firewallservice en configureer deze zo dat deze op het moment van opstarten start:

    code language-bash 
    systemctl start firewalld
    code language-bash 
    systemctl enable firewalld

  5. Voer de volgende opdrachten uit om poorten voor HTTP en HTTPS te openen, zodat u de basis-URL vanuit een webbrowser kunt openen:

    code language-bash 
    firewall-cmd --permanent --add-service=http
    code language-bash 
    firewall-cmd --permanent --add-service=https
    code language-bash 
    firewall-cmd --reload

De installatie controleren

Open Webbrowser en navigeer aan basis URL van uw plaats om ​ de installatie ​ te verifiëren.

recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995