× 警告！旧版文档已经暂停维护，请查看新版文档。点击前往新版文档

编译安装

Swoole扩展是按照PHP标准扩展构建的。使用phpize来生成编译检测脚本，./configure来做编译配置检测，make进行编译，make install进行安装。

请下载releases版本的swoole，直接从github主干上拉取最新代码可能会编译不过
如无特殊需求, 请务必编译安装swoole的最新版本
如果当前用户不是root，可能没有PHP安装目录的写权限，安装时需要sudo或者su
如果是在git分支上直接git pull更新代码，重新编译前务必要执行make clean

安装准备

安装前必须保证系统已经安装了下列软件

php-7.0 或更高版本
gcc-4.8 或更高版本
make
autoconf
pcre (CentOS系统可以执行命令：yum install pcre-devel)

下载地址

下载源代码包后，在终端进入源码目录，执行下面的命令进行编译和安装

新手编译示例

cd swoole
phpize (ubuntu 没有安装phpize可执行命令：sudo apt-get install php-dev来安装phpize)
./configure
make 
sudo make install

进阶完整编译示例

初次接触swoole的开发者请先尝试上方的简单编译，如果有进一步的需要，可以根据具体的需求和版本，调整以下示例的编译参数

编译参数参考

以下脚本会下载并编译master分支的源码, 需保证你已安装所有依赖, 否则会遇到各种依赖错误

mkdir -p ~/build && \
cd ~/build && \
rm -rf ./swoole-src && \
curl -o ./tmp/swoole.tar.gz https://github.com/swoole/swoole-src/archive/master.tar.gz -L && \
tar zxvf ./tmp/swoole.tar.gz && \
mv swoole-src* swoole-src && \
cd swoole-src && \
phpize && \
./configure \
--enable-coroutine \
--enable-openssl  \
--enable-http2  \
--enable-async-redis \
--enable-sockets \
--enable-mysqlnd && \
make clean && make && sudo make install

PECL

注意: PECL发布时间晚于Github发布时间

Swoole项目已收录到PHP官方扩展库，除了手工下载编译外，还可以通过PHP官方提供的pecl命令，一键下载安装

pecl install swoole

配置php.ini

编译安装成功后，修改php.ini加入

extension=swoole.so

通过php -m或phpinfo()来查看是否成功加载了swoole.so，如果没有可能是php.ini的路径不对，可以使用php --ini来定位到php.ini的绝对路径。

夜幕林

建议对于编译时使用了--enable-swoole-debug，在初始化服务的时候可以set 是否debug。不然有时候开发的时候，打印的数据都太多。

2014-09-15 删除

心的二分之1

load swoole.so,重启lnmp的时候报错了 PHP Startup: Unable to load dynamic library '/usr/local/php/lib/php/extensions/no-debug-non-zts-20090626/swoole.so 话说编译完成后,.so文件的位置是什么呢

2014-10-22 删除

田雨

php5.6,已经启用了sockets ./configure --enable-sockets --with-php-config=/usr/local/php6/bin/php-config --enable-swoole-debug -enable-async-mysql --enable-ringbuffer make的时候就会出现 Enable sockets support, But no sockets extension

2015-01-26 删除

瞿瞿Green_yy

谢谢提醒，不过应该是源码编译swoole的时候，不是mysql

2015-02-02 删除

谁伴我闯荡

真不明白为何非要搞Windows的，搞个SAMBA协议，装个Linux虚拟机，共享下开发目录，一样的本地调试！

2015-04-08 删除

lengchun

[root@lengchun swoole-src-swoole-1.7.16-stable]# LDFLAGS="-L/opt/mysql/lib" CPPFLAGS="-I/opt/mysql/include" ./configure --with-php-config=/opt/php54/bin/php-config --enable-async-mysql=/opt/mysql/include --enable-swoole --with-swoole --enable-openssl --enable-ringbuffer --enable-sockets=/opt/php54/include/php/ext/sockets --enable-swoole-debug

2015-05-11 删除

shuqi888

FreeBSD 10.2 x64版本，PHP 5.6环境下用从官网下载的源码解压安装失败，后来通过/usr/ports/devel/pecl-swoole目录make install成功

2016-01-19 删除

石长春

要停止正在运行的swoole服务

2016-04-08 删除

米天大汤

php7 php5.5两个版本共存，分别安装swoole，现在php5.5的成功，7的extensions目录下也有swoole.so，php.ini也添加了extension=swoole.so，重启了php7-fpm，php -m还是没有，swoole 1.8.4 , pecl方式也安装了，想过一样。[衰]

2016-04-17 删除

在常见错误里面找到原因和解决方案了。多谢

2016-04-18 删除

ming

服务器没有联网，不能使用pecl upgrade swoole在线更新。请问1.8.5stable怎么通过源码编译方式升级到1.8.8stable？

2016-08-04 删除

