文件Commerce安裝指南

安裝Adobe Commerce

Last update: Thu Apr 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Experienced
  • Admin
  • Developer

開始之前，請完成下列步驟：

NOTE
您必須從其安裝應用程式 bin 子目錄。

您可以使用不同的選項多次執行安裝程式，以完成如下的安裝工作：

  • 分階段安裝 — 例如，在為Secure Sockets Layer (SSL)設定Web伺服器後，您可以再次執行安裝程式來設定SSL選項。

  • 更正先前安裝中的錯誤。

  • 在其他資料庫執行處理中安裝應用程式。

NOTE
如果您在相同資料庫執行個體中安裝Commerce軟體，預設情況下安裝程式不會覆寫資料庫。 您可以使用選填的 cleanup-database 引數來變更此行為。

另請參閱 更新、重新安裝、解除安裝.

安全安裝

若要針對管理員和店面使用安全通訊端層(SSL) （也稱為HTTPS），您必須設定下列所有引數：

  • --use-secure：將設為 1
  • --base-url-secure：設為安全URL (亦即，從 https://)
  • --use-secure-admin 將設為 1

有關這些引數的更多詳細資訊，請參閱本主題稍後的章節。

安裝程式說明命令

您可以執行下列命令來尋找某些必要引數的值：

安裝程式引數
命令
語言
magento info:language:list
貨幣
magento info:currency:list
時區
magento info:timezone:list
NOTE
如果執行這些命令時出現錯誤，請確認您已更新安裝相依性，如中所述 更新安裝相依性.

從命令列安裝

install指令會使用以下格式：

magento setup:install --<option>=<value> ... --<option>=<value>

下表說明安裝選項名稱和值，例如安裝命令。 另請參閱 localhost安裝範例.

NOTE
包含空格或特殊字元的任何選項都必須用單引號或雙引號括住。

管理員認證：

下列選項指定管理員使用者的使用者資訊和認證。

在Adobe Commerce 2.2.8版及更新版本中，您可以在安裝期間或之後建立管理員使用者。 如果您在安裝期間建立使用者，則需要所有管理員認證變數。 另請參閱 localhost安裝範例.

名稱
值
必填？
--admin-firstname
管理員使用者的名字。
是
--admin-lastname
管理員使用者的姓氏。
是
--admin-email
管理員使用者的電子郵件地址。
是
--admin-user
管理員使用者名稱。
是
--admin-password
管理員使用者密碼。 密碼長度必須至少為7個字元，且必須至少包含一個字母和至少一個數字字元。 我們建議使用更長、更複雜的密碼。 以單引號括住整個密碼字串。 例如， --admin-password='A0b9%t3g'
是

站台和資料庫組態選項：

名稱
值
必填？
--base-url
用於以下列任何格式存取管理員和店面的基底URL：

http[s]://<host or ip>/<your install dir>/.

注意： 配置(http://或https://)和結尾斜線都是必要的。

<your install dir> 是安裝應用程式的docroot相對路徑。 根據您設定網頁伺服器和虛擬主機的方式，路徑可能是magento2或可能為空白。

若要存取localhost上的應用程式，您可以使用 http://127.0.0.1/<your install dir>/ 或 http://127.0.0.1/<your install dir>/.

- {{base_url}} 代表虛擬主機設定或虛擬化環境（如Docker）定義的基本URL。 例如，如果您以主機名稱commerce.example.com設定虛擬主機，則可安裝應用程式並搭配使用 --base-url={{base_url}} 並使用類似的URL存取管理員 http://commerce.example.com/admin.
是
--backend-frontname
用於存取管理員的統一資源識別碼(URI)。 您可以省略此引數，讓應用程式為您產生隨機URI，其模式如下 admin_jkhgdfq.

基於安全考量，建議您使用隨機URI。 對於駭客或惡意軟體而言，隨機URI更難被利用。

URI會在安裝結束時顯示。 您稍後隨時可以使用 magento info:adminuri 命令。

如果您選擇輸入值，建議您不要使用常見的字詞，例如admin、backend。 管理員URI可包含英數字元和底線字元(_)。
否
--db-host
使用下列任一項：

— 資料庫伺服器的完整主機名稱或IP位址。

- localhost （預設）或 127.0.0.1 如果您的資料庫伺服器與Web伺服器位於相同的主機上。localhost表示MySQL使用者端程式庫使用UNIX通訊端連線到資料庫。 127.0.0.1 導致使用者端程式庫使用TCP通訊協定。 如需通訊端的詳細資訊，請參閱 PHP PDO_MYSQL檔案.

注意： 您可以選擇在其主機名稱中指定資料庫伺服器連線埠，例如www.example.com:9000
是
--db-name
您要安裝資料庫表格的資料庫執行處理名稱。

預設為 magento2.
是
--db-user
資料庫執行處理擁有者的使用者名稱。

預設為 root.
是
--db-password
資料庫執行處理擁有者的密碼。
是
--db-prefix
只有在您要在已經有Adobe Commerce表格的資料庫執行個體中安裝資料庫表格時才使用。

在此情況下，請使用前置字元來識別此安裝的表格。 有些客戶在含有相同資料庫中所有表格的伺服器上執行多個Adobe Commerce執行個體。

首碼的長度最多可為5個字元。 它必須以字母開頭，並且只能包含字母、數字和下劃線字元。

此選項可讓這些客戶透過一個以上的安裝共用資料庫伺服器。
否
--db-ssl-key
使用者端金鑰的路徑。
否
--db-ssl-cert
使用者端憑證的路徑。
否
--db-ssl-ca
伺服器憑證的路徑。
否
--language
在管理員和店面中使用的語言代碼。 (如果您尚未這樣做，您可以輸入語言代碼來檢視語言代碼清單 magento info:language:list 從bin目錄。)
否
--currency
店面中使用的預設貨幣。 (如果尚未這樣做，您可以輸入貨幣來檢視貨幣清單 magento info:currency:list 從bin目錄。)
否
--timezone
在管理員和店面中使用的預設時區。 (如果尚未這樣做，您可以輸入「 」，檢視時區清單 magento info:timezone:list 從bin目錄。)
否
--use-rewrites
1 表示您對店面和管理程式中產生的連結使用網頁伺服器重寫。

0 停用使用web伺服器重寫。 這是預設值。
否
--use-secure
1 允許在店面URL中使用安全通訊端層(SSL)。 在選取此選項之前，請確定您的網頁伺服器支援SSL。

0 停用SSL。 在此情況下，所有其他安全URL選項也假設為0。 這是預設值。
否
--base-url-secure
安全基底URL，用於以下列格式存取您的管理員和店面： http[s]://<host or ip>/<your install dir>/
否
--use-secure-admin
1 表示您使用SSL來存取管理員。 在選取此選項之前，請確定您的網頁伺服器支援SSL。

0 表示您未對管理員使用SSL。 這是預設值。
否
--admin-use-security-key
1會使得應用程式使用隨機產生的索引鍵值來存取管理員和表單中的頁面。 這些金鑰值有助於防止跨網站指令碼偽造攻擊。 這是預設值。

0 停用金鑰。
否
--session-save
使用下列任一項：

- db 將工作階段資料儲存在資料庫中。 如果您有叢集資料庫，請選擇資料庫儲存體；否則，與檔案式儲存體相比，可能不會有多大好處。

- files 將工作階段資料儲存在檔案系統中。 除非檔案系統存取緩慢、您有叢集資料庫，或您想要將工作階段資料儲存在Redis中，否則檔案式工作階段儲存體是適當的。

- redis 將工作階段資料儲存在Redis。 如果您使用Redis作為預設或頁面快取，則必須已安裝Redis。 如需設定對Redis支援的其他資訊，請參閱使用工作階段儲存體的Redis 。
否
--key
如果您有金鑰，請指定金鑰以加密資料庫中的敏感資料。 如果您沒有，應用程式會為您產生一個。
是
--cleanup-database
若要在安裝應用程式之前刪除資料庫表格，請指定此引數，不要使用值。 否則，資料庫將保持不變。
否
--db-init-statements
進階MySQL設定引數。 在連線到MySQL資料庫時，使用資料庫初始化陳述式來執行。 在設定任何值之前，請查閱與此類似的參考。

預設為 SET NAMES utf8;.
否
--sales-order-increment-prefix
指定字串值做為銷售訂單的前置詞。 通常，這是用來保證付款處理程式的唯一訂單編號。
否
TIP
若要在安裝期間啟用遠端儲存服務，請參閱 設定遠端儲存 在 設定指南.

搜尋引擎設定選項：

名稱
值
必填？
--search-engine
搜尋引擎的版本。 可能的值包括 elasticsearch7， elasticsearch6、和 elasticsearch5. 預設值為 elasticsearch7. 如果您已安裝OpenSearch做為搜尋引擎，請指定值 elasticsearch7. Elasticsearch5已過時，不建議使用。
否
--elasticsearch-host
執行搜尋引擎的主機名稱或IP位址。 預設值為 localhost.
否
--elasticsearch-port
傳入HTTP要求的連線埠。 預設值為 9200.
否
--elasticsearch-index-prefix
識別搜尋索引的前置詞。 預設值為 magento2.
否
--elasticsearch-timeout
系統逾時前的秒數。 預設值為 15.
否
--elasticsearch-enable-auth
啟用搜尋引擎伺服器上的驗證。 預設值為 false.
否
--elasticsearch-username
用於驗證的使用者ID
否，除非啟用驗證
--elasticsearch-password
用於驗證的密碼
否，除非啟用驗證

RabbitMQ設定選項：

名稱
值
必填？
--amqp-host
請勿使用 --amqp 選項，除非您已設定 RabbitMQ. 另請參閱 RabbitMQ installation以取得關於安裝和設定的詳細資訊 RabbitMQ.

主機名稱，其中 RabbitMQ 已安裝。
否
--amqp-port
用來連線的連線埠 RabbitMQ. 預設值為5672。
否
--amqp-user
連線至的使用者名稱 RabbitMQ. 不要使用預設使用者 guest.
否
--amqp-password
用於連線的密碼 RabbitMQ. 不要使用預設密碼 guest.
否
--amqp-virtualhost
用於連線的虛擬主機 RabbitMQ. 預設值為 /.
否
--amqp-ssl
指示是否連線到 RabbitMQ. 預設值為 false. 另請參閱 RabbitMQ 以取得關於設定SSL的資訊 RabbitMQ.
否
--consumers-wait-for-messages
消費者是否應該等候佇列中的訊息？ 1 — 是，0 — 否
否

遠端儲存選項：

名稱
說明
必填？
remote-storage-driver
介面卡名稱
可能的值：
檔案：停用遠端儲存並使用本機檔案系統​
aws-s3：使用 Amazon Simple Storage Service (Amazon S3)
否
remote-storage-bucket
物件儲存或容器名稱
否
remote-storage-prefix
選擇性首碼（物件儲存內的位置）
否
remote-storage-region
區域名稱
否
remote-storage-key
選用的存取金鑰
否
remote-storage-secret
選擇性秘密金鑰
否

鎖定組態選項：

名稱
值
必填？
--lock-provider
鎖定提供者名稱。

可用的鎖定提供者： db， zookeeper， file.

預設鎖定提供者： db
否
--lock-db-prefix
使用時避免鎖定衝突的特定資料庫首碼 db 鎖定提供者。

預設值： NULL
否
--lock-zookeeper-host
使用時連線至Zookeeper叢集的主機與連線埠 zookeeper 鎖定提供者。

例如： 127.0.0.1:2181
是，如果您設定 --lock-provider=zookeeper
--lock-zookeeper-path
Zookeeper儲存鎖定的路徑。

預設路徑為： /magento/locks
否
--lock-file-path
儲存檔案鎖定的路徑。
是，如果您設定 --lock-provider=file

消費者設定選項：

名稱
說明
值
必填
--consumers-wait-for-messages
決定消費者是否會等待來自佇列的訊息。
1 — 是，0 — 否
否

  • 0：取用者處理佇列中的可用訊息、關閉TCP連線並終止。 即使已處理的訊息數量少於 --max_messages 啟動消費者期間指定的值。

  • 1：消費者會繼續處理來自訊息佇列的訊息，直到達到訊息數量上限（為指定的值）為止 --max_messages 於 queue:consumers:start 命令)，然後關閉TCP連線並終止取用者處理序。 如果佇列在到達之前排空 --max_messages 消費者會等待更多訊息到達。 如果您使用背景工作來執行消費者，而不是使用cron工作，請將此變數設為 1.

WARNING
此 --consumers-wait-for-messages 選項是全域選項，無法為每個取用者個別設定。
NOTE
若要在安裝應用程式後啟用或停用模組，請參閱 啟用和停用模組.

敏感資料：

Adobe Commerce會使用您的加密金鑰來加密下列專案：

  • 信用卡資訊
  • 在管理員設定中指定的使用者名稱和密碼（例如，登入付款閘道）
  • 透過網路傳送的驗證碼值

Adobe Commerce do 非 加密：

  • 管理和客戶使用者名稱及密碼（這些密碼會經過雜湊處理）
  • 地址
  • 電話號碼
  • 除信用卡號碼以外的其他個人識別資訊

localhost安裝範例

下列範例顯示使用各種選項在本機安裝Adobe Commerce的命令。

範例1 — 使用管理員使用者帳戶進行基本安裝

下列範例會安裝具有以下選項的應用程式：

  • 應用程式安裝在 magento2 與docroot開啟的網頁伺服器相關的目錄 localhost 管理員的路徑為 admin；因此：

    您的店面URL為 http://127.0.0.1

  • 資料庫伺服器與Web伺服器位於相同的主機上。

    資料庫名稱為 magento，且使用者名稱和密碼都是 magento

  • 使用伺服器重寫

  • 管理員具有下列屬性：

    • 名字和姓氏為 Commerce User
    • 使用者名稱為 admin 密碼是 admin123
    • 電子郵件地址為 user@example.com

  • 預設語言為 en_US （美式英文）

  • 預設貨幣為美元

  • 預設時區為美國中部（美洲/芝加哥）

  • Elasticsearch7安裝在 es-host.example.com 並在連線埠9200上連線

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.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

類似下列顯示以指示成功安裝的訊息：

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

範例2 — 沒有管理員使用者帳戶的基本安裝

您可以安裝應用程式，而不需建立管理員使用者，如下列範例所示。

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--language=en_US --currency=USD --timezone=America/Chicago --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200

如果安裝成功，會顯示類似下列的訊息：

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q

安裝後，您可以使用以下專案建立管理員使用者 admin:user:create 命令：
建立或編輯管理員

範例3 — 使用其他選項安裝

下列範例會安裝具有以下選項的應用程式：

  • Magapplication安裝在 magento2 與docroot開啟的網頁伺服器相關的目錄 localhost 管理員的路徑為 admin；因此：

    您的店面URL為 http://127.0.0.1

  • 資料庫伺服器與Web伺服器位於相同的主機上。

    資料庫名稱為 magento，且使用者名稱和密碼都是 magento

  • 管理員具有下列屬性：

    • 名字和姓氏為 Commerce User
    • 使用者名稱為 admin 密碼是 admin123
    • 電子郵件地址為 user@example.com

  • 預設語言為 en_US （美式英文）

  • 預設貨幣為美元

  • 預設時區為美國中部（美洲/芝加哥）

  • 安裝程式先清除資料庫，再安裝資料表和綱要

  • 您使用 ORD$ 銷售訂單增量字首（因為它包含特殊字元） [$]，值必須括在雙引號中)

  • 工作階段資料儲存在資料庫中

  • 使用伺服器重寫

  • Elasticsearch7安裝在 es-host.example.com 並在連線埠9200上連線

magento setup:install --base-url=http://127.0.0.1/magento2/ \
--db-host=localhost --db-name=magento --db-user=magento --db-password=magento \
--admin-firstname=Commerce --admin-lastname=User --admin-email=user@example.com \
--admin-user=admin --admin-password=admin123 --language=en_US \
--currency=USD --timezone=America/Chicago --cleanup-database \
--sales-order-increment-prefix="ORD$" --session-save=db --use-rewrites=1 \
--search-engine=elasticsearch7 --elasticsearch-host=es-host.example.com \
--elasticsearch-port=9200
NOTE
您必須在單行上輸入指令，或者如前例所示，使用 \ 字元於每行結尾。

如果安裝成功，會顯示類似下列的訊息：

Post installation file permissions check...
For security, remove write permissions from these directories: '/var/www/html/magento2/app/etc'
[Progress: 274 / 274]
[SUCCESS]: Magento installation complete.
[SUCCESS]: Admin Panel URI: /admin_puu71q
TIP
如果您有一個使用者帳戶可存取應用程式伺服器，請參閱 設定umask. 此類設定是共用託管的典型設定。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995