Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Improve documentation about extension property #2047

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
May 13, 2019
Merged

Improve documentation about extension property #2047

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
11 changes: 11 additions & 0 deletions doc/configure/fastcgi_directives.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -154,6 +154,17 @@ <h3><a href="configure/fastcgi_directives.html#fastcgi.spawn"><code>"fastcgi.spa
</code></pre>
</div>

<div class="example">
<div class="caption">Example. Map any executable file in path <code>/var/www/data/cgi-bin</code> to <code>fastcgi-cgi</code> wrapper</div>
<pre><code>&quot;/cgi-bin&quot;:
file.dir: /var/www/data/cgi-bin
file.custom-handler:
extension: default # means &quot;no extension&quot; in this case
fastcgi.spawn:
command: &quot;exec /usr/local/share/h2o/fastcgi-cgi&quot;
</code></pre>
</div>

<p>
As of version 1.4.0, the spawned process is run under the privileges of user specified by the <a href="configure/base_directives.html#user"><code>user</code></a> directive (in version 1.3.x, the FastCGI process was spawned under the privileges that spawned the H2O standalone server).
It is possible to specify a different user for running the FastCGI process, by providing a mapping that contains an attribute named <code>user</code> together with an attribute named <code>command</code>.
Expand Down
1 change: 1 addition & 0 deletions doc/configure/file_directives.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -120,6 +120,7 @@ <h3><a href="configure/file_directives.html#file.custom-handler"><code>"file.cus

<p>
The directive accepts a mapping containing configuration directives that can be used at the <code>extension</code> level, together with a property named <code>extension</code> specifying a extension (starting with <code>.</code>) or a sequence of extensions to which the directives should be applied.
If several files with different extensions or no extensions at all shall be mapped, this property must be set to <code>default</code>.
Only one handler must exist within the directives.
</p>
<div class="example">
Expand Down
9 changes: 9 additions & 0 deletions srcdoc/configure/fastcgi_directives.mt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,15 @@ file.custom-handler:
fastcgi.spawn: "PHP_FCGI_CHILDREN=10 exec /usr/local/bin/php-cgi"
EOT
?>
<?= $ctx->{example}->('Map any executable file in path <code>/var/www/data/cgi-bin</code> to <code>fastcgi-cgi</code> wrapper', <<'EOT');
"/cgi-bin":
file.dir: /var/www/data/cgi-bin
file.custom-handler:
extension: default # means "no extension" in this case
fastcgi.spawn:
command: "exec /usr/local/share/h2o/fastcgi-cgi"
EOT
?>
<p>
As of version 1.4.0, the spawned process is run under the privileges of user specified by the <a href="configure/base_directives.html#user"><code>user</code></a> directive (in version 1.3.x, the FastCGI process was spawned under the privileges that spawned the H2O standalone server).
It is possible to specify a different user for running the FastCGI process, by providing a mapping that contains an attribute named <code>user</code> together with an attribute named <code>command</code>.
Expand Down
1 change: 1 addition & 0 deletions srcdoc/configure/file_directives.mt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,7 @@ $ctx->{directive}->(
?>
<p>
The directive accepts a mapping containing configuration directives that can be used at the <code>extension</code> level, together with a property named <code>extension</code> specifying a extension (starting with <code>.</code>) or a sequence of extensions to which the directives should be applied.
If several files with different extensions or no extensions at all shall be mapped, this property must be set to <code>default</code>.
Only one handler must exist within the directives.
</p>
<?= $ctx->{example}->('Mapping PHP files to FastCGI', <<'EOT')
Expand Down