手冊簡介

swoole使用手冊，入門教程，Swoole是PHP的非同步、並行、高效能網路通訊引擎，使用純C語言編寫，提供了PHP語言的非同步多執行緒伺服器，非同步TCP/UDP網路客戶端，非同步MySQL，非同步Redis，資料庫連線池，AsyncTask，訊息佇列，毫秒定時器，非同步檔案讀寫，非同步DNS查詢。 Swoole內建了Http/WebSocket伺服器端/客戶端、Http2.0伺服器端。 Swoole可以廣泛應用於網際網路、行動通訊、企業軟體、雲端計算、網路遊戲、物聯網（IOT）、車聯網、智慧家居等領域。使用PHP+

手冊說明

swoole是什麼？

Swoole是一個PHP的C擴充套件，可用來開發PHP的高效能高併發TCP/UDP Server。Swoole的網路IO部分基於epoll/kqueue事件迴圈，是全非同步非阻塞的。業務邏輯部分使用多程式同步阻塞方式來執行。這樣既保證了Server能夠應對高併發和大量TCP連線。又保證業務程式碼仍然可以簡單的編寫。

Swoole1.6.2之後增加了非同步支援，應用程式也可以像node.js一樣寫非同步回撥。

Swoole與Node.js相比更強大，支援同步/非同步、多程式並行，Swoole提供了程式生命週期管理、記憶體保護機制，開發者無需考慮底層細節，專注於業務邏輯和功能的開發。

Swoole底層內建了非同步非阻塞、多執行緒的網路IO伺服器。PHP程式設計師僅需處理事件回撥即可，無需關心底層。與Nginx/Tornado/Node.js等全非同步的框架不同，Swoole既支援全非同步，也支援同步。

Swoole從2.0版本開始支援了內建協程，可以使用完全同步的程式碼實現非同步程式。PHP程式碼無需額外增加任何關鍵詞，底層自動進行協程排程，實現非同步。

Swoole是開源免費的自由軟體，授權協議是Apache2.0。企業和開發者均可免費使用Swoole的程式碼，並且在Swoole之上所作的修改無需開源。

優勢

純C編寫效能極強
簡單易用開發效率高
事件驅動非同步非阻塞
併發百萬TCP連線
TCP/UDP/UnixSock
伺服器端/客戶端
全非同步/半非同步半同步
支援多程式/多執行緒
CPU親和性/守護程式
支援IPv4/IPv6網路

Swoole HttpServer實現示例：

$serv = new Swoole\Http\Server("127.0.0.1", 9502);
$serv->on('Request', function($request, $response) {
    var_dump($request->get);
    var_dump($request->post);
    var_dump($request->cookie);
    var_dump($request->files);
    var_dump($request->header);
    var_dump($request->server);
    $response->cookie("User", "Swoole");
    $response->header("X-Server", "Swoole");
    $response->end("<h1>Hello Swoole!</h1>");
});
$serv->start();

Swoole WebSocket Server實現示例：

$serv = new Swoole\Websocket\Server("127.0.0.1", 9502);
$serv->on('Open', function($server, $req) {    echo "connection open: ".$req->fd;
});
$serv->on('Message', function($server, $frame) {    echo "message: ".$frame->data;
    $server->push($frame->fd, json_encode(["hello", "world"]));
});
$serv->on('Close', function($server, $fd) {    echo "connection close: ".$fd;
});
$serv->start();

Swoole TCP Server實現示例：

$serv = new Swoole\Server("127.0.0.1", 9501);
$serv->set(array(    'worker_num' => 8,   //工作程式數量
    'daemonize' => true, //是否作為守護程式));
$serv->on('connect', function ($serv, $fd){    echo "Client:Connect.\n";
});
$serv->on('receive', function ($serv, $fd, $from_id, $data) {
    $serv->send($fd, 'Swoole: '.$data);
    $serv->close($fd);
});
$serv->on('close', function ($serv, $fd) {    echo "Client: Close.\n";
});
$serv->start();

Swoole TCP Client實現示例：

$client = new Swoole\Client(SWOOLE_SOCK_TCP, SWOOLE_SOCK_ASYNC);//設定事件回撥函式$client->on("connect", function($cli) {
    $cli->send("hello world\n");
});
$client->on("receive", function($cli, $data){    echo "Received: ".$data."\n";
});
$client->on("error", function($cli){    echo "Connect failed\n";
});
$client->on("close", function($cli){    echo "Connection close\n";
});//發起網路連線$client->connect('127.0.0.1', 9501, 0.5);

Swoole 非同步MySQL實現示例

$db = new Swoole\MySQL;
$server = array(    'host' => '127.0.0.1',    'user' => 'test',    'password' => 'test',    'database' => 'test',
);
$db->connect($server, function ($db, $result) {
    $db->query("show tables", function (Swoole\MySQL $db, $result) {        if ($result === false) {
            var_dump($db->error, $db->errno);
        } elseif ($result === true) {
            var_dump($db->affected_rows, $db->insert_id);
        } else {
            var_dump($result);
            $db->close();
        }
    });
});

Swoole 非同步Redis/非同步Http客戶端實現示例

$redis = new Swoole\Redis;
$redis->connect('127.0.0.1', 6379, function ($redis, $result) {
    $redis->set('test_key', 'value', function ($redis, $result) {
        $redis->get('test_key', function ($redis, $result) {
            var_dump($result);
        });
    });
});
$cli = new Swoole\Http\Client('127.0.0.1', 80);
$cli->setHeaders(array('User-Agent' => 'swoole-http-client'));
$cli->setCookies(array('test' => 'value'));
$cli->post('/dump.php', array("test" => 'abc'), function ($cli) {
    var_dump($cli->body);
    $cli->get('/index.php', function ($cli) {
        var_dump($cli->cookies);
        var_dump($cli->headers);
    });
});

Swoole Async-IO實現示例

$fp = stream_socket_client("tcp://127.0.0.1:80", $code, $msg, 3);
$http_request = "GET /index.html HTTP/1.1\r\n\r\n";
fwrite($fp, $http_request);
Swoole\Event::add($fp, function($fp){    echo fread($fp, 8192);
    swoole_event_del($fp);
    fclose($fp);
});
Swoole\Timer::after(2000, function() {    echo "2000ms timeout\n";
});
Swoole\Timer::tick(1000, function() {    echo "1000ms interval\n";
});

Swoole 非同步任務實現示例：

$serv = new Swoole\Server("127.0.0.1", 9502);
$serv->set(array('task_worker_num' => 4));
$serv->on('Receive', function($serv, $fd, $from_id, $data) {
    $task_id = $serv->task("Async");    echo "Dispath AsyncTask: id=$task_id\n";
});
$serv->on('Task', function ($serv, $task_id, $from_id, $data) {    echo "New AsyncTask[id=$task_id]".PHP_EOL;
    $serv->finish("$data -> OK");
});
$serv->on('Finish', function ($serv, $task_id, $data) {    echo "AsyncTask[$task_id] Finish: $data".PHP_EOL;
});
$serv->start();

案例

swoole目前已被多家移動網際網路、物聯網、網路遊戲、手機遊戲企業使用，替代了C++、Java等複雜程式語言來實現網路伺服器程式。使用PHP+Swoole，開發效率可以大大提升。官方提供了基於swoole擴充套件開發的PHP網路框架，支援Http，FastCGI，WebSocket，FTP，SMTP，RPC等網路協議 swoole在美國，英國，法國，印度等國家都有使用者分佈，在國內的、、阿里巴巴、YY語音等多家知名網際網路公司均有使用。

Swoole 教程