RewritePlugin

重寫要求。

外掛程式實例定義

{
  "name": "RewritePlugin",
  "enabled": true,
  "pluginPath": "~appFolder/plugins/dev-proxy-plugins.dll",
  "configSection": "rewritePlugin"
}

設定範例

{
  "rewritePlugin": {
    "rewritesFile": "rewrites.json"
  }
}

設定屬性

屬性	說明	預設
rewritesFile	包含重寫定義的檔案路徑	rewrites.json

命令列選項

無

重寫檔案範例

以下是重寫規則的範例。

重寫所有從 HTTP 到 HTTPS 的要求

將 HTTP 的所有要求重寫為 HTTPS。 在此內容中， 所有要求都 表示所有設定為 Dev Proxy 或 RewritePlugin 的要求。

{
  "rewrites": [
    {
      "in": {
        "url": "^http://(.*)"
      },
      "out": {
        "url": "https://$1"
      }
    }
  ]
}

模擬檔案屬性

屬性	描述	必要
rewrites	重寫物件的陣列，這些物件會定義 RewritePlugin 套用至其攔截之要求的重寫規則清單	是

重寫物件

每個重寫規則都有下列屬性：

屬性	描述	必要
in	重寫模式 以符合連入要求。	是
out	重寫模式 以重寫要求	是

備註

如果 RewritePlugin 攔截的要求不符合模式中定義的所有屬性，外掛程式就不會將重寫規則套用至要求。

重寫模式

每個重寫模式都有下列屬性：

屬性	描述	必要	預設值	範例值
url	外掛程式套用至 URL 的正規表示式。	是		^http://(.*)

備註

如果您在模式中的 正則表示式中使用擷取群組，您可以在 out 模式中參考它們。 例如，如果您想要重寫 http://example.com/foo 為 https://example.com/foo，您可以使用下列重寫規則：

{
  "in": {
    "url": "^http://(.*)"
  },
  "out": {
    "url": "https://$1"
  }
}