高效稳定、安全易用、线上实时验证的全异步高性能网络库,通过PHP扩展方式提供。
遵循Apache协议,基于Swoole 1.8.5版本分支重构研发。
在此特别鸣谢Swoole开发组为PHP开源社区付出的努力和汗水。
Zan做了哪些事儿
- 大量模块解耦拆分
- 修复大量Bug、逻辑缺陷(内存泄露、释放逻辑)
- 内置通用连接池
- 支持时间轮算法
- 异步接口支持超时
- 增强Mysql client安全性(预处理、事务)
- Nova协议支持(RPC协议)
- 支持平滑重启
- 接口单元测试覆盖率100%
- 实时、全面的API文档
- ...
编译安装步骤
master分支做了较大改动,还在内测阶段,不建议上生产环境,如果要求稳定,可以下载release版本
git clone https://github.com/youzan/zan.git
cd zan-extension
phpize
./configure
make
make install
建议安装配置项
phpize
./configure --enable-openssl
make
make install
Zan编译安装常见问题
- 使用async-redis客户端及依赖sockets扩展默认打开,使用ssl功能默认不打开。
- 若不想使用async-redis客户端,可在configure时采用选项
--disable-async-redis
关闭。 - 使用async-redis客户端需要安装hiredis库,当前默认已提供x86下linux/mac的hiredis库。若需要支持arm等硬件平台,需要先安装hiredis库,然后在config.m4文件中添加
PHP_ADD_LIBRARY(hiredis, 1, ZAN_SHARED_LIBADD)
将其编译进ZAN扩展。 - 若想使用ssl功能,可在configure时采用选项
--enable-openssl
开启。
- 若不想使用async-redis客户端,可在configure时采用选项
- 若执行phpize报xxx/sed: No such file,请重装php或将/usr/bin/sed拷贝到xxx目录下。
- 若执行phpize报Cannot find autoconf,请先安装autoconf工具。
- 若执行configure时报错libcurl not installed,请重新安转curl库,并保证库与头文件名称与路径正确。
- 如库名称与路径/usr/lib/libcurl.so(通常带版本号的libxxx.so.xxx会软连接到libXXX.so供链接器识别),对应头文件路径则为/usr/include/curl。
- 确认curl库正确安装后,请务必重新phpize && configure以保证新的配置生效。
- 若按1)、2)操作后仍然报错,则可修改config.m4中PHP_CURL的配置路径为你安装curl的路径。
- 若执行configure时报错enable sockets support, sockets extension installed incorrectly,请确认PHP版本及sockets扩展正确安装。
- PHP版本需要在5.6以上版本。
- 在PHP的include路径下应该包含头文件ext/sockets/php_sockets.h。
- sockets扩展在zan之前加载(php.ini中的引入加载顺序),以确保能引用符号表信息。
- 若执行configure时报错Enable openssl support, require openssl library,请重新安装openssl库并保证能链接正确。
- 重新安装openssl库。
- 添加openssl库路径供链接器找lib,如将
-L/usr/local/opt/openssl/lib
补充到config.m4中的LDFLAGS。 - 添加openssl库依赖头文件路径,如将
-I/usr/local/opt/openssl/include
添加到config.m4中的CPPFLAGS。 - 依然需要重新配置,按编译扩展步骤安装,见上方。
官方交流渠道
官网:点我进入
Zan 的文档仓库地址:zan-doc
在线查看文档:http://zandoc.zanphp.io
QQ群:115728122
常用链接
捐赠我们
License
Zan 框架基于 Apache2.0 license 进行开源。