Server->set
最后更新于：2022-04-02 06:19:42
# Server->set
[TOC]
用于设置运行时的各项参数。服务器启动后通过`$serv->setting`来访问`Server->set`方法设置的参数数组。
原型：
~~~
function Server->set(array $setting);
~~~
示例：
~~~
$serv->set(array(
'reactor_num' => 2, //reactor thread num
'worker_num' => 4, //worker process num
'backlog' => 128, //listen backlog
'max_request' => 50,
'dispatch_mode' => 1,
));
~~~
> `Server->set`必须在`Server->start`前调用
## 最大连接
`max_conn => 10000`, 此参数用来设置`Server`最大允许维持多少个`tcp`连接。超过此数量后，新进入的连接将被拒绝。
> 此参数不要调整的过大，根据机器内存的实际情况来设置。底层会根据此数值一次性分配一块大内存来保存`Connection`信息
## 守护进程化
`daemonize => 1`，加入此参数后，执行`php server.php`将转入后台作为守护进程运行
## reactor线程数
`reactor_num => 2`，通过此参数来调节`Reactor`线程的数量，以充分利用多核
> `reactor_num`和默认设置为CPU核数
## worker进程数
`worker_num => 4`，设置启动的`Worker`进程数量。`Swoole`采用固定`Worker`进程的模式。
* 全异步非阻塞服务器`worker_num`配置为`CPU`核数的`1-4`倍即可。
* 同步阻塞服务器，`worker_num`配置为`100`或者更高，具体要看每次请求处理的耗时和操作系统负载状况
> 当设定的`Worker`进程数小于reactor线程数时，会自动调低reactor线程的数量
## max\_request
max\_request => 2000，此参数表示worker进程在处理完n次请求后结束运行。manager会重新创建一个worker进程。此选项用来防止worker进程内存溢出。
> PHP代码也可以使用memory\_get\_usage来检测进程的内存占用情况，发现接近memory\_limit时，调用exit()退出进程。manager进程会回收此进程，然后重新启动一个新的Worker进程。
> onConnect/onClose不增加计数
~~~
max_request => 0
~~~
设置为0表示不自动重启。在Worker进程中需要保存连接信息的服务，需要设置为0.
## Listen队列长度
backlog => 128，此参数将决定最多同时有多少个待accept的连接，swoole本身accept效率是很高的，基本上不会出现大量排队情况。
## CPU亲和设置
open\_cpu\_affinity => 1 ,启用CPU亲和设置
## TCP\_NoDelay启用
open\_tcp\_nodelay => 1 ,启用tcp\_nodelay
## TCP\_DEFER\_ACCEPT
tcp\_defer\_accept => 5，此参数设定一个秒数，当客户端连接连接到服务器时，在约定秒数内并不会触发accept，直到有数据发送，或者超时时才会触发。
## 日志文件路径
log\_file => '/data/log/swoole.log', 指定swoole错误日志文件。在swoole运行期发生的异常信息会记录到这个文件中。默认会打印到屏幕。
> 此配置仅在swoole-1.5.8以上版本中可用
## 数据buffer
buffer主要是用于检测数据是否完整，如果不完整swoole会继续等待新的数据到来。直到收到完整的一个请求，才会一次性发送给worker进程。这时onReceive会收到一个超过SW\_BUFFER\_SIZE，
小于$serv->setting\['package\_max\_length'\]的数据。
目前仅提供了EOF检测、固定包头长度检测2种buffer模式。
open\_eof\_check => true打开buffer
package\_eof => "\\r\\n\\r\\n" 设置EOF
## 心跳检测机制
heartbeat\_check\_interval => 30 //每隔多少秒检测一次，单位秒，Swoole会轮询所有TCP连接，将超过心跳时间的连接关闭掉
heartbeat\_idle\_time => 60 //TCP连接的最大闲置时间，单位s , 如果某fd最后一次发包距离现在的时间超过heartbeat\_idle\_time会把这个连接关闭。
> 心跳检测特性需要swoole-1.6.10+
> heartbeat\_idle\_time必须大于或等于heartbeat\_check\_interval
## worker进程数据包分配模式
dispatch\_mode = 1 //1平均分配，2按FD取模固定分配，3抢占式分配，默认为取模(dispatch=2)
> 抢占式分配，每次都是空闲的worker进程获得数据。很合适SOA/RPC类的内部服务框架
> 当选择为dispatch=3抢占模式时，worker进程内发生onConnect/onReceive/onClose/onTimer会将worker进程标记为忙，不再接受新的请求。reactor会将新请求投递给其他状态为闲的worker进程
> 如果希望每个连接的数据分配给固定的worker进程，dispatch\_mode需要设置为2
';