ext-plugin-pre-req

Summary

Name

The ext-plugin-pre-req runs specific external plugins in the plugin runner, before executing most of the builtin Lua plugins.

To know what is the plugin runner, see external plugin section.

The result of external plugins execution will affect the behavior of the current request.

Attributes

NameTypeRequirementDefaultValidDescription
confarrayoptional[{“name”: “ext-plugin-A”, “value”: “{\”enable\”:\”feature\”}”}]The plugins list which will be executed at the plugin runner with their configuration

How To Enable

Here’s an example, enable this plugin on the specified route:

  1. curl -i http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3.     "uri": "/index.html",
  4.     "plugins": {
  5.         "ext-plugin-pre-req": {
  6.             "conf" : [
  7.                 {"name": "ext-plugin-A", "value": "{\"enable\":\"feature\"}"}
  8.             ]
  9.     },
  10.     "upstream": {
  11.         "type": "roundrobin",
  12.         "nodes": {
  13.             "39.97.63.215:80": 1
  14.         }
  15.     }
  16. }'

Test Plugin

Use curl to access:

  1. curl -i http://127.0.0.1:9080/index.html

You will see the configured plugin runner will be hit and plugin ext-plugin-A is executed at that side.

Disable Plugin

When you want to disable this plugin, it is very simple, you can delete the corresponding json configuration in the plugin configuration, no need to restart the service, it will take effect immediately:

  1. curl http://127.0.0.1:9080/apisix/admin/routes/1  -H 'X-API-KEY: edd1c9f034335f136f87ad84b625c8f1' -X PUT -d '
  2. {
  3.     "uri": "/index.html",
  4.     "upstream": {
  5.         "type": "roundrobin",
  6.         "nodes": {
  7.             "39.97.63.215:80": 1
  8.         }
  9.     }
  10. }'

This plugin has been disabled now. It works for other plugins.