【ThinkPHP】5.1 完全开发手册 / Swoole

Swoole

Swoole是一个面向生产环境的 PHP 异步网络通信引擎。使 PHP 开发人员可以编写高性能的异步并发 TCP、UDP、Unix Socket、HTTP,WebSocket 服务。

安装

首先按照Swoole官网说明安装swoole扩展,然后安装think-swoole扩展。

composer require topthink/think-swoole=2.0.*

Swoole目前不支持Windows

使用

使用Swoole作为HttpServer

命令行下启动服务端(需要2.0+版本think-swoole扩展) 直接在命令行下启动服务端。

php think swoole

启动完成后,会在0.0.0.0:9501启动一个HTTP Server,可以直接访问当前的应用。

swoole的参数可以在应用配置目录下的swoole.php里面配置(具体参考配置文件内容)。

如果需要使用守护进程方式运行,可以使用

php think swoole -d

或者在swoole.php文件中设置

'daemonize'	=>	true

注意:由于onWorkerStart运行的时候没有HTTP_HOST,因此最好在应用配置文件中设置app_host

支持的操作包括

php think swoole [start|stop|reload|restart]

由于onWorkerStart运行的时候没有HTTP_HOST,因此最好在应用配置文件中设置app_host参数

启动后,可以使用

http://127.0.0.1:9501

访问你的应用。

如果需要配置地址和端口,可以在应用配置目录下增加 swoole.php配置文件,然后设置:

<?php
return [
'host'	=> 'tp5.com',
'port'	=>	9508,
];

可以支持Swoole自身的配置参数设置,例如:

<?php
return [
'host'			=> 'tp5.com',
'port'			=>	9508,
'worker_num'	=>	4,
'max_request'	=>	1000,
];

扩展中定义了onWorkerStart和onRequest事件回调方法(如果不熟悉请不要随意替换),如果你需要自定义swoole的事件回调方法,可以在配置文件中使用闭包定义。

<?php
return [
'host'			=> 'tp5.com',
'port'			=>	9508,
'worker_num'	=>	4,
'max_request'	=>	1000,
'WorkerStop'	=>	function($server, $worker_id){
// 添加你的代码
},
];

或者直接在配置文件中添加

使用Swoole作为Server服务端

可以支持直接启动一个Swoole server(需要2.0.9+版本)

php think swoole:server

会在0.0.0.0:9508启动一个Websocket服务。

如果需要自定义参数,可以在config/swoole_server.php中进行配置,包括:

配置参数 描述
type 服务类型
host 监听地址
port 监听端口
mode 运行模式
socket_type Socket type

并且支持swoole所有的参数。 也支持使用闭包方式定义相关事件回调。

return [
// 扩展自身配置
'host'         => '0.0.0.0', // 监听地址
'port'         => 9501, // 监听端口
'type'         => 'socket', // 服务类型 支持 socket http server
'mode'         => SWOOLE_PROCESS,
'socket_type'  => SWOOLE_SOCK_TCP,

// 可以支持swoole的所有配置参数
'daemonize'    => false,

// 事件回调定义
'onOpen'       => function ($server, $request) {
echo "server: handshake success with fd{$request->fd}\n";
},

'onMessage'    => function ($server, $frame) {
echo "receive from {$frame->fd}:{$frame->data},opcode:{$frame->opcode},fin:{$frame->finish}\n";
$server->push($frame->fd, "this is server");
},

'onRequest'    => function ($request, $response) {
$response->end("<h1>Hello Swoole. #" . rand(1000, 9999) . "</h1>");
},

'onClose'      => function ($ser, $fd) {
echo "client {$fd} closed\n";
},
];

也可以使用自定义的服务类

<?php
namespace app\http;

use think\swoole\Server;

class Swoole extends Server
{
protected $host = '127.0.0.1';
protected $port = 9502;
protected $option = [ 
'worker_num'=> 4,
'daemonize'	=> true,
'backlog'	=> 128
];

public function onReceive($server, $fd, $from_id, $data)
{
$server->send($fd, 'Swoole: '.$data);
}
}

支持swoole所有的回调方法定义(回调方法必须是public类型) serverType 属性定义为 socket或者http 则支持swoole的swoole_websocket_server和swoole_http_server

然后在swoole_server.php中增加配置参数:

return [
'swoole_class'	=>	'app\http\Swoole',
];

定义该参数后,其它配置参数均不再有效。

在命令行启动服务端

php think swoole:server

支持reload|restart|stop|status 操作

php think swoole:server reload