什么是Swoole框架？

Swoole是一个面向生产环境的PHP异步网络通信引擎，使PHP开发人员可以编写高性能的异步并发TCP、UDP、Unix Socket、HTTP，WebSocket服务。 Swoole可以广泛应用于互联网、移动通信、企业软件、云计算、网络游戏、物联网、车联网、智能家居等领域。

安装前准备

在安装Swoole之前，请确保您的系统满足以下要求：

重要提示： 在安装Swoole之前，请确保已安装PHP开发包（php-dev）和必要的构建工具（如build-essential）。

安装方法一：使用PECL安装

PECL是安装PHP扩展最简便的方法，适合大多数环境。

具体命令：

# 更新PECL
sudo pecl update-channels

# 安装Swoole
sudo pecl install swoole

# 安装过程中会提示一些配置选项，一般情况下按回车使用默认值即可

# 将扩展添加到php.ini
echo "extension=swoole.so" | sudo tee -a /path/to/your/php.ini

# 重启PHP服务（根据你的PHP运行方式选择）
sudo service php-fpm restart   # 使用PHP-FPM时
sudo service apache2 restart   # 使用Apache时

# 验证安装
php -m | grep swoole

安装方法二：源码编译安装

源码安装适用于需要自定义编译选项或特定版本的情况。

具体命令：

# 下载最新稳定版
wget https://github.com/swoole/swoole-src/archive/refs/tags/v5.0.3.tar.gz

# 解压
tar zxvf v5.0.3.tar.gz
cd swoole-src-5.0.3/

# 准备构建环境
phpize

# 配置编译选项
./configure --enable-openssl --enable-http2 --enable-sockets

# 编译并安装
make
sudo make install

# 将扩展添加到php.ini
echo "extension=swoole.so" | sudo tee -a /path/to/your/php.ini

# 重启PHP服务
sudo service php-fpm restart

# 验证安装
php --ri swoole

安装方法三：使用Docker安装

Docker是快速部署Swoole环境的理想选择，特别适合开发测试环境。

使用官方Swoole镜像：

# 拉取官方Swoole镜像
docker pull phpswoole/swoole

# 运行容器
docker run -d --name my_swoole \
  -v /path/to/your/code:/var/www \
  -p 9501:9501 \
  phpswoole/swoole

自定义Dockerfile：

FROM php:8.1-cli

# 安装依赖
RUN apt-get update && apt-get install -y \
    libssl-dev \
    libcurl4-openssl-dev

# 安装Swoole
RUN pecl install swoole && \
    docker-php-ext-enable swoole

# 复制项目文件
COPY . /usr/src/myapp
WORKDIR /usr/src/myapp

# 暴露端口
EXPOSE 9501

# 启动命令
CMD ["php", "server.php"]

验证Swoole安装

安装完成后，请使用以下方法验证Swoole是否成功安装：

方法1：命令行检查

# 检查模块是否加载
php -m | grep swoole

# 查看Swoole扩展详细信息
php --ri swoole

方法2：创建测试脚本

创建一个名为 test_swoole.php 的文件：

<?php
// 检查Swoole扩展是否加载
if (!extension_loaded('swoole')) {
    exit("Swoole扩展未加载");
}

// 创建一个简单的HTTP服务器
$http = new Swoole\Http\Server("0.0.0.0", 9501);

$http->on("start", function ($server) {
    echo "Swoole HTTP服务器已启动：http://127.0.0.1:9501\n";
});

$http->on("request", function ($request, $response) {
    $response->header("Content-Type", "text/plain");
    $response->end("Hello Swoole! 版本: ".SWOOLE_VERSION);
});

$http->start();

运行脚本：php test_swoole.php
访问 http://localhost:9501 查看结果

常见问题及解决方案

# Ubuntu/Debian
sudo apt-get install php-dev autoconf

# CentOS/RHEL
sudo yum install php-devel autoconf

# Ubuntu/Debian
sudo apt-get install libssl-dev

# CentOS/RHEL
sudo yum install openssl-devel