Swoole笔记(五)

@date:2017-08-20 07:51:00

配置说明 #

$server->set(array(
	'daemonize' => true,
	'log_file' => '/www/log/swoole.log',
	'reactor_num' => 2,
	'worker_num' => 2,
	'task_worker_num' => 4,
	'max_request' => 100,
	
));

daemonize #

设置是否后台运行。默认是false。设置daemonize => 1时,程序将转入后台作为守护进程运行。长时间运行的服务器端程序必须启用此项。

如果不启用守护进程,当ssh终端退出后,程序将被终止运行。

注意:

  • 启用守护进程后,标准输入和输出会被重定向到 log_file。
  • 如果未设置log_file,将重定向到 /dev/null,所有打印屏幕的信息都会被丢弃。

log_file #

指定swoole错误日志文件。在swoole运行期发生的异常信息会记录到这个文件中。默认会打印到屏幕。

注意log_file不会自动切分文件,所以需要定期清理此文件。通过重新打开日志,可以实现按天记录日志。

log_level #

设置swoole_server错误日志打印的等级,范围是0-5。低于log_level设置的日志信息不会抛出。默认是0 也就是所有级别都打印。

0 =>DEBUG
1 =>TRACE
2 =>INFO
3 =>NOTICE
4 =>WARNING
5 =>ERROR

reactor_num #

reactor线程数,通过此参数来调节主进程内事件处理线程的数量,以充分利用多核。默认会启用CPU核数相同的数量。reactor_num一般设置为CPU核数的1-4倍,在swoole中reactor_num最大不得超过CPU核数*4

Swoole的主进程是一个多线程的程序。其中有一组很重要的线程,称之为Reactor线程。它就是真正处理TCP连接,收发数据的线程。Reactor线程进行协议解析,将请求投递到Worker进程。

推荐配置:CPU核数。

注意:reactor_num必须小于或等于worker_num。如果设置的reactor_num大于worker_num,那么swoole会自动调整使reactor_num等于worker_num

worker_num #

设置启动的worker进程数。worker_num >= 1,至少会有一个,默认是 1。设置方法:

  • 业务代码是全异步非阻塞的,这里设置为CPU的1-4倍最合理。
  • 业务代码为同步阻塞,需要根据请求响应时间和系统负载来调整。

比如1个请求耗时100ms,要提供1000QPS的处理能力,那必须配置100个进程或更多。但是需要考虑内存占用。假设每个进程占用40M内存,那100个进程就需要占用4G内存。

推荐配置:CPU核数*2。

task_worker_num #

配置task进程的数量,配置此参数后将会启用task功能。如果业务用不到异步任务,可以不设置。一旦设置次参数,必须设置onTask/onFinish2个事件回调。

注意:

  • task进程内不能使用swoole_server->task方法
  • task进程内不能使用mysql-async/redis-async/swoole_event等异步IO函数

推荐配置:根据实际异步任务比重设置。

dispatch_mode #

数据包分发策略。可以选择3种类型,默认为2。一般情况下,HttpServer可以使用1、3;WebSocketServer可以使用默认的2。

  • 1,轮循模式,收到会轮循分配给每一个worker进程。
  • 2,固定模式,根据连接的文件描述符分配worker。这样可以保证同一个连接发来的数据只会被同一个worker处理。
  • 3,抢占模式,主进程会根据Worker的忙闲状态选择投递,只会投递给处于闲置状态的Worker。
  • 4,IP分配,根据客户端IP进行取模hash,分配给一个固定的worker进程。可以保证同一个来源IP的连接数据总会被分配到同一个worker进程。算法为 ip2long(ClientIP) % worker_num
  • 5,UID分配,需要用户代码中调用 $serv->bind() 将一个连接绑定1个uid。然后swoole根据UID的值分配到不同的worker进程。算法为 UID % worker_num,如果需要使用字符串作为UID,可以使用crc32(UID_STRING)

dispatch_mode配置在BASE模式是无效的,因为BASE不存在投递任务。

max_request #

设置worker进程的最大任务数,默认为0。

这个参数的主要作用是解决PHP进程内存溢出问题。一个worker进程在处理完超过max_request数值的任务后将自动退出,进程退出后会释放所有内存和资源。

例如设置为3,假设有2个worker进程,执行5次请求,必然会有一个worker进程会退出并被重新拉起一个新的。如果不设置,就不会执行这个操作。

PHP应用程序有缓慢的内存泄漏,但无法定位到具体原因、无法解决,可以通过设置max_request解决。