刚才直接下载了1.8.8-stable,tar.gz，解压后通过phpize方式，安装的1.8.8，重启了php-fpm，kill掉了原来的swoole server后还是原来的版本号1.8.5，请问是哪一步没有做造成的？

昌维

我也是这样我是ubuntu14 64bit，检查了其他组件版本都没问题

2016-08-28 删除

allen

centos PHP7 ，环境已安装成功。测试通过。总体来说，安装比较简单。[嘻嘻]

2016-11-22 删除

彭涛

安装完后，php -m没有swoole啊，用了两种方法安装都没有，修改php.in也是没用

2016-12-05 删除

李军锋

php server.php 这个事系统自带的php /Applications/XAMPP/bin/php server.php server.php 这个php有swoole扩展的

2016-12-08 删除

休闲时间

今天部署PHP多版本共存，遇到些问题，在编译安装swoole时，./configure需要一些参数，完整如下： ./configure --with-php-config=/usr/local/php7/bin/php-config 后边路径请替换成自己的实际路径

2016-12-24 删除

瀚海

完全同样的错误我的解决方式是把make & make install 分开就不再报错了

2017-01-21 删除

PSB

文档中的 php -m 能看到swoole 但是在phpinfo()探针函数中看不到swoole扩展模块

2017-03-14 删除

gglinux/db

PHP下面的安装，大家可以参考下：http://gglinux.com/2017/04/01/php7_install/

2017-04-02 删除

夏至冰当融

phpinfo中有swoole了,但是php-m中看不到.定位到php.ini,添加了swoole.so模块,就提示 PHP Warning: PHP Startup: Unable to load dynamic library '/usr/lib64/php/modules/swoole.so' - /usr/lib64/php/modules/swoole.so: undefined symbol: zend_new_interned_string in Unknown on line 0

2017-04-24 删除

问天涯

使用pecl安装成功

2017-05-04 删除

yum install php

yum install php-pear yum install php-devel pecl install swoole vi /etc/php.ini php -m|grep swoole

战神悟空

出现错误： PHP Warning: PHP Startup: Unable to load dynamic library '/webserver/php/lib/php/extensions/no-debug-non-zts-20131226/swoole.so' - /webserver/php/lib/php/extensions/no-debug-non-zts-20131226/swoole.so: cannot open shared object file: No such file or directory in Unknown on line 0

解决方案：直接创建目录，重新安装即可

2017-06-30 删除

爱在拜城_sunbea

我没有执行这个cd swoole phpize ./configure make sudo make install 直接将swoole扩展安装好了，没得问题吧？

2017-07-05 删除

cjj

安装的时候依赖 pcre, centos yum install pcre-devel

2017-08-09 删除

rhythm

安装完毕!

2017-09-09 删除

月半文一刀

有个命令，php --ini能打印加载的所有ini配置文件

2017-09-15 删除

Lcoper

make时报错 In file included from /usr/include/sys/mman.h:25:0, from /usr/local/swoole-2.1.0/include/swoole.h:65, from /usr/local/swoole-2.1.0/php_swoole.h:48, from /usr/local/swoole-2.1.0/swoole_trace.c:17: /usr/local/swoole-2.1.0/swoole_trace.c: In function ‘trace_dump’: /usr/local/swoole-2.1.0/swoole_trace.c:461:47: error: ‘zend_execute_data’ has no member named ‘function_state’ if (0 > trace_get_long(execute_data + offsetof(zend_execute_data, function_state.function), &l)) ^ /usr/local/swoole-2.1.0/swoole_trace.c:482:47: error: ‘zend_execute_data’ has no member named ‘op_array’ if (0 > trace_get_long(execute_data + offsetof(zend_execute_data, op_array), &l)) ^ make: *** [swoole_trace.lo] Error 1

PHP版本是7.0.0的 ,版本太低?

2018-02-23 删除

奥想瓷焅

这样写对 swoole_timer_tick(3000, function () { echo "after 3000ms.\n"; swoole_timer_after(14000, function () { echo "after 14000ms.\n"; });

}); 这样写不对

2018-04-07 删除

heydurex

make时报错 /usr/local/opt/swoole/src/os/sendfile.c:23:5: error: conflicting types for 'swoole_sendfile' int swoole_sendfile(int out_fd, int in_fd, off_t *offset, off_t size) ^ /usr/local/opt/swoole/include/swoole.h:2166:5: note: previous declaration is here int swoole_sendfile(int out_fd, int in_fd, off_t *offset, size_t size); 请问是什么原因呢

2018-04-12 删除

旧城半夏

为什么我安装出现这样的 [root@iZmrxuum7vge1gZ ~]# pecl install swoole pecl/swoole requires PHP (version >= 7.0.0), installed version is 5.5.7 No valid packages found install failed 不是PHP最低版本php-5.3.10吗？我的是5.5.7

2018-05-07 删除

拒绝

php

2018-05-23 删除

国庆七天乐

php swoole扩展的完整编译安装

