如何启用 ServBay 中 PHP 的 Swoole 模块

ServBay 作为一款强大的本地 Web 开发环境，内置了众多开发者所需的工具和扩展，其中就包括高性能的 Swoole PHP 扩展。Swoole 是一个专为 PHP 设计的异步、并行、高性能网络通信引擎，能够显著提升 PHP 应用的性能和扩展性。本文将详细介绍如何在 ServBay 中轻松启用 Swoole 扩展，帮助您利用其强大的功能构建更高效的 PHP 应用和服务。

关于 Swoole 框架

Swoole 是一个开源项目，为 PHP 提供了类似 Node.js 的异步 I/O、协程、多进程等高级特性。通过 Swoole，PHP 开发者可以摆脱传统 Web 服务器（如 Apache/Nginx + PHP-FPM）的同步阻塞模型限制，构建高性能的常驻内存服务，如：

• 高性能 API 网关
• 实时通信应用 (WebSocket)
• 游戏服务器
• 物联网 (IoT) 应用
• 后台服务和任务处理

Swoole 的主要特点

1. 高性能: 基于 epoll/kqueue 等系统调用实现异步非阻塞 I/O，结合多线程/多进程/协程，实现高吞吐量和低延迟。
2. 异步与协程: 提供协程能力，让异步代码以同步的方式编写，大幅提高开发效率。
3. 丰富的组件: 内置了 HTTP、WebSocket、TCP、UDP 服务器和客户端，以及连接池、定时器、进程管理等功能。
4. 易于集成: 可以与现有的 PHP 框架（如 Laravel, Symfony, ThinkPHP 等）结合使用，或用于构建全新的 Swoole 原生应用。

ServBay 中 Swoole 模块的支持

ServBay 为不同版本的 PHP 都预置了 Swoole 扩展，您无需单独下载或编译安装。ServBay 负责管理不同 PHP 版本对应的 Swoole 兼容版本。

目前，ServBay 支持为以下 PHP 版本启用 Swoole 扩展：

• PHP 5.6
• PHP 7.x 系列
• PHP 8.x 系列 (包括 PHP 8.5)

ServBay 会根据您选择的 PHP 版本，自动匹配并提供相应的 Swoole 扩展文件。

前提条件

在启用 Swoole 模块之前，请确保：

• 您已成功安装并运行 ServBay。
• 您已在 ServBay 中安装并选中了您希望使用 Swoole 的 PHP 版本。

启用 Swoole 模块的操作步骤

ServBay 提供了图形界面和手动配置文件两种方式来启用 Swoole 模块，推荐使用图形界面方式，因为它更直观便捷。

通过 ServBay GUI 启用 (推荐)

这是启用 Swoole 模块最简单快捷的方式：

1. 打开 ServBay 图形用户界面。
2. 在左侧导航栏中，选择 语言 (Languages)。
3. 点击 PHP。
4. 在右侧的 PHP 版本列表中，找到您希望启用 Swoole 的 PHP 版本（例如：PHP 8.3），确保该版本当前处于选中状态（圆点为绿色）。
5. 点击该 PHP 版本右侧的 扩展 (Extensions) 按钮。
6. 在弹出的扩展列表中，找到 swoole 扩展。
7. 点击 swoole 扩展左侧的开关，将其切换为开启状态（开关变为绿色）。
8. 点击窗口底部的 保存 (Save) 或 应用 (Apply) 按钮。
9. ServBay 会提示您重启相关的 PHP 服务以加载新的扩展。点击 重启 (Restart) 按钮。

等待服务重启完成后，Swoole 模块即已成功启用。

手动编辑配置文件 (高级)

如果您需要进行更高级的配置，或者偏好手动管理配置文件，可以通过编辑 PHP 的 ini 文件来启用 Swoole。

1. 定位到对应 PHP 版本的 conf.d 配置目录。conf.d 目录用于存放额外的 PHP 扩展配置文件，ServBay 会自动加载这些目录中的 .ini 文件。例如，对于 PHP 8.3，路径通常是：

   /Applications/ServBay/etc/php/8.3/conf.d/

   请注意，如果您安装 ServBay 时选择了不同的安装路径，请根据实际路径进行调整。

2. 在该目录下，找到并打开 swoole.ini 文件。

3. 默认情况下，启用 Swoole 的行可能被注释掉了（以 ; 开头）。找到以下内容：

   [Swoole]
   ; Uncomment the following line to enable Swoole
   ;extension = swoole.so

4. 删除 ; 符号，取消对 extension = swoole.so 行的注释：

   [Swoole]
   ; Uncomment the following line to enable Swoole
   extension = swoole.so

5. 保存 swoole.ini 文件。

6. 在 ServBay GUI 的主界面或服务管理面板中，找到对应的 PHP 服务，并点击重启按钮。

重启完成后，Swoole 模块将根据配置文件成功加载。

验证 Swoole 模块是否启用成功

最常用的方法是通过 phpinfo() 函数来检查 PHP 环境中已加载的模块。

1. 在 ServBay 托管的某个网站根目录下（例如：/Applications/ServBay/www/servbay.demo/public/），创建一个名为 phpinfo.php 的文件。
2. 编辑 phpinfo.php，添加以下内容：

   <?php
   phpinfo();
   ?>

3. 确保您的 ServBay 中已配置 servbay.demo 这个网站，并且指向了包含 phpinfo.php 的目录。
4. 在浏览器中访问该文件对应的 URL，例如 https://servbay.demo/phpinfo.php。
5. 在打开的 phpinfo 页面中，向下滚动或使用浏览器搜索功能 (Ctrl+F 或 Cmd+F)，查找关键词 "swoole"。

