文件Commerce安裝指南

系統需求

Last update: Wed Jul 17 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主題：

建立對象：

  • 經驗豐富
  • 管理員
  • 開發人員

以下摘要說明針對Adobe Commerce測試的軟體相依性和服務。

雲端基礎結構上Commerce的相依性有一些差異。 雲端基礎結構上Adobe Commerce的服務版本和相容性支援取決於測試並部署至託管雲端環境的服務，有時與Adobe Commerce內部部署支援的版本不同。 例如，內部部署的Commerce 2.4.4支援Elasticsearch7.17，但雲端基礎結構上的Commerce 2.4.4支援OpenSearch 1.2。

下表顯示Adobe已使用特定Adobe Commerce發行版本測試的協力廠商軟體相依性版本。

Adobe僅支援下表所述的系統需求組合。 例如，2.4.5已透過MariaDB 10.4完成測試。Adobe建議您在升級至2.4.5之前，先升級至MariaDB 10.4。

雲端上的Commerce

雲端範本🔗上的Commerce提供與特定Commerce版本相容之服務的預設設定。

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 layout-auto
軟體相依性 2.4.7 - p3 2.4.7 - p2 2.4.7 - p1 2.4.7
Composer 2.7 2.7 2.7 2.7
Elasticsearch — — — —
OpenSearch 2.12 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6 10.6
PHP 8.3， 8.2 8.3， 8.2 8.3， 8.2 8.3， 8.2
RabbitMQ 3.13 3.13 3.12 3.12
Redis 7.2 7.2 7.2 7.2
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 layout-auto
軟體相依性 2.4.6 - p8 2.4.6 - p7 2.4.6 - p6 2.4.6 - p5 2.4.6 - p4 2.4.6 - p3 2.4.6 - p2 2.4.6 - p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — — — —
OpenSearch 2.12 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
PHP 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1
RabbitMQ 3.13 3.13 3.12 3.12， 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9
Redis 7.2 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 layout-auto
軟體相依性 2.4.5-p10 2.4.5 - p9 2.4.5 - p8 2.4.5 - p7 2.4.5 - p6 2.4.5 - p5 2.4.5 - p4 2.4.5 - p3 2.4.5 - p2 2.4.5 - p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch — — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5 10.5， 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.13 3.13 3.12， 3.11 3.12， 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.9 3.9 3.9
Redis 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-13 1-row-13 2-row-13 3-row-13 4-row-13 5-row-13 6-row-13 7-row-13 layout-auto
軟體相依性 2.4.4-p11 2.4.4-p10 2.4.4 - p9 2.4.4 - p8 2.4.4 - p7 2.4.4 - p6 2.4.4 - p5 2.4.4 - p4 2.4.4 - p3 2.4.4 - p2 2.4.4 - p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch — — — — — — — — — — — —
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5 10.5 10.5， 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.2 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto
軟體相依性 2.4.3 - p3
Composer 1
Elasticsearch —
OpenSearch 1.2
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 layout-auto
軟體相依性 2.4.2 - p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
PHP 7.4
RabbitMQ 3.8
Redis 6.0

服務與版本定義於的services.yaml檔案。 以下是雲端基礎結構上Commerce 2.4.6的預設服務設定：

code language-yaml 
mysql:
    type: mysql:10.6
    disk: 5120

redis:
    type: redis:7.0

opensearch:
    type: opensearch:2
    disk: 1024

請參閱​ 雲端基礎結構上的Commerce ​指南中的設定服務。