如果代码没有内存泄露的问题,没有每访问一次,内存就增加一点,那不设置(默认为0)也不会有内存泄露。反之,max_request,就可以限制内存无限制增长,从而防止内存泄露。(参考http://group.swoole.com/question/106049)

task_max_request #

类似于max_request,默认为5000。用于设置task进程的最大任务数。一个task进程在处理完超过此数值的任务后将自动退出。这个参数是为了防止PHP进程内存溢出。如果不希望进程自动退出可以设置为0。

max_conn (max_connection) #

服务器程序,最大允许的连接数,如max_conn => 10000, 此参数用来设置Server最大允许维持多少个tcp连接。超过此数量后,新进入的连接将被拒绝。

  • 默认值为ulimit -n的值。系统的ulimit -n可能太小,需要手动设置。例如ulimit -n 65535
  • 最大不得超过操作系统ulimit -n的值,否则会报一条警告信息,并重置为ulimit -n的值。
  • 此参数不要调整的过大,根据机器内存的实际情况来设置。

heartbeat_idle_time、heartbeat_check_interval #

heartbeat_idle_time与heartbeat_check_interval配合使用。表示连接最大允许空闲的时间。如:

array(
    'heartbeat_idle_time' => 600, //表示连接最大允许空闲的时间
    'heartbeat_check_interval' => 60, //表示每隔少秒轮循一次
);

表示每60秒遍历一次,一个连接如果600秒内未向服务器发送任何数据,此连接将被强制关闭。

  • 启用heartbeat_idle_time后,服务器并不会主动向客户端发送数据包,而是被动等待客户端发送心跳。
  • 如果只设置了heartbeat_idle_time未设置heartbeat_check_interval底层将不会创建心跳检测线程,PHP代码中可以调用heartbeat方法手工处理超时的连接。

open_eof_check、package_eof #

设置EOF字符串。package_eof最大只允许传入8个字节的字符串。

array(
    'open_eof_check' => true, //打开EOF检测
    'package_eof' => "\r\n", //设置EOF
)

打开EOF检测,此选项将检测客户端连接发来的数据,当数据包结尾是指定的字符串时才会投递给Worker进程。否则会一直拼接数据包,直到超过缓存区或者超时才会中止。当出错时swoole底层会认为是恶意连接,丢弃数据并强制关闭连接。

常见的Memcache/SMTP/POP等协议都是以\r\n结束的,就可以使用此配置。开启后可以保证Worker进程一次性总是收到一个或者多个完整的数据包。

open_eof_split #

EOF检测不会从数据中间查找eof字符串,所以Worker进程可能会同时收到多个数据包,需要在应用层代码中自行explode("\r\n", $data) 来拆分数据包。

1.7.15版本增加了open_eof_split,支持从数据中查找EOF,并切分数据。

pid_file #

在Server启动时自动将master进程的PID写入到文件,在Server关闭时自动删除PID文件。(1.9.5+支持)

$server->set(array(
    'pid_file' => __DIR__.'/server.pid',
));

其它参数详见:配置选项-Swoole-Swoole文档中心
https://wiki.swoole.com/wiki/page/274.html

服务器调优 #

常见优化参数:

# 内核优化
ulimit -n 65535
net.core.somaxconn = 262144
net.ipv4.tcp_tw_recycle = 1
net.ipv4.tcp_tw_reuse = 1
net.ipv4.tcp_syncookies = 1

# nginx优化
worker_rlimit_nofile 65535;
use epoll;
worker_connections 65535;
keepalive_timeout 60;

内核优化如何修改:
1、ulimit参数直接运行ulimit -SHn 65535即可,可以使用ulimit -n查看;
2、其它参数优化示例:
net.core.somaxconn对应文件/proc/sys/net/core/somaxconn:

# 查看
cat /proc/sys/net/core/somaxconn

# 修改
echo 65535 > /proc/sys/net/core/somaxconn

net.ipv4.tcp_tw_recycle对应文件/proc/sys/net/ipv4/tcp_tw_recycle:

# 查看
cat /proc/sys/net/ipv4/tcp_tw_recycle

# 修改
echo 65535 > /proc/sys/net/ipv4/tcp_tw_recycle

3、也可以修改/etc/sysctl.conf文件:

# 调高系统的 IP 以及端口数据限制,从可以接受更多的连接
net.ipv4.ip_local_port_range = 2000 65000
 
net.ipv4.tcp_window_scaling = 1
 
# 设置协议栈可以缓存的报文数阀值,超过阀值的报文将被内核丢弃
net.ipv4.tcp_max_syn_backlog = 3240000
 
# 调高 socket 侦听数阀值
net.core.somaxconn = 3240000
net.ipv4.tcp_max_tw_buckets = 1440000
 
# 调大 TCP 存储大小
net.core.rmem_default = 8388608
net.core.rmem_max = 16777216
net.core.wmem_max = 16777216
net.ipv4.tcp_rmem = 4096 87380 16777216
net.ipv4.tcp_wmem = 4096 65536 16777216
net.ipv4.tcp_congestion_control = cubic

# tcp重新回收
net.ipv4.tcp_tw_recycle = 1
net.ipv4.tcp_tw_reuse = 1

修改配置之后需要执行以下命令使之生效:

sysctl -p /etc/sysctl.conf

相关应用 #

1、https://github.com/matyhtf/framework
2、衍生开源项目-Swoole-Swoole文档中心
https://wiki.swoole.com/wiki/page/p-open_source.html
3、moell-peng/webim: PHP + Swoole 实现的简单聊天室
https://github.com/moell-peng/webim

参考 #

1、Server-Swoole-Swoole文档中心
https://wiki.swoole.com/wiki/page/p-server.html
2、swoole_study/Swoole的进程模型.md at master · szyhf/swoole_study
https://github.com/szyhf/swoole_study/blob/master/Swoole的进程模型.md

Build by Loppo 0.6.14