在 ServBay 中使用 Swoole 构建高性能 PHP 应用

ServBay 是一个专为开发者设计的本地 Web 开发环境，它预集成了多种语言环境、数据库和工具，旨在简化本地开发流程。本文将重点介绍如何在 ServBay 环境中利用 Swoole 扩展为 PHP 应用赋能，构建高性能的网络服务。

什么是 Swoole？

Swoole 是一个为 PHP 设计的，基于协程（Coroutine）的，并行、高性能网络通信引擎。它使用纯 C 语言编写，提供了 PHP 语言的异步、并行、协程网络通信能力。通过 Swoole，PHP 开发者可以摆脱传统 Web 服务器（如 Apache/Nginx + PHP-FPM）的请求-响应模型限制，以更高效的方式处理高并发任务，例如构建常驻内存的 Web 服务器、异步任务处理、实时通信服务（如 WebSocket）等。

Swoole 的核心特点:

高性能: 底层 C 语言实现，提供异步 I/O、多进程/多线程支持。
协程: 提供轻量级协程，实现同步代码的异步执行，简化异步编程模型。
丰富协议支持: 原生支持 TCP/UDP/HTTP/WebSocket 等多种网络协议。
易于使用: 提供了符合 PHP 习惯的简洁 API。
常驻内存: 应用可以作为常驻进程运行，避免了传统 PHP 应用每次请求都需要初始化环境的开销。

借助 Swoole，PHP 不再仅仅是用于 Web 开发的脚本语言，而是可以胜任更广泛的高性能网络应用场景。

在 ServBay 中启用 Swoole

ServBay 设计的目标之一就是让开发者能够轻松管理和使用各种 PHP 扩展。Swoole 作为现代 PHP 高性能开发的关键扩展，已经预置在 ServBay 中。你只需要简单的步骤即可启用它。

前提:

已安装并运行 ServBay。
确保 ServBay 中已安装至少一个 PHP 版本。

启用步骤:

打开 ServBay 应用界面。
导航到“软件包 (Packages)”或 PHP 版本管理界面。 （注意：根据 ServBay 版本，入口名称可能略有不同，通常在主界面或设置中）
选择你想要启用 Swoole 的 PHP 版本。
找到 Swoole 扩展选项并勾选启用。 ServBay 通常会以列表或开关的形式展示已编译好的扩展。
保存更改并根据提示重启 ServBay 或对应的 PHP 服务。 ServBay 会自动配置 PHP 环境以加载 Swoole 扩展。

完成以上步骤后，你就可以在选定的 PHP 版本中开始使用 Swoole 了。你可以通过命令行运行 php -m 来确认 swoole 是否出现在已加载扩展列表中。

TIP

ServBay 默认建议将你的网站和项目文件存放在 /Applications/ServBay/www 目录下，这有助于 ServBay 的网站管理和配置。在本文示例中，我们也将遵循这一建议路径。

构建一个简单的 Swoole HTTP 服务器

接下来，我们将创建一个基本的 Swoole HTTP 服务器，演示如何处理 Web 请求。

步骤 1：创建项目目录

打开终端，创建并进入一个新的项目目录。按照 ServBay 的建议，我们将其放在 /Applications/ServBay/www 下：

bash

cd /Applications/ServBay/www
mkdir servbay-swoole-http
cd servbay-swoole-http

步骤 2：编写服务器脚本

在 servbay-swoole-http 目录下创建一个名为 server.php 的文件，并添加以下内容：

php

<?php

use Swoole\Http\Server;
use Swoole\Http\Request;
use Swoole\Http\Response;

// 创建 Swoole HTTP 服务器实例
// 监听所有网络接口 (0.0.0.0) 的 9501 端口
$server = new Server("0.0.0.0", 9501);

// 注册 'start' 事件回调函数
// 当服务器启动成功时触发
$server->on("start", function (Server $server) {
    echo "Swoole HTTP server is started at http://0.0.0.0:9501\n";
    // 可以在这里记录主进程 ID、管理进程 ID 等信息
});

