Piped Logger

Table of Contents

Piped Logger

名称 | 地址 | 最大连接数 | 环境 | 命令 | Instances | Run As User | Run As Group | umask | Priority

名称

Description

此外部应用程序的唯一名称。 在配置的其他部分中使用该名称时,将使用该名称进行引用。

地址

Description

外部应用程序使用的唯一套接字地址。 支持IPv4/IPv6套接字和Unix域套接字(UDS)。 IPv4/IPv6套接字可用于网络通信。 只有当外部应用程序与服务器在同一台机器上时,才能使用UDS。

Syntax

IPv4 或 IPV6 address:port 或者 UDS://path

例子

127.0.0.1:5434
UDS://tmp/lshttpd/php.sock.

提示

[安全建议] 如果外部应用程序在同一台机器上运行,则首选UDS。如果必须使用IPv4|IPV6, 将IP地址设置为localhost127.0.0.1,这样外部应用就无法从其他机器上访问。 [性能建议] Unix域套接字一般比IPv4套接字拥有更高的性能。

最大连接数

Description

指定服务器与外部应用之间可建立的最大并发连接数。该设置控制外部应用程序可同时处理多少个请求。 然而,真正的限制还取决于外部应用本身。如果外部的速度不够快,或者无法处理大量的并发请求,那么将这个值设置得更高也无济于事。

Syntax

整数

提示

[性能建议] 设置一个高值并不能直接变成高性能。设置为一个不会使外部应用程序过载的值,将提供最佳的性能/吞吐量。

环境

Description

为外部应用程序指定额外的环境变量。

Syntax

Key=value. Multiple variables can be separated by "ENTER"

命令

Description

Specifies the full command line including parameters to execute the external application. Required value if Start By Server is enabled. A parameter should be quoted with a double or single quote if the parameter contains space or tab characters.

Syntax

Full path to the executable with optional parameters.

See Also

Start By Server

Instances

Description

Specifies the maximum instances of the external application the server will create. It is required if Start By Server is enabled. Most FastCGI/LSAPI applications can only process one request per process instance and for those types of applications, instances should be set to match the value of 最大连接数. Some FastCGI/LSAPI applications can spawn multiple child processes to handle multiple requests concurrently. For these types of applications, instances should be set to "1" and environment variables used to control how many child processes the application can spawn.

Syntax

整数

Run As User

Description

The external application will run as this specified user name. If not set, Virtual Host level settings will be inherited.

Default value: Not Set

Syntax

Valid username.

See Also

extGroup

Run As Group

Description

The external application will run as this specified group name. If not set, Virtual Host level settings will be inherited.

Default value: Not Set

Syntax

Valid group name.

See Also

extUser

umask

Description

Sets default umask for this external application's processes. See man 2 umask for details. The default value taken from the server-level umask setting.

Syntax

value valid range [000]-[777].

See Also

CGI umask

Priority

Description

Specifies priority of the external application process. Value ranges from -20 to 20. A lower number means a higher priority. An external application process cannot have a higher priority than the web server. If this priority is set to a lower number than the server's, the server's priority will be used for this value.

Syntax

int

See Also

Server 优先级