文件Commerce安裝指南

複製範例資料Git存放庫

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

建立對象：

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

本主題說明如何複製Magento Open SourceGitHub存放庫並新增範例資料。 此方法僅適用於參與開發人員(即計畫參與Magento Open Source程式碼基底的開發人員)。

如果您不是貢獻開發人員，請選擇頁面左側目錄中所顯示的其他選項之一。

如果下列情況為真，貢獻開發人員只能使用此方法來安裝範例資料​ 才能使用：

WARNING
您可以將範例資料搭配develop分支（較新）或已發行分支(例如2.4 （較穩定）)使用。 建議您使用已發行的分支，因為其較穩定。 如果您要貢獻程式碼到存放庫，而且需要最新的程式碼，請使用develop分支。 無論您選擇哪個分支，都必須複製Magento Open SourceGitHub存放庫的對應分支。 例如，develop分支的範例資料只能​ 使用 ​和Magento Open Sourcedevelop分支。

複製範例資料存放庫

本節說明如何藉由複製範例資料存放庫來安裝範例資料。 您可以透過下列任何方式複製範例資料存放庫：

使用SSH複製

若要使用SSH通訊協定複製範例資料GitHub存放庫：

  1. 在網頁瀏覽器中，移至範例資料存放庫。

  2. 在分支名稱旁，按一下清單中的​ SSH。

  3. 按一下​ 複製到剪貼簿

    下圖顯示一個範例。

    使用SSH複製GitHub存放庫

  4. 變更至網頁伺服器的docroot目錄。

    通常，對於Ubuntu，這是/var/www；對於CentOS，這是/var/www/html。

  5. 輸入git clone並貼上您先前取得的值。

    範例如下：

    code language-bash 
    git clone git@github.com:magento/magento2-sample-data.git

  6. 等候存放庫在伺服器上複製。

    note note
    NOTE
    如果顯示下列錯誤，請確定您已與GitHub共用SSH金鑰：
    code language-none 
    Cloning into 'magento2'...
Permission denied (publickey).
fatal: The remote end hung up unexpectedly

  7. 請確定您簽出與您在主要magento2存放庫中所使用之分支對應的範例資料存放庫分支。

    例如：

    如果您使用Magento Open SourceGitHub存放庫的2.4-develop分支，範例資料分支應為2.4-develop。

    若要簽出正確的分支，請從範例資料存放庫的根目錄執行下列命令（假設您需要2.4-develop分支）：

    code language-bash 
    git checkout 2.4-develop

  8. 變更為<app_root>。

  9. 輸入下列命令，在您複製的檔案之間建立符號連結，讓範例資料正常運作：

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"

  10. 等待命令完成。

  11. 請參閱設定檔案系統許可權和擁有權。

  12. 執行以下命令：

    code language-bash 
    bin/magento setup:upgrade

使用HTTPS原地複製

若要使用HTTPS通訊協定複製範例資料GitHub存放庫：

  1. 在網頁瀏覽器中，移至範例資料存放庫。

  2. 在頁面右側的​ 複製URL ​欄位下，按一下​ HTTPS。

  3. 按一下​ 複製到剪貼簿。

    下圖顯示一個範例。

    使用HTTPS複製GitHub存放庫

  4. 變更至網頁伺服器的docroot目錄。

    通常，對於Ubuntu，這是/var/www；對於CentOS，這是/var/www/html。

  5. 輸入git clone並貼上您先前取得的值。

    範例如下：

    code language-bash 
    git clone https://github.com/magento/magento2-sample-data.git

  6. 等候存放庫在伺服器上複製。

  7. 請確定您簽出與您在主要magento2存放庫中所使用之分支對應的範例資料存放庫分支。

    例如：

    如果您使用Magento Open SourceGitHub存放庫的2.4-develop分支，範例資料分支應為2.4-develop。

    若要簽出正確的分支，請從範例資料存放庫的根目錄執行下列命令（假設您需要2.4-develop分支）：

    code language-bash 
    git checkout 2.4-develop

  8. 變更為<magento_root>。

  9. 輸入下列命令，在您複製的檔案之間建立符號連結，讓範例資料正常運作：

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="<path_to_your_magento_instance>"

    例如，

    code language-bash 
    php -f <sample-data_clone_dir>/dev/tools/build-sample-data.php -- --ce-source="/var/www/magento2"

  10. 等待命令完成。

  11. 請參閱下一節。

WARNING
如果您在安裝Adobe Commerce 之後安裝範例資料，您也必須執行下列命令來更新資料庫和結構描述：
code language-bash 
<magento_root>/bin/magento setup:upgrade

設定檔案系統擁有權和許可權

由於php build-sample-data.php指令碼會在範例資料存放庫與您的Magento Open Source存放庫之間建立符號連結，因此您必須在範例資料存放庫中設定檔案系統許可權和擁有權。 若未這麼做，會導致存取店面時發生錯誤。

若要設定範例資料存放庫的檔案系統許可權和擁有權：

  1. 變更至範例資料複製目錄。

  2. 設定擁有權：

    code language-bash 
    chown -R :<your web server group name> .

    典型範例：

    • CentOS： chown -R :apache .

    • Ubuntu： chown -R :www-data .

  3. 設定許可權：

    code language-bash 
    find . -type d -exec chmod g+ws {} +

  4. 清除靜態檔案：

    code language-bash 
    cd <your Magento Open Source install dir>
    code language-bash 
    rm -rf var/cache/* var/page_cache/* generated/*

完成範例資料安裝

下載範例資料封裝後，以檔案系統擁有者的身分登入應用程式伺服器或切換至該檔案系統擁有者，並在<app_root>目錄中輸入下列命令：

bin/magento setup:upgrade
recommendation-more-help
0f8e7db5-0e9c-4002-a5b8-a0088077d995