// 注册 'request' 事件回调函数
// 当接收到新的 HTTP 请求时触发
$server->on("request", function (Request $request, Response $response) {
    // 设置响应头
    $response->header("Content-Type", "text/plain");

    // 根据请求路径或参数处理逻辑
    $path = $request->server['request_uri'] ?? '/';
    $content = "Hello ServBay!";

    if ($path === '/info') {
        $content = "Request path: " . $path . "\n";
        $content .= "Method: " . $request->server['request_method'] . "\n";
        $content .= "Client IP: " . $request->server['remote_addr'] . "\n";
        // 更多请求信息可以通过 $request 对象获取
    }

    // 发送响应体并结束请求
    $response->end($content);
});

// 启动服务器
$server->start();

这个脚本创建了一个 Swoole HTTP 服务器，监听在 9501 端口。当接收到请求时，它会发送一个简单的文本响应 "Hello ServBay!"。如果访问 /info 路径，则会返回一些请求信息。

步骤 3：运行 Swoole 服务器

确保你的终端当前目录是 servbay-swoole-http。使用 ServBay 中已启用 Swoole 的 PHP 版本来运行脚本：

bash

php server.php

如果一切正常，你将在终端看到如下输出：

bash

Swoole HTTP server is started at http://0.0.0.0:9501

这表示 Swoole HTTP 服务器已经在后台运行并监听 9501 端口。

步骤 4：访问 Swoole 服务器

打开你的 Web 浏览器，访问以下地址：

http://localhost:9501
http://localhost:9501/info

你会看到网页分别输出 Hello ServBay! 和包含请求信息的文本。

要停止服务器，回到运行脚本的终端窗口，按下 Ctrl + C。

使用 Swoole 处理 WebSocket 连接

Swoole 对 WebSocket 协议提供了原生支持，非常适合构建实时通信应用，例如聊天室、游戏服务器、实时数据推送等。

步骤 1：创建 WebSocket 服务器脚本

在 /Applications/ServBay/www/servbay-swoole-http 目录下（或者另外创建一个新目录，例如 servbay-swoole-websocket）创建一个名为 websocket_server.php 的文件，并添加以下内容：

php

<?php

use Swoole\WebSocket\Server;
use Swoole\Http\Request;
use Swoole\WebSocket\Frame;

// 创建 Swoole WebSocket 服务器实例
// WebSocket 服务器继承自 HTTP 服务器，因此也可以处理 HTTP 请求
$server = new Server("0.0.0.0", 9502); // 监听 9502 端口

// 注册 'start' 事件，服务器启动时触发
$server->on("start", function (Server $server) {
    echo "Swoole WebSocket server is started at ws://0.0.0.0:9502\n";
});

// 注册 'open' 事件
// 当新的 WebSocket 连接建立时触发
// $request 对象包含客户端连接信息，如 $request->fd 是客户端文件描述符
$server->on("open", function (Server $server, Request $request) {
    echo "connection open: {$request->fd}\n";
    // 可以向客户端发送欢迎消息
    $server->push($request->fd, "Welcome to ServBay WebSocket Demo!");
});

// 注册 'message' 事件
// 当服务器收到客户端发送的 WebSocket 消息时触发
// $frame 对象包含消息信息，如 $frame->data 是消息内容，$frame->fd 是发送消息的客户端文件描述符
$server->on("message", function (Server $server, Frame $frame) {
    echo "received message from {$frame->fd}: {$frame->data}\n";
    // 广播消息给所有连接的客户端，或者回复给发送者
    // 例如，回复给发送者
    $server->push($frame->fd, "Hello, you sent: {$frame->data}");

    // 广播示例 (需要维护连接列表或遍历)
    // foreach ($server->connections as $fd) {
    //     if ($fd != $frame->fd) { // 不发送给发送者自己
    //         $server->push($fd, "User {$frame->fd} says: {$frame->data}");
    //     }
    // }
});

// 注册 'close' 事件
// 当客户端连接关闭时触发
$server->on("close", function ($ser, $fd) {
    echo "connection close: {$fd}\n";
});

// 启动服务器
$server->start();

这个脚本创建了一个 Swoole WebSocket 服务器，监听在 9502 端口。它定义了几个关键事件的回调函数：start (服务器启动), open (新连接建立), message (收到消息), close (连接关闭)。在 message 事件中，服务器会简单地将收到的消息加上前缀后发送回给发送者。

步骤 2：运行 WebSocket 服务器

确保你的终端当前目录是你存放 websocket_server.php 的位置。使用 ServBay 中已启用 Swoole 的 PHP 版本来运行脚本：

bash

php websocket_server.php

如果一切正常，你将在终端看到如下输出：