如果页面中显示了 Swoole 的相关信息，包括版本号、配置选项等，说明 Swoole 模块已经成功加载并启用。

图示：在 phpinfo 页面中查找 Swoole 信息

使用 Swoole 示例

启用 Swoole 模块后，您就可以开始编写 Swoole 应用了。以下是一个使用 Swoole 创建一个基本 HTTP 服务器的简单示例。

示例代码：创建一个简单的 Swoole HTTP 服务器

1. 创建项目目录 在您的开发目录中（例如 /Applications/ServBay/www/ 下新建一个目录），创建一个新的项目目录，例如 my-swoole-app。在该目录下创建 public 目录用于存放入口文件。

   cd /Applications/ServBay/www/
   mkdir my-swoole-app
   cd my-swoole-app
   mkdir public

2. 创建服务器入口文件 public/index.php

   <?php
   
   require __DIR__ . '/../vendor/autoload.php'; // 如果您使用 Composer 安装了其他依赖
   
   use Swoole\Http\Server;
   use Swoole\Http\Request;
   use Swoole\Http\Response;
   
   // 创建HTTP服务器实例，监听本地所有IP (0.0.0.0) 的 9501 端口
   $server = new Server("0.0.0.0", 9501);
   
   // 设置服务器参数 (可选)
   // $server->set([
   //     'worker_num' => 4, // 工作进程数
   //     'daemonize' => false, // 是否作为守护进程运行
   // ]);
   
   // 监听请求事件
   $server->on("request", function (Request $request, Response $response) {
       // 设置响应头
       $response->header("Content-Type", "text/plain");
   
       // 设置响应体
       $response->end("Hello ServBay with Swoole!");
   });
   
   // 监听服务器启动事件 (可选)
   $server->on("start", function (Server $server) {
       echo "Swoole http server is started at http://0.0.0.0:9501\n";
   });
   
   // 启动服务器
   $server->start();
   
   echo "Swoole server stopped.\n"; // 这行代码在服务器停止后才会执行

   注意：示例中的 require __DIR__ . '/../vendor/autoload.php'; 是如果您使用了 Composer 安装了其他 Swoole 相关的库（如 swoole/ide-helper 或 Swoole 框架）才需要保留，否则可以删除。对于纯 Swoole 原生代码，通常不需要 autoload.php。

3. 通过命令行运行服务器 打开 ServBay 的终端（Terminal）功能，或者使用系统自带的终端，进入到您的项目目录 (/Applications/ServBay/www/my-swoole-app/)。确保当前终端使用的是 ServBay 管理的 PHP 版本（可以通过运行 which php 检查路径，或者使用 ServBay 的终端功能）。

   运行以下命令启动 Swoole 服务器：

   php public/index.php

   如果一切正常，您将在终端看到类似 "Swoole http server is started at http://0.0.0.0:9501" 的输出。

   图示：在终端中运行 Swoole 服务器

4. 测试访问 服务器启动后，打开浏览器访问 http://localhost:9501。您应该会看到页面显示 "Hello ServBay with Swoole!"。

   要在终端停止 Swoole 服务器，请按下 Ctrl + C。

注意事项

• 运行方式: 上述示例展示了如何通过命令行直接运行 Swoole 服务器。这种方式适用于构建常驻内存的服务。传统的 Web 应用（如使用 Laravel/Symfony/WordPress 等框架）通常运行在 PHP-FPM 模式下，通过 Caddy 或 Nginx 代理请求。如果您希望在 Swoole 环境下运行这些框架（例如使用 Hyperf, Swoole-Laravel 等），通常需要使用这些框架提供的启动脚本，并且运行方式可能与原生 Swoole 示例类似，是独立的进程。
• 端口占用: Swoole 服务器会监听指定的端口（示例中是 9501）。请确保该端口没有被其他程序占用。
• 错误日志: Swoole 的错误和输出通常会直接打印到启动它的终端，或者根据配置输出到指定日志文件。

常见问题 (FAQ)

Q: 我已经在 ServBay GUI 中启用了 Swoole，但在 phpinfo() 页面中看不到 Swoole 信息，怎么办？

A: 请检查以下几点：

1. 确保您查看的是正确 PHP 版本的 phpinfo() 页面。ServBay 可能同时运行多个 PHP 版本，请确认您访问的网站或通过命令行执行 phpinfo() 时使用的是您启用了 Swoole 的那个版本。
2. 确保在 ServBay GUI 中保存并成功重启了相应的 PHP 服务。
3. 如果手动编辑了 swoole.ini，请检查文件路径、文件名以及 extension = swoole.so 这一行是否正确且没有被注释。

Q: 为什么我运行 Swoole 示例时提示 Class 'Swoole\Http\Server' not found？

A: 这通常意味着 Swoole 扩展没有被成功加载到当前运行的 PHP 环境中。请按照上述步骤再次确认 Swoole 是否已启用，并确保您在终端运行 php public/index.php 命令时，使用的是 ServBay 管理的、且已启用 Swoole 的 PHP 版本。您可以在终端中运行 php -m | grep swoole 来快速检查当前命令行 PHP 环境是否加载了 Swoole 模块。

总结

通过 ServBay，启用 PHP 的 Swoole 扩展变得非常简单。无论是通过直观的图形界面还是手动编辑配置文件，开发者都能快速为选定的 PHP 版本加载 Swoole，从而开启高性能、异步 Web 应用的开发之旅。利用 Swoole 强大的能力，您可以轻松构建出响应更快、并发能力更强的 PHP 服务，充分发挥 PHP 在现代 Web 开发中的潜力。ServBay 提供了便捷的环境管理，让您可以专注于代码实现，而非繁琐的环境配置。