[オンプレミス]{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を使用します。
.htaccessで定義されているAdobe Commerce セキュリティ保護をApacheが適用できないようにすることもできます。-
Apache書き換えモジュールを有効にします。
code language-bash a2enmod rewrite -
分散
.htaccess構成ファイルを使用するようにアプリケーションを有効にします。-
Ubuntuで、
/etc/apache2/sites-available/000-default.confを編集します。 その他のApache レイアウトまたは追加のパラメーターが必要な場合は、Apache ドキュメント およびApache アクセス制御ドキュメント を参照してください。 -
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>ブロックを更新します。 -
-
Apacheを再起動して変更を適用します。
code language-bash service apache2 restart
必要なモジュールのインストール
Adobe Commerceをインストールするには、次のApache モジュールが必要です。
Apacheがインストールされていることを確認する
Apacheがインストールされていることを確認し、現在のバージョンを表示するには、次のように入力します。
apache2 -v
結果には、次のような情報が表示されます。
Server version: Apache/<installed-version>
Server built: <build-date>
-
Apacheがnot インストールされている場合は、次を参照してください。
UbuntuでのApacheのインストールまたはアップグレード installing-or-upgrading-apache-on-ubuntu
UbuntuでのApacheのインストールと設定は、次の3つの手順で行います。
- ソフトウェアをインストールします。
- 書き換えを有効にします。
.htaccessディレクティブを指定します。
Apache サーバーの書き換えを設定する場合は、.htaccessで使用できるディレクティブのタイプを指定する必要があります。このディレクティブを使用して、アプリケーションは書き換えルールとセキュリティ保護を指定します。
UbuntuでのApacheのインストール
-
まだインストールしていない場合は、Apacheをインストールします。
code language-bash apt-get -y install apache2 -
インストールを確認します。
code language-bash apache2 -vインストールが正常に完了したことを確認するための次の表示に類似したメッセージ:
code language-text Server version: Apache/<installed-version> Server built: <build-date> -
次のセクションに進みます。
note note NOTE ApacheがデフォルトでUbuntuで提供されている場合でも、次の節を参照して設定してください。
UbuntuでのApacheのアップグレード
Apacheが既にインストールされていて、2.4より前のバージョンを使用している場合は、Apache 2.4またはデプロイしたAdobe Commerce バージョンでサポートされている最新バージョンにアップグレードします。 必要システム構成を参照してください。
-
パッケージ情報を更新:
code language-bash apt-get -y update -
必要に応じて、環境でサポートされているApache バージョンを提供するリポジトリを追加します。
-
Apacheのインストールまたはアップグレード:
code language-bash apt-get install -y apache2note note NOTE 未解決の依存関係が原因で apt-get installコマンドが失敗した場合は、オペレーティング システム パッケージのドキュメントまたは配布サポート リソースを参照してください。 -
インストールを確認します。
code language-bash apache2 -v -
インストールされているバージョンが、必要システム構成のAdobe Commerce リリースでサポートされているバージョンと一致することを確認してください。
-
Ubuntuの
.htaccess書き換えとを有効にします。
Ubuntuの書き換えと.htaccessを有効にする
-
編集用に
/etc/apache2/sites-available/000-default.confファイルを開きます:code language-bash vim /etc/apache2/sites-available/000-default.conf -
次で始まるブロックを探します。
code language-conf <Directory "/var/www/html"> -
AllowOverrideの値をAllに変更します。例:
code language-conf <Directory "/var/www/html"> Options Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny Allow from all </Directory> -
ファイルを保存し、テキストエディターを終了します。
-
mod_rewriteモジュールを使用するようにApacheを設定します。code language-bash cd /etc/apache2/mods-enabledcode language-bash ln -s ../mods-available/rewrite.load -
Apacheを再起動して変更を適用します。
code language-bash service apache2 restart
.htaccessで定義されているAdobe Commerce セキュリティ保護をApacheが適用できないようにすることもできます。CentOSへのApacheのインストール installing-apache-on-centos
CentOSへのApacheのインストールと設定は、次の3つの手順で行います。
- ソフトウェアのインストール
- 書き換えを有効にする
.htaccessディレクティブを指定します。
Apache サーバーの書き換えを設定する場合は、.htaccessで使用できるディレクティブのタイプを指定する必要があります。このディレクティブを使用して、アプリケーションは書き換えルールとセキュリティ保護を指定します。
Apacheのインストール
-
まだインストールしていない場合は、Apacheをインストールします。
code language-bash yum -y install httpd -
インストールを確認します。
code language-bash httpd -vインストールが正常に完了したことを確認するための次の表示に類似したメッセージ:
code language-text Server version: Apache/<installed-version> Server built: <build-date> -
次のセクションに進みます。
note note NOTE ApacheがCentOSでデフォルトで提供されている場合でも、次の節を参照して設定します。
CentOSの書き換えと.htaccessを有効にする
-
編集用に
/etc/httpd/conf/httpd.confファイルを開きます:code language-bash vim /etc/httpd/conf/httpd.conf -
次で始まるブロックを探します。
code language-conf <Directory "/var/www/html"> -
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 ドキュメント を参照してください。 -
ファイルを保存し、テキストエディターを終了します。
-
Apache設定を適用するには、Apacheを再起動します。
code language-bash systemctl restart httpd
.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>
Orderの前の値は、すべての場合で機能しない可能性があります。 詳しくは、Apache ドキュメント を参照してください。