bash

Swoole WebSocket server is started at ws://0.0.0.0:9502

这表示 Swoole WebSocket 服务器已经在后台运行并监听 9502 端口。

步骤 3：连接 WebSocket 服务器

你可以使用多种方式连接到这个 WebSocket 服务器进行测试。

方法 A: 使用浏览器开发者工具

大多数现代浏览器的开发者工具（通常按 F12 打开）中都有“网络 (Network)”或“控制台 (Console)”面板，可以用来测试 WebSocket 连接。

打开一个网页（例如 about:blank）。
打开开发者工具，切换到“控制台 (Console)”面板。

输入以下 JavaScript 代码来建立连接：

javascript

var ws = new WebSocket("ws://localhost:9502");

ws.onopen = function(event) {
  console.log("WebSocket connection opened:", event);
  ws.send("Hello from Browser!"); // 连接成功后发送一条消息
};

ws.onmessage = function(event) {
  console.log("Message from server:", event.data); // 收到消息
};

ws.onerror = function(event) {
  console.error("WebSocket error:", event); // 发生错误
};

ws.onclose = function(event) {
  console.log("WebSocket connection closed:", event); // 连接关闭
};

// 随时可以通过 ws.send("你的消息") 发送消息
// 通过 ws.close() 关闭连接

在控制台执行这些代码，观察输出。同时，在运行 websocket_server.php 的终端窗口也会看到相应的连接和消息日志。

方法 B: 使用 wscat 命令行工具

wscat 是一个方便的命令行 WebSocket 客户端工具，基于 Node.js。

安装 wscat: 如果你还没有安装 Node.js 和 npm，请先安装。然后通过 npm 全局安装 wscat：
bash
```
npm install -g wscat
```
1
连接到 WebSocket 服务器: 在终端中运行以下命令：
bash
```
wscat -c ws://localhost:9502
```
1
成功连接后，你会看到提示符 >。
发送消息: 在提示符后输入你想发送的消息，然后按回车：
bash
```
> Hello ServBay via wscat
```
1
服务器收到消息后会回复，你会在 wscat 终端中看到回复内容，通常以 < 开头：
bash
```
< Hello, you sent: Hello ServBay via wscat
```
1
同时，运行 websocket_server.php 的终端也会打印相应的日志。

要断开 wscat 连接，按下 Ctrl + C。

注意事项

端口冲突: 确保 Swoole 服务器监听的端口（例如 9501, 9502）没有被系统上其他程序占用。如果端口冲突，Swoole 服务器将无法启动。
PHP 版本: 确保你在终端中运行脚本时，使用的是 ServBay 中已启用 Swoole 扩展的那个 PHP 版本。你可以通过 php -v 命令查看当前命令行使用的 PHP 版本。ServBay 通常提供了一个方便的命令行工具来切换 PHP 版本。
扩展状态: 如果服务器启动失败，请再次确认 Swoole 扩展是否已在 ServBay 中为你当前使用的 PHP 版本正确启用，并且 ServBay 或 PHP 服务已重启生效。
常驻进程管理: Swoole 服务器是常驻内存的进程。在生产环境中，你需要使用进程管理工具（如 Supervisor, Systemd, pm2 等）来守护 Swoole 进程，确保其在崩溃后能自动重启。在 ServBay 本地开发环境中，手动在终端运行通常足够方便。

总结

通过 ServBay，你可以轻松地启用和使用 Swoole 扩展，从而在本地开发环境中构建和测试高性能的 PHP 应用，无论是传统的 HTTP 服务还是现代的 WebSocket 实时通信应用。Swoole 的强大能力结合 ServBay 提供的便捷开发环境，为 PHP 开发者打开了新的可能性，助你构建更高效、更强大的应用程序。立即在 ServBay 中尝试 Swoole 吧！

在 ServBay 中使用 Swoole 构建高性能 PHP 应用 ​

什么是 Swoole？ ​

在 ServBay 中启用 Swoole ​

构建一个简单的 Swoole HTTP 服务器 ​

使用 Swoole 处理 WebSocket 连接 ​

注意事项 ​

总结 ​

在 ServBay 中使用 Swoole 构建高性能 PHP 应用

什么是 Swoole？

在 ServBay 中启用 Swoole

构建一个简单的 Swoole HTTP 服务器

使用 Swoole 处理 WebSocket 连接

注意事项

总结