Commerce內部部署
note note
NOTE
2.4.4和2.4.5版僅支援MySQL 8.0.0到8.0.28。
table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5 9-row-5 10-row-5 11-row-5 12-row-5 13-row-5 14-row-5 15-row-5 16-row-5 17-row-5 layout-auto
軟體相依性 2.4.7 - p3 2.4.7 - p2 2.4.7 - p1 2.4.7
Composer 2.7 2.7 2.7 2.7
Elasticsearch 8.11 8.11 8.11 8.11
OpenSearch 2.12 2.12 2.12 2.12
MariaDB 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0
PHP 8.3， 8.2 8.3， 8.2 8.3， 8.2 8.3， 8.2
RabbitMQ 3.13 3.13 3.13 3.13
Redis 7.2 7.2 7.2 7.2
Varnish 7.5 7.5 7.5 7.5
Apache 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️
AWS MQ 3.11.20 3.11.20 3.11.20 3.11.20
AWS ElastiCache Redis 7.0 Redis 7.0 Redis 7.0 Redis 7.0
AWS Elasticsearch — — — —
AWS OpenSearch 2.11 2.11 2.11 2.11
table 0-row-10 1-row-10 2-row-10 3-row-10 4-row-10 5-row-10 6-row-10 7-row-10 8-row-10 9-row-10 10-row-10 11-row-10 12-row-10 13-row-10 14-row-10 15-row-10 16-row-10 17-row-10 layout-auto
軟體相依性 2.4.6 - p8 2.4.6 - p7 2.4.6 - p6 2.4.6 - p5 2.4.6 - p4 2.4.6 - p3 2.4.6 - p2 2.4.6 - p1 2.4.6
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 8.11， 7.17 8.11， 7.17 8.11， 7.17 8.11， 7.17 8.11， 7.17 8.5， 7.17 8.5， 7.17 8.5， 7.17 8.4， 7.17
OpenSearch 2.12 2.12 2.12 2.12 2.5 2.5 2.5 2.5 2.5
MariaDB 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6 10.6
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1 8.2， 8.1
RabbitMQ 3.13 3.13 3.12 3.12， 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9
Redis 7.2， 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0 7.0
Varnish 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16 3.9.16
AWS ElastiCache Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2 Redis 6.2
AWS Elasticsearch — — — — — — — — —
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-12 1-row-12 2-row-12 3-row-12 4-row-12 5-row-12 6-row-12 7-row-12 8-row-12 9-row-12 10-row-12 11-row-12 12-row-12 13-row-12 14-row-12 15-row-12 16-row-12 17-row-12 layout-auto
軟體相依性 2.4.5-p10 2.4.5 - p9 2.4.5 - p8 2.4.5 - p7 2.4.5 - p6 2.4.5 - p5 2.4.5 - p4 2.4.5 - p3 2.4.5 - p2 2.4.5 - p1 2.4.5
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5， 10.4 10.5， 10.4 10.5， 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.13 3.13 3.12， 3.11 3.12， 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.11， 3.9 3.9 3.9 3.9
Redis 7.2， 7.0 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13
AWS ElastiCache Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6
AWS Elasticsearch — — — — — — — — — 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
table 0-row-13 1-row-13 2-row-13 3-row-13 4-row-13 5-row-13 6-row-13 7-row-13 8-row-13 9-row-13 10-row-13 11-row-13 12-row-13 13-row-13 14-row-13 15-row-13 16-row-13 17-row-13 layout-auto
軟體相依性 2.4.4-p11 2.4.4-p10 2.4.4 - p9 2.4.4 - p8 2.4.4 - p7 2.4.4 - p6 2.4.4 - p5 2.4.4 - p4 2.4.4 - p3 2.4.4 - p2 2.4.4 - p1 2.4.4
Composer 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.2 2.1 2.1 2.1
Elasticsearch 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.17 7.16 7.16 7.16
OpenSearch 1.3 1.3 1.3 1.3 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2
MariaDB 10.5， 10.4 10.5， 10.4 10.5， 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4 10.4
MySQL 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0
PHP 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1 8.1
RabbitMQ 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9 3.9
Redis 7.2， 7.0 7.0 7.0 7.0 6.2 6.2 6.2 6.2 6.2 6.2 6.2 6.2
Varnish 7.5 7.5 7.5 7.5 7.3 7.3 7.3 7.3 7.1 7.0 7.0 7.0
Apache 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4 2.4
nginx 1.24 1.24 1.24 1.24 1.24 1.24 1.22 1.22 1.22 1.22 1.22 1.22
AWS Aurora (MySQL) 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 8.0 5.7 5.7 5.7
AWS S3 ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️ ✔️
AWS MQ 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.9.13 3.8.11 3.8.11 3.8.11
AWS ElastiCache Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6 Redis 6
AWS Elasticsearch — — — — — — — — — 7.9 7.9 7.9
AWS OpenSearch 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 1.2 — — —
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto
軟體相依性 2.4.3 - p3
Composer 1
Elasticsearch 7.16
OpenSearch 1.2
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.5
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) 5.7
AWS S3 ✔️
AWS MQ 3.8.11
AWS ElastiCache Redis 6
AWS Elasticsearch 7.9
AWS OpenSearch —
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 15-row-2 16-row-2 17-row-2 layout-auto
軟體相依性 2.4.2 - p2
Composer 1
Elasticsearch 7.9
OpenSearch —
MariaDB 10.4
MySQL 8.0
PHP 7.4
RabbitMQ 3.8
Redis 6.0
Varnish 6.4
Apache 2.4
nginx 1.18
AWS Aurora (MySQL) —
AWS S3 ✔️
AWS MQ —
AWS ElastiCache —
AWS Elasticsearch —
AWS OpenSearch —

PHP設定

有特定的PHP組態設定，例如memory_limit設定，可協助您在使用Adobe Commerce時避免常見問題。 請參閱必要的PHP設定。

如需雲端組態指南，請參閱​ 雲端基礎結構上的Commerce ​指南中的PHP設定。

PHP OPcache

建議您確認PHP OPcache已因效能原因啟用。 OPcache已在許多PHP分配中啟用。 opcache擴充功能預設會安裝在雲端基礎結構上的Commerce中。

