[オンプレミス]{class="badge informative" title="Adobe Commerce オンプレミス プロジェクトにのみ適用されます。"}

オンプレミス デプロイメント用のApacheのインストール apache

このガイドでは、Commerce オンプレミスのデプロイメント用Apacheのインストールと、Adobe Commerceに必要なApache設定の設定について説明します。 これには、UbuntuとCentOSのApache要件とオペレーティングシステム固有の手順が共有されています。 Adobeでは、Commerce アプリケーションの機能とセキュリティの両方を保持するために、このガイドに記載されている設定手順に従うことをお勧めします。

Adobeでは、Adobe Commerce リリースの必要システム構成に記載されているApache バージョンをサポートしています。 サポートされているバージョンはリリースによって異なります。 Apacheには、サポートされているPHP設定も必要です。 関連するPHP要件については、PHP設定を参照してください。

環境に一致するセクションから始めます。

  • Apacheが既にインストールされている場合は、Apache要件の確認から始めます。
  • UbuntuでApacheをインストールまたはアップグレードする必要がある場合は、UbuntuでApacheをインストールまたはアップグレードします。
  • CentOSにApacheをインストールする必要がある場合は、CentOSにApacheをインストール ​に移動します。

Apacheの要件の確認

Adobe Commerceをホストする任意のApache サーバーで、これらの要件を満たします。

必要なディレクティブの設定

サーバー設定(グローバル)または仮想ホスト設定でAllowEncodedSlashesを設定して、URLに問題が発生する可能性のあるエンコードされたスラッシュのデコードを避けます。 例えば、APIを介してSKUでスラッシュ付きの商品を取得する場合、スラッシュを変換する必要はありません。 次の例のブロックは完全ではなく、その他のディレクティブが必要です。

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

書き換えと.htaccessの設定 apache-rewrites-and-htaccess

このセクションを使用して、Apacheの書き換えを有効にし、分散.htaccess ファイル ​を設定します。 Adobe Commerceは、Apacheのディレクトリレベルの手順を提供するために、サーバーの書き換えと.htaccessを使用します。

IMPORTANT
これらの設定を有効にしないと、通常、ストアフロントまたは管理者にスタイルが表示されなくなります。 また、.htaccessで定義されているAdobe Commerce セキュリティ保護をApacheが適用できないようにすることもできます。
  1. Apache書き換えモジュールを有効にします。

    code language-bash
    a2enmod rewrite
    
  2. 分散.htaccess構成ファイルを使用するようにアプリケーションを有効にします。

    1. Ubuntuで、/etc/apache2/sites-available/000-default.confを編集します。 その他のApache レイアウトまたは追加のパラメーターが必要な場合は、Apache ドキュメント ​およびApache アクセス制御ドキュメント ​を参照してください。

    2. Adobe CommerceをインストールするディレクトリのAllowOverride ディレクティブを追加または更新します。

    例えば、デフォルトのdocrootにAdobe Commerceをインストールする場合は、次のブロックを000-default.confに追加します。

    code language-conf
    <Directory "/var/www/html">
      AllowOverride All
    </Directory>
    
    note note
    NOTE
    以前のバージョンのApacheからアップグレードした場合は、まず<Directory "/var/www/html">で既存の<Directory "/var/www">または000-default.conf ブロックを探します。 別のdocrootにAdobe Commerceをインストールする場合は、そのパスに一致する<Directory> ブロックを更新します。
  3. Apacheを再起動して変更を適用します。

    code language-bash
    service apache2 restart
    

必要なモジュールのインストール

Adobe Commerceをインストールするには、次のApache モジュールが必要です。

Apacheがインストールされていることを確認する

Apacheがインストールされていることを確認し、現在のバージョンを表示するには、次のように入力します。

apache2 -v

結果には、次のような情報が表示されます。

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

UbuntuでのApacheのインストールまたはアップグレード installing-or-upgrading-apache-on-ubuntu

UbuntuでのApacheのインストールと設定は、次の3つの手順で行います。

  1. ソフトウェアをインストールします。
  2. 書き換えを有効にします。
  3. .htaccess ディレクティブを指定します。

Apache サーバーの書き換えを設定する場合は、.htaccessで使用できるディレクティブのタイプを指定する必要があります。このディレクティブを使用して、アプリケーションは書き換えルールとセキュリティ保護を指定します。

UbuntuでのApacheのインストール

  1. まだインストールしていない場合は、Apacheをインストールします。

    code language-bash
    apt-get -y install apache2
    
  2. インストールを確認します。

    code language-bash
    apache2 -v
    

    インストールが正常に完了したことを確認するための次の表示に類似したメッセージ:

    code language-text
    Server version: Apache/<installed-version>
    Server built: <build-date>
    
  3. 次のセクションに進みます。

    note note
    NOTE
    ApacheがデフォルトでUbuntuで提供されている場合でも、次の節を参照して設定してください。

UbuntuでのApacheのアップグレード

