mirrors/zan

高效稳定、安全易用、线上实时验证的全异步高性能网络库，通过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功能默认不打开。
1. 若不想使用async-redis客户端，可在configure时采用选项--disable-async-redis关闭。
2. 使用async-redis客户端需要安装hiredis库，当前默认已提供x86下linux/mac的hiredis库。若需要支持arm等硬件平台，需要先安装hiredis库，然后在config.m4文件中添加PHP_ADD_LIBRARY(hiredis, 1, ZAN_SHARED_LIBADD)将其编译进ZAN扩展。
3. 若想使用ssl功能，可在configure时采用选项--enable-openssl开启。
若执行phpize报xxx/sed: No such file，请重装php或将/usr/bin/sed拷贝到xxx目录下。
若执行phpize报Cannot find autoconf，请先安装autoconf工具。
若执行configure时报错libcurl not installed，请重新安转curl库，并保证库与头文件名称与路径正确。
1. 如库名称与路径/usr/lib/libcurl.so(通常带版本号的libxxx.so.xxx会软连接到libXXX.so供链接器识别)，对应头文件路径则为/usr/include/curl。
2. 确认curl库正确安装后，请务必重新phpize && configure以保证新的配置生效。
3. 若按1)、2)操作后仍然报错，则可修改config.m4中PHP_CURL的配置路径为你安装curl的路径。
若执行configure时报错enable sockets support, sockets extension installed incorrectly，请确认PHP版本及sockets扩展正确安装。
1. PHP版本需要在5.6以上版本。
2. 在PHP的include路径下应该包含头文件ext/sockets/php_sockets.h。
3. sockets扩展在zan之前加载(php.ini中的引入加载顺序)，以确保能引用符号表信息。
若执行configure时报错Enable openssl support, require openssl library，请重新安装openssl库并保证能链接正确。
1. 重新安装openssl库。
2. 添加openssl库路径供链接器找lib，如将-L/usr/local/opt/openssl/lib补充到config.m4中的LDFLAGS。
3. 添加openssl库依赖头文件路径，如将-I/usr/local/opt/openssl/include添加到config.m4中的CPPFLAGS。
4. 依然需要重新配置，按编译扩展步骤安装，见上方。

官方交流渠道

官网：点我进入

Zan 的文档仓库地址：zan-doc

在线查看文档：http://zandoc.zanphp.io ✈

QQ群：115728122

常用链接

捐赠我们

捐赠通道

License

Zan 框架基于 Apache2.0 license 进行开源。