taniele / mongofill
PECL Mongo 扩展的 Polyfill
Requires (Dev)
- athletic/athletic: dev-master
Provides
- ext-mongo: *
This package is not auto-updated.
Last update: 2024-09-14 14:51:50 UTC
README
MongoDB 驱动的纯 PHP 实现,旨在作为官方扩展的替代品,可在 HHVM 运行时使用。
安装
推荐方式
推荐的安装方式是通过 mongofill-hhvm 包作为 HHVM 的 HNI 扩展
git clone https://github.com/mongofill/mongofill-hhvm
cd mongofill-hhvm
./build.sh
您可以在 HNI 包的 构建和安装说明 中阅读完整说明。
简单方式
安装 Mongofill 的简单方式是 通过 composer。您可以在 Packagist 上查看 软件包信息。
{ "require": { "mongofill/mongofill": "dev-master" } }
注意:作为纯 PHP,phpversion('mongo') 将返回 null,并且一些库如 Doctrine 不会正常工作 除非修改,因此请使用 HNI 版本。
支持的库
您可以在维基页面 Supported-Libraries 检查当前支持的库。
社区
您可以在 Freenode 的 #mongofill 频道中找到我们。
贡献
请将测试推送到 "compat/not-passing" 分支,确保其与官方 Mongo 扩展兼容,且尚未通过。
我们非常感谢您的贡献,包括对我们的英语进行更正;)
为了确保代码库的一致性,您应确保代码遵循 PSR2 编码标准。我们建议在提交带有此标志的 pull request 之前使用 php-cs-fixer 对您的代码进行处理:php-cs-fixer fix . --level=all
运行 PHPUnit 测试
测试位于 test
文件夹中。要运行它们,您需要 PHPUnit。
phpunit --configuration phpunit.xml.dist
运行原生 mongo-php-driver 测试
您可以在 test/native/helper.sh
找到辅助脚本。您的系统必须已安装:mongodb、git、phpize 和 autotools。
cd tests/native/
./helper.sh setup
./helper.sh boot
./helper.sh run
基准测试
该软件包包含一个小型基准测试套件,您可以使用此命令运行套件:
php ./vendor/bin/athletic -b tests/bootstrap.php -p tests/Mongofill/Benchmarks/