环境依赖-Swoole-Swoole文档中心
Swoole
Swoole内核开发
PHP-X
搜索
搜索
入门指引
环境依赖
编译安装
程序骨架
快速起步
编程须知
版本更新记录
向下不兼容改动
新特性使用
项目路线图
php.ini选项
内核参数调整
开发者列表
衍生开源项目
用户与案例
提交错误报告
常见问题
Server
Coroutine
Runtime
Timer
Memory
Http\Server
WebSocket\Server
Redis\Server
Process
Process\Pool
Client
Event
Async
高级
其他
增加子页面
增加同级页面
编辑本页
更多...
Toggle Dropdown
历史修改记录
贡献者名单
警告！旧版文档已经暂停维护，请查看新版文档。点击前往新版文档
环境依赖
仅支持 Linux、FreeBSD、MacOS 三种操作系统
在Windows平台，可使用CygWin或WSL(Windows Subsystem for Linux)
Linux 内核版本 2.3.32 以上
gcc-4.8或更高版本，依赖C++11
编译为 libswoole.so 作为 C/C++ 库时需要使用 cmake-2.4 或更高版本
建议使用 Ubuntu14、CentOS7 或更高版本的操作系统
低版本系统（如CentOS 6）可以使用RedHat提供的devtools编译，参考文档
PHP版本依赖
Swoole-1.x需要 PHP-5.3.10 或更高版本
Swoole-4.x需要 PHP-7.0.0 或更高版本
不依赖 PHP 的 stream、sockets、pcntl、posix、sysvmsg 等扩展。PHP 只需安装最基本的扩展即可
对PHP版本支持和PHP官方维护版本保持一致，参考PHP版本支持时间表
PHP-7.3 版本的 pcre.jit 存在 bug，可能会导致进程持续崩溃，请修改 php.ini 设置 pcre.jit=0
ARM平台（树莓派Raspberry PI）
请使用 1.7.10 或更高版本
使用 GCC 交叉编译
在编译 Swoole 时，需要手工修改 Makefile 去掉 -O2 编译参数
MIPS平台（OpenWrt路由器）
请使用 swoole-1.7.21 或更高版本
使用 GCC 交叉编译
Cygwin环境支持（Windows系统）
swoole-1.7.7 增加了对 cygwin 环境的支持，在 Windows 环境下，可以直接使用 cygwin + php 来跑 swoole 程序。
安装 cygwin，并安装 gcc、make、autoconf、php 4个包
下载swoole源码，在 cygwin-shell 中进行 phpize/configure/make/make install
修改 php.ini，加入 swoole.so
cygwin 模式下需要对 PHP 进行简化，去掉不使用的扩展，避免进程占用内存过大，导致 Fork 操作失败
目前提供 Cygwin 二进制包，可以在官网进行下载：https://www.swoole.com/page/download ，如有问题请反馈至开发组邮箱 team@swoole.com
BashOnWindows
Windows 10 系统增加了 Linux 子系统支持，BashOnWindows 环境下也可以使用 swoole。安装命令
apt-get install php7.0 php7.0-curl php7.0-gd php7.0-gmp php7.0-json php7.0-mysql php7.0-opcache php7.0-readline php7.0-sqlite3 php7.0-tidy php7.0-xml php7.0-bcmath php7.0-bz2 php7.0-intl php7.0-mbstring php7.0-mcrypt php7.0-soap php7.0-xsl php7.0-zip
pecl install swoole
echo 'extension=swoole.so' >> /etc/php/7.0/mods-available/swoole.ini
cd /etc/php/7.0/cli/conf.d/ && ln -s ../../mods-available/swoole.ini 20-swoole.ini
cd /etc/php/7.0/fpm/conf.d/ && ln -s ../../mods-available/swoole.ini 20-swoole.ini
BashOnWindows 环境下必须关闭 daemonize 选项
低于17101的WSL，源码安装configure后需要修改 config.h 关闭 HAVE_SIGNALFD
DockerOnWindows
在 Windows 下开发可以使用 Hyper-V+Docker 来方便的开发 Swoole 应用，安装好 Docker 后再 Settings 里的 Shared Drives 选项里共享代码所在磁盘。然后使用如下命令来快速启动 Docker 容器。
docker run --rm -t -i --name myapp -p 9501:9501 -v e:/path/to:/app:rw xutongle/php:7.1-fpm /bin/bash
e:/path/to 为源码所在路径
/app 为容器内路径
在 bash 里执行 cd /app && php server.php
最新最早最热
41.9万次阅读 21条评论
peng
我给openwrt编译的时候，提示libtool版本太新，但是给x86平台编译的时候，libtool的2.4.6的版本也是可以用的，不知道这个问题怎么解决
2015-11-03
删除
听见你的声音
ubuntu安装swoole成功了，也添加了swoole.so但是php -m 就是看不到swoole，phpinfo()里可以看到，不知道为什么？
2016-01-16
删除
天风无边
你好，差不多的问题，影响使用吗？ubuntu 14.04
2016-01-28
删除
wem
为什么我用cygwin来安装总是失败呢？都安装了gcc、make、autoconf、php 和pcre-devel，仍然失败
2016-03-07
删除
饿狼狼窝
php -m 使用的 cli, phpinfo 使用的是 php-fpm ， 它们加载php.ini不是一个， 可以使用php -i | grep php.ini查看一下Php.ini 的路径， 在里面加上swoole.so 就可以了
2016-03-09
删除
php-fpm server 没有配置扩展
2016-04-29
删除
Hades
你要看cli模式下加载的是哪个php.ini
2016-05-05
删除
李朋飞
今天在bash on ubuntu on windows 上装了swoole，准备尝试一下
2016-09-04
删除
风华尽去
我也遇到这个问题，不知道是啥没装。
2017-01-13
删除
唐建-六艺土鳖开源
Windows 10系统增加了Linux子系统支持，BashOnWindows环境下也可以使用swoole。安装命令
apt-get install libpcre3 libpcre3-dev php php-dev php-cli php-fpm php-curl php-mysql php-intl php-xmlrpc php-geoip php-mysqlnd php-mcrypt php-memcached php-redis php-tidy php-sqlite php-json php-gmp php-gd php-readline php*-imagick
2017-06-14
删除
Nixus
有使用 CentOS 5.1.1 可用的吗？
2017-08-09
删除
" BashOnWindows 环境下必须关闭 daemonize 选项 " -- 没理解在哪里关...
2018-01-11
删除
Veitor_424
心累，公司都是windows开发，想用swoole却用不了。。装虚拟机又要把现有的PHP环境破坏。
2018-01-23
删除
marhone
我的是win10, linux子系统是ubuntu16.04, 安装swoole是从github下载的源码编译, 当前release是v1.10.1,
解压后打开config.m4文件,找到含有 HAVE_SIGNALFD 那行, 把它直接删掉
2018-02-04
删除
大浪淘沙
请教各位大神一个问题：系统：ubuntu16.04, 环境lamp ，php版本7.0 在编译安装执行make&make install时报错：
Installing shared extensions: /usr/lib/php/20151012/
cp: cannot create regular file '/usr/lib/php/20151012/#INST@12714#': Permission denied
Makefile:88: recipe for target 'install-modules' failed
make: *** [install-modules] Error 1，，，请问这是什么情况？
2018-05-24
删除
Gliiiiiitchy
实际上bash on windows没法用task workers?
2018-05-29
删除
子山
docker安装swoole2.2.0
sudo docker run --privileged --restart=always -ti -v /var/www:/var/www -d -p 2221:22 -p 80:80 -p 443:443 -p 9501:9501 -p 9502:9502 -p 9503:9503 -p 9504:9504 -p 9505:9505 -p 9506:9506 --name php_swoole registry.cn-hangzhou.aliyuncs.com/louislivi/swoole /usr/sbin/init
2018-06-04
删除
flyinghail
win10 17101 已支持 signalfd，本地 17134，WSL 使用 pecl 安装 swoole 貌似没有报错
2018-10-16
删除
18670375362
BashOnWindows 环境下必须关闭 daemonize 选项：daemonize在哪关
需要修改 config.h 关闭 HAVE_SIGNALFD ： 这个 config.h又是什么鬼，在哪里
文档说明白一点吧。。。
2019-07-16
删除
qzzm
2014我还没毕业呢，这都2019了，还没用过swool
2019-09-23
删除
banggood
编译安装后, php -m 可以看到swoole扩展, 但无法调用任何swoole函数, 需要注意, 再向php-fpm 的 ini文件加入 extension=swoole.so. 即需要在php和php-fpm的配置文件中都加入该扩展 希望能够对他人有帮助
2019-10-16
删除
发布
Swoole.com 2008 - 2022 备案号：苏ICP备19021875号-1 | 苏公网安备 32058302002209号 | 版权声明
官方QQ群：810919826 开发组邮件列表：
team@swoole.com
当前Swoole扩展版本：swoole-SWOOLE_VERSION