Swoole是PHP的高性能C扩展，需通过pecl或源码编译安装，不支持Composer直接安装；首先确认PHP版本≥7.0并安装编译工具，推荐使用pecl install swoole方式，或从GitHub下载源码后phpize、./configure、make进行编译安装，完成后在php.ini中添加extension=swoole.so并验证php -m | grep swoole，成功后可选Hyperf或Swoft等基于Swoole的框架。

安装 Swoole 扩展并不是安装一个 PHP 框架，而是为 PHP 安装一个高性能的扩展，用于实现异步编程、协程、TCP/UDP 服务等。Swoole 是以 PHP 扩展的形式存在的，不是通过 Composer 安装的普通框架。以下是详细的安装方法。

1. 确认环境要求

在安装前，请确保你的环境满足以下条件：

• PHP 版本 >= 7.0（推荐 PHP 7.4 或 8.x）
• 操作系统：Linux、macOS 或 Windows（通过 WSL）
• 有 root 或 sudo 权限（用于编译安装）
• 已安装 gcc、make、autoconf 等编译工具

注意：Swoole 是 C 扩展，不能通过 Composer 直接安装核心扩展，但可以使用基于 Swoole 的框架（如 Hyperf、Swoft）通过 Composer 引入。

2. 使用 pecl 安装（推荐方式）

最简单的方式是使用 PHP 的包管理工具 pecl：

pecl install swoole

执行后会自动下载并编译 Swoole 扩展。如果提示找不到 pecl，可通过以下命令安装：

• Ubuntu/Debian: sudo apt-get install php-pear php-dev
• CentOS/RHEL: sudo yum install php-pear php-devel

3. 编译安装（适用于自定义配置）

如果需要启用特定功能（如支持 SSL、MySQL、http2 等），建议从源码编译：

# 下载最新版本（前往 https://github.com/swoole/swoole-src 查看最新版）
wget https://github.com/swoole/swoole-src/archive/v5.1.0.tar.gz
tar -xzf v5.1.0.tar.gz
cd swoole-src-5.1.0
生成配置文件
phpize
配置（可根据需要开启选项）
./configure --enable-openssl --enable-http2 --enable-mysqlnd
编译并安装
make && sudo make install

4. 启用 Swoole 扩展

安装完成后，需在 php.ini 中启用扩展：

• 找到 php.ini 文件位置：php --ini
• 添加一行：extension=swoole.so

保存后，检查是否安装成功：

php -m | grep swoole

或运行：php -r "echo SWOOLE_VERSION;" 输出版本号即表示成功。

5. 安装基于 Swoole 的框架（可选）

如果你需要的是像 Laravel 一样的“框架”，可以考虑使用基于 Swoole 的现代 PHP 框架：

• Hyperf: composer create-project hyperf/hyperf-skeleton
• Swoft: composer create-project swoft/swoft

这些框架依赖 Swoole 扩展，因此必须先安装 Swoole 扩展。

基本上就这些。只要 PHP 环境正常，安装 Swoole 扩展并不复杂，关键是编译时权限和依赖要齐全。常见问题多出在缺少 php-devel 或 gcc 工具链。确认后重试即可。