Skip to content

doc: clarify run-plugin argument is fixed at load time#13429

Open
maskit wants to merge 1 commit into
apache:masterfrom
maskit:doc-run-plugin-static-args
Open

doc: clarify run-plugin argument is fixed at load time#13429
maskit wants to merge 1 commit into
apache:masterfrom
maskit:doc-run-plugin-static-args

Conversation

@maskit

@maskit maskit commented Jul 25, 2026

Copy link
Copy Markdown
Member

The run-plugin action's plugin-argument is parsed once when the rule loads, like a remap.config argument, and is never re-evaluated per request, so variable interpolation (e.g. %{HEADER:bar}) does not work there.

The run-plugin action's plugin-argument is parsed once when the
rule loads, like a remap.config argument, and is never
re-evaluated per request, so variable interpolation (e.g.
%{HEADER:bar}) does not work there.
@maskit
maskit requested a review from zwoop July 25, 2026 03:10
@maskit maskit self-assigned this Jul 25, 2026
Copilot AI review requested due to automatic review settings July 25, 2026 03:10

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR clarifies the run-plugin directive behavior in the header_rewrite admin guide by documenting that the "<plugin-argument> ..." string is parsed once at rule load/reload time (similar to remap.config) and is not re-evaluated per request, so variable interpolation does not apply.

Changes:

  • Add a documentation note under run-plugin explaining that <plugin-argument> is fixed at load/reload time.
  • Explicitly state that per-request variable interpolation (e.g. %{HEADER:bar}) does not work in run-plugin arguments.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants