× 警告!旧版文档已经暂停维护,请查看新版文档。点击前往新版文档

task_tmpdir

创建一个swoole server资源对象。

$serv = new swoole_server(string $host, int $port, int $mode = SWOOLE_PROCESS,
    int $sock_type = SWOOLE_SOCK_TCP);
  • $host参数用来指定监听的ip地址,如127.0.0.1,或者外网地址,或者0.0.0.0监听全部地址
    • IPv4使用 127.0.0.1表示监听本机,0.0.0.0表示监听所有地址
    • IPv6使用::1表示监听本机,:: (0:0:0:0:0:0:0:0) 表示监听所有地址
  • $port监听的端口,如9501,监听小于1024端口需要root权限,如果此端口被占用server->start时会失败
  • $mode运行的模式,swoole提供了3种运行模式,默认为多进程模式
  • $sock_type指定socket的类型,支持TCP/UDP、TCP6/UDP6、UnixSock Stream/Dgram 6种
  • 使用$sock_type | SWOOLE_SSL可以启用SSL加密。启用SSL后必须配置ssl_key_file和ssl_cert_file
  • 1.7.11后增加了对Unix Socket的支持,详细请参见 /wiki/page/16.html
  • 构造函数中的参数与swoole_server::addlistener中是完全相同的
  • 高负载的服务器,请务必调整Linux内核参数
  • 3种Server运行模式介绍

Swoole1.6版本之后PHP版本去掉了线程模式,原因是php的内存管理器在多线程下容易发生错误
线程模式仅供C++中使用
BASE模式在1.6.4版本之后也可是使用多进程,设置worker_num来启用

随机可用端口

swoole-1.9.6增加了随机监听可用端口的支持,$port参数可以设置为0,操作系统会随机分配一个可用的端口,进行监听。可以通过读取$server->port得到分配到的端口号。

$http = new swoole_http_server("0.0.0.0");

$http->on('request', function ($request, $response) {
    $response->header("Content-Type", "text/html; charset=utf-8");
    $response->end("<h1>Hello Swoole. #".rand(1000, 9999)."</h1>");
});

$http->start();

SYSTEMD监听端口

swoole-1.9.7增加了对systemd socket的支持。监听端口由systemd配置指定。

swoole.socket

Backlog       = 1024
ListenStream  = 9501

[Install]
WantedBy = sockets.target

swoole.service

[Service]
Type=forking
PIDFile=/var/run/swoole.pid
ExecStart=/usr/bin/php /var/www/swoole/server.php
ExecStop=/bin/kill $MAINPID
ExecReload=/bin/kill -USR1 $MAINPID

[Install]
WantedBy = multi-user.target

server.php

$http = new swoole_http_server("systemd");

$http->set([
    'daemonize' => true,
    'pid_file' => '/var/run/swoole.pid',
]);

$http->on('request', function ($request, $response) {
    $response->header("Content-Type", "text/html; charset=utf-8");
    $response->end("<h1>Hello Swoole. #".rand(1000, 9999)."</h1>");
});

$http->start();

启动服务

sudo systemctl enable swoole.service
sudo systemctl start swoole.service
sudo systemctl start swoole.service