Apacheが既にインストールされていて、2.4より前のバージョンを使用している場合は、Apache 2.4またはデプロイしたAdobe Commerce バージョンでサポートされている最新バージョンにアップグレードします。 必要システム構成を参照してください。

  1. パッケージ情報を更新:

    code language-bash
    apt-get -y update
    
  2. 必要に応じて、環境でサポートされているApache バージョンを提供するリポジトリを追加します。

  3. Apacheのインストールまたはアップグレード:

    code language-bash
    apt-get install -y apache2
    
    note note
    NOTE
    未解決の依存関係が原因でapt-get install コマンドが失敗した場合は、オペレーティング システム パッケージのドキュメントまたは配布サポート リソースを参照してください。
  4. インストールを確認します。

    code language-bash
    apache2 -v
    
  5. インストールされているバージョンが、必要システム構成のAdobe Commerce リリースでサポートされているバージョンと一致することを確認してください。

  6. Ubuntu.htaccess書き換えとを有効にします。

Ubuntuの書き換えと.htaccessを有効にする

  1. 編集用に/etc/apache2/sites-available/000-default.conf ファイルを開きます:

    code language-bash
    vim /etc/apache2/sites-available/000-default.conf
    
  2. 次で始まるブロックを探します。

    code language-conf
    <Directory "/var/www/html">
    
  3. AllowOverrideの値をAllに変更します。

    例:

    code language-conf
    <Directory "/var/www/html">
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Order allow,deny
      Allow from all
    </Directory>
    
  4. ファイルを保存し、テキストエディターを終了します。

  5. mod_rewrite モジュールを使用するようにApacheを設定します。

    code language-bash
    cd /etc/apache2/mods-enabled
    
    code language-bash
    ln -s ../mods-available/rewrite.load
    
  6. Apacheを再起動して変更を適用します。

    code language-bash
    service apache2 restart
    
IMPORTANT
これらの設定を有効にしないと、通常、ストアフロントまたは管理者にスタイルが表示されなくなります。 また、.htaccessで定義されているAdobe Commerce セキュリティ保護をApacheが適用できないようにすることもできます。

CentOSへのApacheのインストール installing-apache-on-centos

CentOSへのApacheのインストールと設定は、次の3つの手順で行います。

  1. ソフトウェアのインストール
  2. 書き換えを有効にする
  3. .htaccess ディレクティブを指定します。

Apache サーバーの書き換えを設定する場合は、.htaccessで使用できるディレクティブのタイプを指定する必要があります。このディレクティブを使用して、アプリケーションは書き換えルールとセキュリティ保護を指定します。

Apacheのインストール

  1. まだインストールしていない場合は、Apacheをインストールします。

    code language-bash
    yum -y install httpd
    
  2. インストールを確認します。

    code language-bash
    httpd -v
    

    インストールが正常に完了したことを確認するための次の表示に類似したメッセージ:

    code language-text
    Server version: Apache/<installed-version>
    Server built: <build-date>
    
  3. 次のセクションに進みます。

    note note
    NOTE
    ApacheがCentOSでデフォルトで提供されている場合でも、次の節を参照して設定します。

CentOSの書き換えと.htaccessを有効にする

  1. 編集用に/etc/httpd/conf/httpd.conf ファイルを開きます:

    code language-bash
    vim /etc/httpd/conf/httpd.conf
    
  2. 次で始まるブロックを探します。

    code language-conf
    <Directory "/var/www/html">
    
  3. AllowOverrideの値をAllに変更します。

    例:

    code language-conf
    <Directory "/var/www/">
      Options Indexes FollowSymLinks MultiViews
      AllowOverride All
      Order allow,deny
      Allow from all
    </Directory>
    
    note note
    NOTE
    Orderの前の値は、すべての場合で機能しない可能性があります。 詳しくは、Apache ドキュメント ​を参照してください。
  4. ファイルを保存し、テキストエディターを終了します。

  5. Apache設定を適用するには、Apacheを再起動します。

    code language-bash
    systemctl restart httpd
    
IMPORTANT
これらの設定を有効にしないと、通常、ストアフロントまたは管理者にスタイルが表示されなくなります。 また、.htaccessで定義されているAdobe Commerce セキュリティ保護をApacheが適用できないようにすることもできます。

403 (禁止)エラーの解決

サイトにアクセスしようとしたときに403 Forbidden エラーが発生した場合は、Apache設定または仮想ホスト設定を更新して、サイトへの訪問者を有効にすることができます。

Apacheの403 Forbidden エラーを解決する

Web サイト訪問者がサイトにアクセスできるようにするには、要求ディレクティブ ​のいずれかを使用します。

例:

<Directory "/var/www/">
  Options Indexes FollowSymLinks MultiViews
  AllowOverride All
  Order allow,deny
  Require all granted
</Directory>
NOTE
Orderの前の値は、すべての場合で機能しない可能性があります。 詳しくは、Apache ドキュメント ​を参照してください。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995