若為內部部署，請確認是否已安裝PHP OPcache，請參閱PHP設定。 如需效能設定的特定指引，請參閱​ 效能最佳實務 ​指南中的PHP設定軟體建議。

如果您必須單獨安裝OPcache，請參閱PHP OPcache檔案。

PHP程式控制

您必須先在PHP中啟用「程式控制」支援(pcntl)，才能以平行模式執行索引器。 請參閱PHP檔案中的安裝。

PHPUnit

PHPUnit v9 （作為命令列工具）。

PHP擴充功能

PHP安裝指示包含安裝這些擴充功能的步驟。

TIP
有關雲端基礎結構中的PHP擴充功能，請參閱​_雲端基礎結構上的Commerce_​指南中的啟用PHP擴充功能。
雲端上的Commerce

下表顯示在雲端平台上部署Adobe Commerce時支援的PHP擴充功能。

table 0-row-3 1-row-3 layout-auto
預設副檔名 安裝的擴充功能無法解除安裝 可視需要安裝和解除安裝的擴充功能
bcmath
bz2
行事曆
exif
gd
gettext
intl
libxml
mysqli
opcache
pcntl
pdo_mysql
反射
soap
通訊端
SPL
standard
Swoole
sysvmsg
sysvsem
sysvshm
zip
zlib		 ctype
curl
日期
dba
dom
檔案資訊
篩選器
ftp
雜湊
iconv
json
mbstring
mysqlnd
openssl
pcre
pdo
pdo_sqlite
phar
posix
readline
工作階段
sqlite3
tokenizer
xml
xmlreader
xmlwriter		 geoip
gmp
igbinary
imagick
imap
ldap
mailparse
mcrypt
msgpack
mysqli
oauth
pdo_mysql
propro
pspell
raphf
重新編碼
redis
shmop通訊端
鈉
ssh2
整齊
xdebug
xmlrpc
xsl
yaml
Commerce內部部署

Adobe Commerce需要：

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-spl
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

Magento Open Source需要：

  • ext-bcmath
  • ext-ctype
  • ext-curl
  • ext-dom
  • ext-fileinfo
  • ext-filter
  • ext-gd
  • ext-hash
  • ext-iconv
  • ext-intl
  • ext-json
  • ext-libxml
  • ext-mbstring
  • ext-openssl
  • ext-pcre
  • ext-pdo_mysql
  • ext-simplexml
  • ext-soap
  • ext-sockets
  • ext-sodium
  • ext-tokenizer
  • ext-xmlwriter
  • ext-xsl
  • ext-zip
  • ext-zlib
  • lib-libxml

如需安裝詳細資訊，請參閱PHP檔案。

其他

本節說明所有其他必要和選用軟體型別的支援與相容性。

NOTE
下列需求適用於Adobe Commerce的最新2.4.x修補程式版本。 相關時，提供雲端基礎結構上的Commerce指引。

瀏覽器

店面和管理：

  • Microsoft Edge （最新和先前的主要版本）
  • Firefox （最新和先前的主要版本；任何作業系統）
  • Chrome （最新和先前的主要版本；任何作業系統）
  • Safari (最新和先前的主要版本；僅限macOS)
  • iOS適用的Safari （店面適用的最新和先前主要版本）
  • 適用於Android的Chrome （店面的最新和先前主要版本）

郵件伺服器

郵件傳輸代理(MTA)或SMTP伺服器。 雲端基礎結構上的Commerce使用SendGrid電子郵件服務。

記憶體

升級從Commerce Marketplace和其他來源取得的應用程式和擴充功能，最多可能需要2 GB的RAM。 如果您使用的系統記憶體小於2 GB，請建立交換檔案；否則，您的升級可能會失敗。

作業系統(Linux x86-64)

Linux發行版本，例如RedHat Enterprise Linux (RHEL)、CentOS、Ubuntu、Debian等。 不支援Microsoft Windows和macOS。

Adobe Commerce的某些作業需要下列系統工具：

SSL

  • HTTPS需要有效的安全性憑證。
  • 不支援自我簽署SSL憑證。
  • 傳輸層安全性(TLS)需求 — PayPal和repo.magento.com都需要TLS 1.2或更新版本。

如需雲端基礎結構上的Commerce，請參閱​ 雲端基礎結構上的Commerce ​指南中的Fastly設定。

Xdebug

若為Adobe Commerce，請使用php_xdebug 2.5.x或更新版本（僅限開發環境；可能會對效能造成不良影響）。

如需雲端上的Adobe Commerce，請參閱​ 雲端基礎結構上的Commerce ​指南中的設定Xdebug。

NOTE
xdebug有已知問題，可能會影響Adobe Commerce安裝或安裝後對店面或管理員的存取。 檢視​_Commerce支援知識庫_​中影響xdebug安裝🔗的已知問題。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995