部署靜態檢視檔案

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

主題：
設定

建立對象：

經驗豐富
管理員
開發人員

WARNING

所有MagentoCLI命令都必須由檔案系統擁有者執行。

靜態檢視檔案部署命令可讓您在Commerce軟體設定為生產模式時，將靜態檔案寫入Commerce檔案系統。

術語 靜態檢視檔案 參考以下內容：

「靜態」表示它可以針對網站進行快取（也就是說，檔案不會動態產生）。範例包括從LESS產生的影像和CSS。
「檢視」是指表示層（來自MVC）。

靜態檢視檔案位於<magento_root>/pub/static目錄中，部分檔案也快取在<magento_root>/var/view_preprocessed目錄中。

靜態檢視檔案部署會受應用程式模式影響，如下所示：

預設和開發人員模式： Commerce會隨選產生這些模式，但其餘模式會快取到檔案中，以加快存取速度。
生產模式：靜態檔案不是產生或快取。

您必須使用本主題中討論的命令，手動將靜態檢視檔案寫入Commerce檔案系統；之後，您可以限制許可權以限制漏洞，並防止意外或惡意覆寫檔案。

WARNING

僅限開發人員模式：當您安裝或啟用新模組時，可能會載入新的JavaScript、CSS、版面配置等。為避免靜態檔案發生問題，您必須清除舊檔案，以確保您取得新模組的所有變更。您可以用數種方式清除產生的靜態檢視檔案。如需詳細資訊，請參閱清除靜態檔案快取主題。

若要部署靜態檢視檔案：

以身分登入Commerce伺服器，或切換到檔案系統擁有者。
刪除<magento_root>/pub/static的內容（.htaccess檔案除外）。請勿刪除此檔案。

執行靜態檢視檔案部署工具<magento_root>/bin/magento setup:static-content:deploy。

note info
INFO
如果您在Admin中啟用靜態檢視檔案合併，則`pub/static`目錄系統必須為可寫入。

命令選項：

code language-bash

code language-bash
`bin/magento setup:static-content:deploy [<languages>] [-t\|--theme[="<theme>"]] [--exclude-theme[="<theme>"]] [-l\|--language[="<language>"]] [--exclude-language[="<language>"]] [-a\|--area[="<area>"]] [--exclude-area[="<area>"]] [-j\|--jobs[="<number>"]] [--no-javascript] [--no-css] [--no-less] [--no-images] [--no-fonts] [--no-html] [--no-misc] [--no-html-minify] [--no-parent] [-f\|--force]`

bin/magento setup:static-content:deploy [<languages>] [-t|--theme[="<theme>"]] [--exclude-theme[="<theme>"]] [-l|--language[="<language>"]] [--exclude-language[="<language>"]] [-a|--area[="<area>"]] [--exclude-area[="<area>"]] [-j|--jobs[="<number>"]]  [--no-javascript] [--no-css] [--no-less] [--no-images] [--no-fonts] [--no-html] [--no-misc] [--no-html-minify] [--no-parent] [-f|--force]

下表說明此命令的引數和值。

選項

說明

必填？

<languages>

要輸出靜態檢視檔案的ISO-639語言代碼清單（以空格分隔）。（預設值為en_US。）
執行以尋找清單： bin/magento info:language:list

否

--language (-l)

只產生指定語言的檔案。預設為產生所有ISO-639語言代碼的檔案，但未指定選項。您可以一次指定一個語言代碼的名稱。預設值為 all。
例如： --language en_US --language es_ES

否

--exclude-language

產生指定語言代碼的檔案。預設值為不排除任何專案，未指定選項。您可以指定一個語言代碼的名稱，或以逗號分隔的語言代碼清單。預設值為 none。

否

--theme <theme>

要部署靜態內容的主題。預設值為 all。
例如： --theme Magento/blank --theme Magento/luma

否

--exclude-theme <theme>

部署靜態內容時要排除的主題。預設值為 none。
例如，--exclude-theme Magento/blank

否

--area (-a)

只產生指定區域的檔案。預設值是不指定任何選項，為所有的區域產生檔案。有效值為adminhtml和frontend。預設值為 all。
例如： --area adminhtml

否

--exclude-area

不要產生指定區域的檔案。預設值為不排除任何專案，未指定選項。預設值為 none。

否

--jobs (-j)

使用指定的工作數目啟用平行處理。預設值為0 （不要在平行處理程式中執行）。預設值為 0。

否

--symlink-locale

為這些區域設定的檔案建立符號連結，這些檔案會傳遞以進行部署，但沒有自訂。

否

--content-version=CONTENT-VERSION

如果在多個節點上執行部署，則可以使用靜態內容的自訂版本，以確保靜態內容版本相同且快取可正常運作。

否

--no-javascript

不要部署JavaScript檔案

否

--no-css

請勿部署CSS檔案。

否

--no-less

請勿部署LESS檔案。

否

--no-images

請勿部署影像。

否

--no-fonts

不要部署字型檔案。

否

--no-html

請勿部署HTML檔案。

否

--no-misc

請勿部署其他型別的檔案：MD、JBF、CSV、JSON、TXT、HTC、SWF

否

--no-html-minify

請勿縮制HTML檔案。

否

-s <quick|standard|compact>

定義部署策略。只有在您有多個本機時，才使用這些選項。

使用快速策略以最小化部署時間。如果未指定，則這是預設的命令選項。
使用標準策略為所有封裝部署所有靜態檢視檔案。
使用壓縮策略節省伺服器上的磁碟空間。

否

--no-parent

不要為目前主題的父主題產生檔案。如果您未明確使用嘗試部署的目前主題的父主題，強烈建議您使用此標幟。這會大幅提升處理速度。 Commerce 2.4.2提供此標幟

否

--force (-f)

以任何模式部署檔案。 (根據預設，靜態內容部署工具只能在生產模式下執行。使用此選項可在預設或開發人員模式下執行)。

否

INFO

如果您同時指定<languages>和--language的值，則會以<languages>優先。

範例

以下是一些命令範例。

排除主題和HTML縮制

下列命令會部署美式英文(en_US)語言的靜態內容、排除Commerce提供的Luma主題，且不會縮小HTML檔案。

bin/magento setup:static-content:deploy en_US --exclude-theme Magento/luma --no-html-minify

範例輸出：

Requested languages: en_US
Requested areas: frontend, adminhtml
Requested themes: Magento/blank, Magento/backend
=== frontend -> Magento/blank -> en_US ===
=== adminhtml -> Magento/backend -> en_US ===
...........................................................
... more ...
Successful: 2055 files; errors: 0
---

New version of deployed files: 1466710645
............
Successful: 1993 files; errors: 0
---

以下命令只會使用標準部署策略部署JavaScript （4個工作）：

bin/magento setup:static-content:deploy -s standard --no-misc --no-html --no-fonts --no-images --no-less --no-css -j 4

以下命令只會部署CSS和LESS，並包含3個作業及快速部署策略：

bin/magento setup:static-content:deploy -s quick --no-misc --no-html --no-fonts --no-images --no-javascript -j 3

產生一個主題和一個區域的靜態檢視檔案

下列指令會針對所有語言產生靜態檢視檔案，僅前端區域，僅Commerce Luma主題，而不會產生字型：

bin/magento setup:static-content:deploy --area frontend --no-fonts --theme Magento/luma

範例輸出：

Requested languages: en_US
Requested areas: frontend
Requested themes: Magento/luma
=== frontend -> Magento/luma -> en_US ===
...........................................................
... more ...
........................................................................
Successful: 2092 files; errors: 0
---

New version of deployed files: 1466711110

部署靜態檢視檔案而不安裝Commerce

您可能會想要在單獨的非生產環境中執行部署流程，以避免在敏感的生產機器上執行任何建置流程。

若要這麼做，請執行下列步驟：

執行bin/magento app:config:dump以從您的生產系統匯出組態。
將匯出的檔案複製到非生產程式碼基底。
部署靜態檢視檔案： bin/magento setup:static-content:deploy

疑難排解靜態檢視檔案部署工具

請先安裝Commerce軟體；否則，您無法執行靜態檢視檔案部署工具。

症狀：當您執行靜態檢視檔案部署工具時，會顯示下列錯誤：

ERROR: You need to install the Commerce application before running this utility.

解決方案：

使用下列步驟：

使用命令列安裝Commerce軟體。
以檔案系統擁有者的身分登入應用程式伺服器，或切換至。
刪除<app_root>/pub/static目錄的內容（.htaccess檔案除外）。請勿刪除此檔案。
部署靜態檢視檔案： bin/magento setup:static-content:deploy

開發人員自訂靜態內容部署工具的秘訣

建立靜態內容部署工具的自訂實作時，請只使用使用者端上應可用的檔案的原子檔案寫入。如果您使用非原子檔案寫入，這些檔案可能會載入含有部分內容的使用者端。

使其成為原子化的選項之一，是在寫入結束後寫入儲存在暫存目錄中的檔案，並將它們複製或移動至目的地目錄（從載入至使用者端的目錄）。如需有關寫入檔案的詳細資訊，請參閱php fwrite。

recommendation-more-help

386822bd-e32c-40a8-81c2-ed90ad1e198c