扩展安装

版本确认

打开phpinfo页面或者php -i确认版本信息：

• PHP版本，使用php -v
• 是否为Debug版本，使用 php -i | grep "Debug Build"查看是否有Debug Build => yes，Swoole Compiler不支持Debug版本，请安装非Debug版本的PHP
• 是否为线程安全版本，使用php -i |grep Thread
• 是否为64位系统，Swoole Compiler不支持32位系统

确认以上信息后，找到对应的swoole_loader并下载。下载后，将对应的文件放置到PHP扩展目录中。

• Linux可使用php -i | grep extension_dir找到扩展目录
• Windows一般在PHP安装目录下的ext子目录中

配置 php.ini

修改php.ini，加入：

• Windows：extension=php_swoole_loader.dll
• Linux：extension=swoole_loader.so

另外，可修改 php.ini 将 display_startup_errors = on 开启扩展加载错误日志。

需要重启 Apache 服务或 PHP-FPM，成功后使用 php -m 或 phpinfo 页面确认是否安装成功。

与 OPcache 同时使用

opcache.jit=0
opcache.file_cache=/tmp/php-opcache
opcache.file_cache_only=1

Swoole、Hyperf等CLI常驻进程还需要设置opcache.enable_cli=1。缓存目录必须提前创建，并确保PHP运行用户拥有读写权限。完整说明参见性能优化。

在 Docker 中使用 Swoole Loader

Swoole Loader 可复制到Docker镜像中使用

1. 根据镜像的PHP版本，选择对应的Swoole Loader文件
2. 编写 Dockerfile 使用 COPY 命令从本地复制到镜像中
3. 请使用Debian或CentOS、Ubuntu作为基础镜像，不支持Alpine Linux镜像

若您是基础版、高级版或旗舰版用户，可联系识沃客服，索要alpine linux专用的swoole_loader扩展

扩展冲突

请关闭 xdebug、ioncube loader、zend guard loader 等影响 PHP 底层行为的扩展。