koubas/mongofill

此软件包已被废弃,不再维护。未建议替代软件包。

PECL Mongo 扩展的 polyfill

dev-master 2016-11-13 21:50 UTC

This package is not auto-updated.

Last update: 2020-01-24 14:47:35 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 版本。

支持的库

您可以在 wiki 页面 支持的库 中检查当前支持的库。

社区

您可以在 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/

一些结果可以在:https://gist.github.com/mcuadros/9551290 找到

注意事项

副本集 & APC

当使用副本集时,Mongofill 驱动程序需要检索有关副本集配置和状态的信息。为了提高性能,驱动程序将尝试使用 APC(apc_fetch、apc_store)来缓存副本集数据。

APC功能应与HHVM自动安装,但如果你计划使用PHP的Mongofill驱动程序,你需要确保已安装APC以获得性能提升。

对于PHP 5.5及以上版本,这将是APCu扩展。如果没有安装APC,副本集仍然可以工作,但它们的速度不会那么快。