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:
立即学习“PHP免费学习笔记(深入)”;
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
ERMEB域名PHP离线网络授权系统下载感谢您选择使用ERMEB域名授权离线网络验证系统(简称:ERMEB域名授权系统)是ERMEB团队开发,ERMEB域名授权系统是国内最稳定,最强大,最先进的域名授权管理平台解决方案之一,ERMEB域名授权系统采用PHP +Mysql的技术,ERMEB域名授权系统框架使用Thinkphp6/mysql数据库基于Markdown开发者文档开发而成,项目安装请参考ThinkPHP官方文档及下面的服务环境说
配置(可根据需要开启选项)
./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 工具链。确认后重试即可。











