增加子页面 增加同级页面 编辑本页
× 警告！旧版文档已经暂停维护，请查看新版文档。点击前往新版文档

环境依赖

  • 仅支持 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
最新最早最热
  • peng
    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
    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
    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
    Nixus

    有使用 CentOS 5.1.1 可用的吗？

    2017-08-09 删除
  • .
    .

    " BashOnWindows 环境下必须关闭 daemonize 选项 " -- 没理解在哪里关...

    2018-01-11 删除
  • Veitor_424
    Veitor_424

    心累，公司都是windows开发，想用swoole却用不了。。装虚拟机又要把现有的PHP环境破坏。

    2018-01-23 删除
  • marhone
    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
    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
    flyinghail

    win10 17101 已支持 signalfd，本地 17134，WSL 使用 pecl 安装 swoole 貌似没有报错

    2018-10-16 删除
  • 18670375362
    18670375362

    BashOnWindows 环境下必须关闭 daemonize 选项：daemonize在哪关 需要修改 config.h 关闭 HAVE_SIGNALFD ： 这个 config.h又是什么鬼，在哪里

    文档说明白一点吧。。。

    2019-07-16 删除
  • qzzm
    qzzm

    2014我还没毕业呢，这都2019了，还没用过swool

    2019-09-23 删除
  • banggood
    banggood

    编译安装后, php -m 可以看到swoole扩展, 但无法调用任何swoole函数, 需要注意, 再向php-fpm 的 ini文件加入 extension=swoole.so. 即需要在php和php-fpm的配置文件中都加入该扩展 希望能够对他人有帮助

    2019-10-16 删除

© Swoole.com 2008 - 2023 备案号：苏ICP备19021875号-1 | 苏公网安备苏公网安备 32058302002209号 | 版权声明

官方QQ群：810919826 开发组邮件列表： team@swoole.com 当前Swoole扩展版本：swoole-SWOOLE_VERSION