区别
mongo扩展
扩展名是mongo.so,是一个比较老的mongodb扩展,主要用于在PHP5.X使用。建议PHP5.4及以后版本使用mongdb扩展,PHP7以后无法无法使用该扩展。该扩展官方已经不在支持。
PECL地址:https://pecl.php.net/package/mongo
使用方法介绍:http://php.net/manual/en/book.mongo.php
mongodb扩展
扩展名是mongodb.so,是目前官方维护的版本。可以直接使用该驱动,但是官方建议和PHPLIB一起使用,PHPLIB封装了一个功能更加全面的API。
PECL地址:https://pecl.php.net/package/mongodb
PHPLIB地址:https://github.com/mongodb/mongo-php-library
使用方法介绍:http://php.net/manual/en/set.mongodb.php
mongo扩展版本对应PHP版本
PHP Driver | PHP 5.3 | PHP 5.4 | PHP 5.5 | PHP 5.6 | PHP 7.0 | PHP 7.1 | PHP 7.2 |
---|---|---|---|---|---|---|---|
mongodb-1.4 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
mongodb-1.3 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
mongodb-1.2 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
mongodb-1.1 | ✓ | ✓ | ✓ | ✓ | ✓ | ||
mongodb-1.0 | ✓ | ✓ | ✓ | ||||
mongo-1.6 | ✓ | ✓ | ✓ | ✓ | |||
mongo-1.5 | ✓ | ✓ | ✓ | ✓ | |||
mongo-1.4 | ✓ | ✓ | ✓ | ||||
mongo-1.3 | ✓ | ✓ | ✓ |
mongo扩展版本对应mongodb的版本
PHP Driver | MongoDB 2.6 | MongoDB 3.0 | MongoDB 3.2 | MongoDB 3.4 | MongoDB 3.6 |
---|---|---|---|---|---|
PHPLIB 1.3 + mongodb-1.4 | ✓ | S✓ | ✓ | ✓ | ✓ |
PHPLIB 1.2 + mongodb-1.3 | ✓ | ✓ | ✓ | ✓ | |
PHPLIB 1.1 + mongodb-1.2 | ✓ | ✓ | ✓ | ✓ | |
PHPLIB 1.0 + mongodb-1.1 | ✓ | ✓ | ✓ | ||
mongodb-1.0 | ✓ | ✓ | |||
mongo-1.6 | ✓ | ✓ | |||
mongo-1.5 | ✓ | ||||
mongo-1.4 | ✓ |
升级注意事项
PHP7只支持mongodb扩展,所以要进行迁移工作,这个是升级PHP7过程中工作量比较大的一个任务。升级过程中有几点需要注意
mongodb只有长连接
mongo扩展有close()方法,PHP5.X为了保证mongodb长连接数量不至于过多,并且为了避免出现No candidate servers found(具体参考之前写的文章),每次在请求完调用该方法。但是使用mongodb扩展后,默认使用的是长连接,而且没有close()方法,所以迁移时要评估改成长连后的mongodb单台server的连接数,一般是单台php-fpm数量*机器数。
MongoId vs ObjectId
用到mongodb _id字段的时候,需要注意mongo用的是MongoId,MongoDB\BSON\ObjectId,数据格式有所变化。原来是$id,现在变成了oid字段。
var_dump(new MongoId());
//result
object(MongoId)#1 (1) {
["$id"]=>
string(24) "5b7a95522005564e3d8b4567"
}
var_dump(new MongoDB\BSON\ObjectId());
//result
object(MongoDB\BSON\ObjectId)#1 (1) {
["oid"]=>
string(24) "5b7a9599f6fd4c3d8e0c5611"
}
UTF-8编码兼容性问题
如果有非UTF-8编码的数据用mongo扩展可以读出来,用mongodb扩展读可能会抛异常(Detected corrupt BSON data), 这种一方面需要进行数据修复,另一方面需要堵住入口,避免出现此类问题。这种问题一般是在客户端发送的消息\、邮件里有特殊字符导致。
具体参考:https://github.com/mongodb/mongo-php-driver/pull/776
关于返回值的差异
- mongodb扩展isAcknowledged返回true不是代表成功,只是标识网络是OK的
- mongodb里成功可以根据update,insert,remove具体操作对应的getModifiedCount, getInsertedCount, getDeletedCount等具体数量判断。
- mongo update判断更新成功(生效)updatedExisting,但是mongodb 判断update是否成功建议用getMatchedCount,不能用getModifiedCount。举例,如果更新的内容并没有导致变化,updatedExisting返回1,getModifiedCount返回0,getMatchedCount返回1。
WriteConcern
mongo扩展里这部分是在增删改查的接口里设置(insert,update,remove等),但是在mongodb扩展里,在MongoDB\Driver\WriteConcern里指定,然后作为executeBulkWrite的参数。
更新multiple VS multi
更新时,需要指定是否更新匹配的所有记录,如果设置为false,表示只更新匹配到的一行。这个坑很大,mongo扩展里指定字段名为multiple,而mongodb扩展里使用的字段是multi。
Be First to Comment