快速入門內部部署安裝

本頁上的指示說明如何在上安裝Adobe Commerce 自行託管 基礎結構。 如需升級現有安裝的指引,請參閱 升級指南.

Adobe使用 作曲者 管理Adobe Commerce元件及其相依性。 使用Composer來取得Adobe Commerce中繼資料具備下列優點:

  • 重複使用協力廠商程式庫,無需搭配原始程式碼使用
  • 使用元件式架構搭配強大的相依性管理,減少擴充功能衝突及相容性問題
  • 遵守 PHP-Framework Interoperability Group (FIG) 標準
  • 使用其他元件重新封裝Magento Open Source
  • 在生產環境中使用Adobe Commerce軟體
NOTE
對Magento Open Source有所貢獻的開發人員 git型 安裝方法。

必要條件

繼續之前,您必須先執行下列動作:

以檔案系統擁有者身分登入

瞭解中的所有權、許可權和檔案系統所有者 所有權與許可權主題概觀.

若要切換到檔案系統擁有者:

  1. 以具有寫入檔案系統許可權的使用者身分登入應用程式伺服器,或切換至該使用者。

    如果您使用bash shell,則可以使用以下語法切換到檔案系統擁有者並同時輸入指令:

    code language-bash
    su <file system owner> -s /bin/bash -c <command>
    

    如果檔案系統擁有者不允許登入,您可以執行下列動作:

    code language-bash
    sudo -u <file system owner>  <command>
    
  2. 若要從任何目錄執行CLI命令,請新增 <app_root>/bin 至您的系統 PATH.

    由於shell有不同的語法,請參閱以下參照 unix.stackexchange.com.

    CentOS的bash shell範例:

    code language-bash
    export PATH=$PATH:/var/www/html/magento2/bin
    

    您可以選擇以下列方式執行指令:

    • cd <app_root>/bin 並以下列身分執行 ./magento <command name>
    • app_root>/bin/magento <command name>
    • <app_root> 是網頁伺服器docroot的子目錄

取得中繼資料

若要取得Adobe Commerce中繼資料:

  1. 以或切換方式登入應用程式伺服器 檔案系統擁有者.

  2. 變更至Web伺服器docroot目錄,或您設定為虛擬主機docroot的目錄。

  3. 使用Commerce中繼資料建立撰寫器專案。

    Magento Open Source

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

    Adobe Commerce

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

    出現提示時,輸入您的驗證金鑰。 公開和私密金鑰是在以下位置建立和設定的: Commerce Marketplace.

    note note
    NOTE
    使用撰寫器時 auth.json 檔案或環境變數,系統不會提示您輸入驗證金鑰。

    如果您遇到錯誤,例如 Could not find package......no matching package found,請確定您的命令中沒有拼寫錯誤。 如果您仍然遇到錯誤,您可能無權下載Adobe Commerce。 連絡人 Adobe Commerce支援 以取得協助。

    另請參閱 疑難排除 以取得更多錯誤的說明。

範例 — 次要版本

次要發行包含新功能、品質修正和安全性修正。 使用Composer指定次要版本。 例如,若要指定Adobe Commerce 2.4.6中繼資料:

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

範例 — 品質修補程式

品質修補程式主要包含功能性 安全性修正。 不過,它們有時也可能包含向後相容的新功能。 使用Composer下載品質修補程式。 例如,若要指定Adobe Commerce 2.4.6中繼資料:

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

範例 — 安全性修補程式

安全性修補程式僅包含安全性修正。 這些設定可讓升級程式更快、更輕鬆。

安全性修補程式使用撰寫器命名慣例 2.4.6-px. 使用Composer指定修補程式。 例如,若要下載Adobe Commerce 2.4.6-p1中繼資料:

composer create-project --repository-url=https://repo.magento.com/ magento/project-enterprise-edition=2.4.6-p1 <install-directory-name>

設定檔案許可權

您必須先設定網頁伺服器群組的讀寫許可權,才能安裝Adobe Commerce。 這是必要的,以便命令列可以將檔案寫入檔案系統。

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

安裝應用程式

您必須使用命令列安裝Adobe Commerce。

此範例假設安裝目錄名為 magento2ee,則 db-host 在同一部電腦上(localhost),且 db-namedb-user、和 db-password 全部 magento

bin/magento setup:install \
--base-url=http://localhost/magento2ee \
--db-host=localhost \
--db-name=magento \
--db-user=magento \
--db-password=magento \
--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=opensearch \
--opensearch-host=os-host.example.com \
--opensearch-port=9200 \
--opensearch-index-prefix=magento2 \
--opensearch-timeout=15
TIP
您可以使用以下自訂管理員URI --backend-frontname 選項。 不過,Adobe建議省略此選項,並允許安裝命令自動產生隨機URI。 對於駭客或惡意軟體而言,隨機URI更難被利用。 安裝完成時,URI會顯示在主控台中。
TIP
如需CLI安裝選項的完整說明,請參閱 從命令列安裝應用程式.

命令摘要

若要顯示完整的命令清單,請輸入:

bin/magento list

若要取得特定指令的說明,請輸入:

bin/magento help <command>

例如:

bin/magento help setup:install
bin/magento help cache:enable

下表總結了可用的命令。 命令僅以摘要形式顯示。 如需命令的詳細資訊,請按一下「命令」欄中的連結。

命令
說明
必要條件
magento setup:install
安裝應用程式
magento setup:uninstall
移除應用程式。
已安裝應用程式
magento setup:upgrade
更新應用程式。
部署設定
magento maintenance:{enable/disable}
啟用或停用維護模式(在維護模式中,只有劐免IP地址可以存取管理員或店面)。
已安裝應用程式
magento setup:config:set
建立或更新部署設定。
magento module:{enable/disable}
啟用或停用模組。
magento setup:store-config:set
設定店面相關選項,例如基本URL、語言、時區。
部署設定
magento setup:db-schema:upgrade
更新資料庫結構。
部署設定
magento setup:db-data:upgrade
更新資料庫資料。
部署設定
magento setup:db:status
檢查資料庫是否使用最新的程式碼。
部署設定
magento admin:user:create
建立管理員使用者。
您可以建立下列專案的使用者:

部署設定

至少啟用 Magento_UserMagento_Authorization 模組

資料庫(最簡單的方式是使用 bin/magento setup:upgrade)
magento list
列出所有可用的命令。
magento help
提供指定命令的說明。

通用引數

以下引數是所有命令通用的引數。 這些命令可以在應用程式安裝之前或之後執行:

長版本
簡短版本
含義
--help
-h
取得任何命令的說明。 例如, ./magento help setup:install./magento help setup:config:set.
--quiet
-q
安靜模式;無輸出。
--no-interaction
-n
無互動式問題。
--verbose=1,2,3
-v, -vv, -vvv
詳細程度。 例如, --verbose=3-vvv 顯示除錯詳細資訊,這是最詳細的輸出。 預設為 --verbose=1-v.
--version
-V
顯示此應用程式版本
--ansi
不適用
強制ANSI輸出
--no-ansi
不適用
停用ANSI輸出
NOTE
恭喜!您已完成快速安裝。 需要更進階的協助嗎? 檢視 進階安裝 指南。
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995