Skip to content

Commit 47044a4

Browse files
committed
doc: add the description for precontent_by_lua_no_postpone
1 parent 4ecadd5 commit 47044a4

File tree

2 files changed

+29
-0
lines changed

2 files changed

+29
-0
lines changed

README.markdown

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1198,6 +1198,7 @@ Directives
11981198
* [lua_http10_buffering](#lua_http10_buffering)
11991199
* [rewrite_by_lua_no_postpone](#rewrite_by_lua_no_postpone)
12001200
* [access_by_lua_no_postpone](#access_by_lua_no_postpone)
1201+
* [precontent_by_lua_no_postpone](#precontent_by_lua_no_postpone)
12011202
* [lua_transform_underscores_in_response_headers](#lua_transform_underscores_in_response_headers)
12021203
* [lua_check_client_abort](#lua_check_client_abort)
12031204
* [lua_max_pending_timers](#lua_max_pending_timers)
@@ -1878,6 +1879,9 @@ That is, if a request for /images/foo.jpg comes in and the file does not exist,
18781879

18791880
You can use [precontent_by_lua_block](#precontent_by_lua_block) to perform some preparatory functions after the access phase handler but before the proxy or other content handler. Especially some functions that cannot be performed in [balancer_by_lua_block](#balancer_by_lua_block).
18801881

1882+
you can use the [precontent_by_lua_no_postpone](#precontent_by_lua_no_postpone) directive to control when to run this handler inside the "precontent" request-processing phase
1883+
of Nginx.
1884+
18811885
[Back to TOC](#directives)
18821886

18831887
precontent_by_lua_file
@@ -3710,6 +3714,19 @@ This directive was first introduced in the `v0.9.20` release.
37103714

37113715
[Back to TOC](#directives)
37123716

3717+
precontent_by_lua_no_postpone
3718+
-------------------------
3719+
3720+
**syntax:** *precontent_by_lua_no_postpone on|off*
3721+
3722+
**default:** *precontent_by_lua_no_postpone off*
3723+
3724+
**context:** *http*
3725+
3726+
Controls whether or not to disable postponing [precontent_by_lua*](#precontent_by_lua_block) directives to run at the end of the `precontent` request-processing phase. By default, this directive is turned off and the Lua code is postponed to run at the end of the `precontent` phase.
3727+
3728+
[Back to TOC](#directives)
3729+
37133730
lua_transform_underscores_in_response_headers
37143731
---------------------------------------------
37153732

doc/HttpLuaModule.wiki

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1524,6 +1524,8 @@ That is, if a request for /images/foo.jpg comes in and the file does not exist,
15241524
15251525
You can use [[#precontent_by_lua_block|precontent_by_lua_block]] to perform some preparatory functions after the access phase handler but before the proxy or other content handler. Especially some functions that cannot be performed in [[#balancer_by_lua_block|balancer_by_lua_block]].
15261526
1527+
You can use the [[#precontent_by_lua_no_postpone|precontent_by_lua_no_postpone]] directive to control when to run this handler inside the "precontent" request-processing phase of Nginx.
1528+
15271529
== precontent_by_lua_file ==
15281530
15291531
'''syntax:''' ''precontent_by_lua_file <path-to-lua-script-file>''
@@ -3070,6 +3072,16 @@ Controls whether or not to disable postponing [[#access_by_lua|access_by_lua*]]
30703072
30713073
This directive was first introduced in the <code>v0.9.20</code> release.
30723074
3075+
== precontent_by_lua_no_postpone ==
3076+
3077+
'''syntax:''' ''precontent_by_lua_no_postpone on|off''
3078+
3079+
'''default:''' ''precontent_by_lua_no_postpone off''
3080+
3081+
'''context:''' ''http''
3082+
3083+
Controls whether or not to disable postponing [[#precontent_by_lua_block|precontent_by_lua_block*]] directives to run at the end of the <code>precontent</code> request-processing phase. By default, this directive is turned off and the Lua code is postponed to run at the end of the <code>precontent</code> phase.
3084+
30733085
== lua_transform_underscores_in_response_headers ==
30743086
30753087
'''syntax:''' ''lua_transform_underscores_in_response_headers on|off''

0 commit comments

Comments
 (0)