啟用或停用維護模式
下列指南參考標準維護模式頁面。 如果您需要使用自訂維護頁面,請參閱 建立自訂維護頁面 主題。
Adobe Commerce使用 維護模式 以停用啟動程式。 在維護、升級或重新設定網站時,停用啟動載入功能會很有幫助。
應用程式會偵測維護模式,如下所示:
-
如果
var/.maintenance.flag
不存在,維護模式已關閉且應用程式正常運作。 -
否則,維護模式會開啟,除非
var/.maintenance.ip
「 」已存在。var/.maintenance.ip
可以包含IP位址清單。 如果使用HTTP存取進入點,且使用者端IP位址對應至該清單中的其中一個專案,則維護模式會關閉。
安裝應用程式
使用此命令來啟用或停用維護模式之前,您必須 安裝應用程式.
啟用或停用維護模式
使用 magento maintenance
啟用或停用維護模式的CLI命令。
命令使用方式:
bin/magento maintenance:enable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:disable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:status
此 --ip=<ip address>
選項是免除維護模式(例如進行維護的開發人員)的IP位址。 若要免除相同命令中多個IP位址,請多次使用選項。
--ip=<ip address>
替換為 magento maintenance:disable
儲存IP清單以供稍後使用。 若要清除劐免IP清單,請使用 magento maintenance:enable --ip=none
或參閱 維護劐免IP位址清單.此 bin/magento maintenance:status
命令會顯示維護模式的狀態。
例如,啟用沒有IP位址劐免的維護模式:
bin/magento maintenance:enable
若要為192.0.2.10和192.0.2.11以外的所有使用者端啟用維護模式:
bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11
將應用程式置於維護模式後,您必須停止所有訊息佇列取用者處理作業。
尋找這些程式的一種方式是執行 ps -ef | grep queue:consumers:start
命令,然後執行 kill <process_id>
每個取用者的命令。 在多節點環境中,對每個節點重複此工作。
維護劐免IP位址清單
若要維護劐免IP位址清單,您可以使用 [--ip=<ip list>]
選項,或者您可以使用下列選項:
bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]
此 <ip address> .. <ip address>
語法是可劐免的IP位址清單(選用),以空格分隔。
此 --none
選項會清除清單。
多存放區設定
如果您想要設定多個商店,每個都有不同的版面和當地語系化內容,請傳遞 $_GET['skin']
引數到所要的處理器。
在以下範例中,我們使用 503
輸入錯誤範本檔案,此檔案需要當地語系化的內容。
的建構函式 Error_Processor
類別接受 skin
變更版面的GET引數:
if (isset($_GET['skin'])) {
$this->_setSkin($_GET['skin']);
}
您也可以將此專案新增至中的重寫規則 .htaccess
附加 skin
URL的引數。
$_GET['外觀'] 引數
若要使用 skin
引數:
-
檢查
.maintenance.flag
「 」已存在。 -
記下主機位址,該位址指
HTTP_HOST
或任何其他變數(例如環境變數)。 -
檢查
skin
引數存在。 -
使用下列重寫規則來設定引數。
以下是重寫規則的一些範例:
- RewriteCond
%{DOCUMENT_ROOT}/var/.maintenance.flag -f
- RewriteCond
%{HTTP_HOST} ^sub.example.com$
- RewriteCond
%{QUERY_STRING} !(^|&)skin=sub(&|$)
[NC] - 重寫規則
^ %{REQUEST_URI}?skin=sub
[L]
- RewriteCond
-
複製下列檔案:
pub/errors/default/503.phtml
至pub/errors/sub/503.phtml
pub/errors/default/css/styles.css
至pub/errors/sub/styles.css
-
編輯這些檔案,以在
503.phtml
中的檔案和自訂樣式styles.css
檔案。確保您的路徑指向
errors
目錄。 目錄名稱必須符合URL引數,如RewriteRule
. 在上一個範例中,sub
使用directory,此目錄在RewriteRule
(skin=sub
)