Web屬性

web屬性定義您的應用程式如何向網頁公開(在HTTP中)、決定網頁應用程式如何提供內容,以及透過在每個位置​ 區塊 ​中設定規則來控制應用程式容器如何回應傳入的要求。 區塊代表以正斜線(/)開頭的絕對路徑。

web:
    locations:
        "/":
            # The public directory of the app, relative to its root.

您可以使用每個locations區塊的下列索引鍵值來微調locations組態:

屬性
說明
allow
提供不符合「規則」的檔案。 預設值= true
expires
設定要在瀏覽器中快取內容的秒數。 此金鑰可啟用靜態內容的cache-controlexpires標頭。 如果未設定此值,則在提供靜態內容檔案時,不會包含expires指示詞和產生的標頭。 負1 (-1)值會導致無快取,而且是預設值。 您可以使用下列單位來表示時間值: ms (毫秒)、s (秒)、m (分鐘)、h (小時)、d (天)、w (周)、M (月、30天)或y (年、365天)
headers
針對從這個位置提供的靜態內容,設定自訂標頭,例如X-Frame-Options
index
列出要提供給應用程式的靜態檔案,例如index.html檔案。 此索引鍵必須是集合。 只有在此位置的allowrules金鑰「允許」存取一或多個檔案時,才能使用此功能。
rules
指定位置的覆寫。 使用規則運算式來比對請求。 如果傳入的請求符合規則,則規則的索引鍵會覆寫對請求的一般處理。
passthru
設定在找不到靜態檔案或PHP檔案時使用的URL。 一般而言,此URL是您應用程式(例如/index.php/app.php)的前端控制器。
root
設定相對於在網頁上公開之應用程式根目錄的路徑。 雲端專案的公用目錄(位置"/")預設為「pub」。
scripts
允許在此位置載入指令碼。 將值設定為true以允許指令碼。

預設設定允許以下專案:

  • 從根(/)路徑,只能存取網頁和媒體
  • ~/pub/static~/pub/media路徑中,可存取任何檔案

下列範例顯示.magento.app.yaml檔案中,與mounts屬性中的專案相關的一組網頁可存取位置的預設設定:

 # The configuration of app when it is exposed to the web.
web:
    locations:
        "/":
            # The public directory of the app, relative to its root.
            root: "pub"
            # The front-controller script to send non-static requests to.
            passthru: "/index.php"
            index:
                - index.php
            expires: -1
            scripts: true
            allow: false
            rules:
                \.(css|js|map|hbs|gif|jpe?g|png|tiff|wbmp|ico|jng|bmp|svgz|midi?|mp?ga|mp2|mp3|m4a|ra|weba|3gpp?|mp4|mpe?g|mpe|ogv|mov|webm|flv|mng|asx|asf|wmv|avi|ogx|swf|jar|ttf|eot|woff|otf|html?)$:
                    allow: true
                ^/sitemap(.*)\.xml$:
                    passthru: "/media/sitemap$1.xml"
        "/media":
            root: "pub/media"
            allow: true
            scripts: false
            expires: 1y
            passthru: "/get.php"
        "/static":
            root: "pub/static"
            allow: true
            scripts: false
            expires: 1y
            passthru: "/front-static.php"
            rules:
                ^/static/version\d+/(?<resource>.*)$:
                    passthru: "/static/$resource"
NOTE
此範例顯示雲端專案的預設Web設定,該專案設定為支援單一網域。 針對需要支援多個網站或商店的專案,web設定必須設定為支援共用網域。 請參閱設定共用網域的位置
recommendation-more-help
05f2f56e-ac5d-4931-8cdb-764e60e16f26