https://littlefatty.top/2018/08/04/php-swoole%E6%89%A9%E5%B1%95%E7%9A%84%E5%AE%8C%E6%95%B4%E7%BC%96%E8%AF%91%E5%AE%89%E8%A3%85/

树莓派raspberry pi 3b安装swoole

https://littlefatty.top/2018/08/04/%E6%A0%91%E8%8E%93%E6%B4%BEraspberry-pi-3b%E5%AE%89%E8%A3%85swoole/

2018-08-06 删除

在centos7和树莓派(类似ubuntu server)都完整编译安装了swoole，有需要的或没安装成功的可以参考一下

曾四逗

In file included from ./php_swoole.h:38: ./include/swoole.h:70:5: error: conflicting types for 'clock_gettime' int clock_gettime(clock_id_t which_clock, struct timespec *t); 有谁遇到这种报错吗

将军

用pecl install swoole 安装后，修改了php.ini。php -m没有swoole，nable to load dynamic library 'swoole.so' (tried: /usr/local/php/lib/php/extensions/no-debug-non-zts-20170718/swoole.so (libnghttp2.so.14: cannot open shared object file: No such file or directory), /usr/local/php/lib/php/extensions/no-debug-non-zts-20170718/swoole.so.so (/usr/local/php/lib/php/extensions/no-debug-non-zts-20170718/swoole.so.so: cannot open shared object file: No such file or directory)) in Unknown on line 0

2018-08-20 删除

Aaron-森

使用 pecl install swoole 安装swoole 可能会出现 Unable to load dynamic library '/usr/lib64/php/modules/swoole.so' - /usr/lib64/php/modules/swoole.so: undefined symbol: 解决办法产看php安装的扩展如果安装了mysqli 先卸掉，重新安装mysqlnd 第二步查看这个地址 https://blog.csdn.net/qq292913477/article/details/81985824 按照这个流程基本上就能解决

2018-08-29 删除

Breeze

安装成功了 php.ini 也打开了扩展但是 php -m 可以看到 phpinfo找不到

2018-09-07 删除

命运的阳光

如果出现 libhiredis.so.0.13: cannot open shared object file: No such file or directory 说明hiredis动态链接库没找到，保证已经安装了hiredis之后执行以下命令： mkdir /usr/lib/hiredis cp libhiredis.so /usr/lib/hiredis mkdir /usr/include/hiredis cp hiredis.h /usr/include/hiredis echo '/usr/local/lib' >>/etc/ld.so.conf ldconfig

centos7，php7.2，hiredis0.13.3，测试通过

2018-09-20 删除

Hi!girl

php7.1 用pecl安装swoole扩展，生成了swoole.so ,再php.ini 中也加入了extension=swoole.so ,php -m，没有swoole。php --ri swoole 提示extension swoole no present

2018-09-28 删除

13347693301

可以了，装了openssl 但却少了openssl-devel ，低级错识

2018-12-19 删除

社会主义接班人

In file included from /private/tmp/pear/install/swoole/swoole.c:16: /private/tmp/pear/install/swoole/php_swoole.h:25:10: fatal error: 'php.h' file not found

include "php.h"

     ^~~~~~~

1 error generated. make: *** [swoole.lo] Error 1 ERROR: `make' failed

mac 10.14pecl安装swoole出现的问题

2019-01-12 删除

13625911965

./php_swoole.h:25:10: fatal error: 'php.h' file not found
#include "php.h"
         ^~~~~~~
1 error generated.
make: *** [swoole.lo] Error 1

make时，遇到了这个错误

2019-04-16 删除

13913882032

phpbize提示： Cannot find config.m4. Make sure that you run '/usr/local/php/bin/phpize' in the top level source directory of the module

2019-05-24 删除

17717372793

PHP Warning: PHP Startup: Unable to load dynamic library '/usr/lib/php/20160303/swoole.so' (tried: /usr/lib/php/20160303/swoole.dll (No such file or directory), /usr/lib/php/20180731//usr/lib/php/20160303/swoole.so.dll (No such file or directory)) in Unknown on line 0 这是个什么鬼

2019-05-27 删除

18037135713

php7.3 的php.ini文件直接写 extension=swoole 就可以了不用 .so

2019-06-20 删除

13608177739

@php大佬 https://gitee.com/swoole/swoole 直接下载吧，这个错误我搞了半天没搞明白，最后从码云上下载试试了

2019-09-11 删除

13160654717

perl 安装的swoole 提示不支持openssl 怎么办呢，卸掉换编译安装吗

2019-09-20 删除

13397644063

@cruelwolfking 可以在openssl项目，输入： yes --with-openssl-dir=/usr/local/opt/openssl ，其中 /usr/local/opt/openssl 替换为你自己的路径

2019-10-10 删除

入门指引

Server

Coroutine

Runtime

Timer

Memory

Http\Server

WebSocket\Server

Redis\Server

Process

Process\Pool

Client

Event

Async

高级

其他