Месяц: Июль 2016

Этой статье я расскажу о своем опыте миграции с устаревшего mongo PHP extension на mongodb. Расширения имеют абсолютно разный API. Поэтому есть смысл применить для нового более высокоуровневую абстракцию.

Я для этой цели использовал MongoDB PHP Library. У этой библиотеки API достаточно близок к старой версии. В документации есть upgrade guide, но без примеров. При этом есть куча мелких отличий, которые, в свою очередь, чреваты кучей багов. Ниже перечислю основные, из тех с которыми пришлось столкнуться:

1. Подключение.

Теперь подключение выглядит так:

$client = new \MongoDB\Client(
    'mongodb://rs1.example.com,rs2.example.com/?replicaSet=myReplicaSet',
    [
        'readPreference' => 'secondaryPreferred'
    ]
);

C аутентификацией (для пароля нужно добавить urlencode):

 mongodb://username:[email protected],rs2.example.com/

Если указать реплику и аутентификацию в параметрах (как было раньше) — работать не будет.

2. Объекты от старого расширения.

Используйте $db->collectionName вместо new \MongoCollection($db, ‘collectionName’).
\MongoRegex меняется на \MongoDB\BSON\Regex и принимает другие параметры на вход.
\MongoId заменен на \MongoDB\BSON\ObjectID.
Это наиболее часто используемые классы. Если используется что то еще — ищите аналоги в документации.

3. Методы find\findOne.

Теперь вместо массива будет возвращаться объект \MongoDB\Model\BSONDocument. На первый взгляд он может работать так же как массив. Но тут нужно быть осторожным. Потому что если в старом коде используется что то типа is_array(), array_merge() и т.д., в применении к такому объекту, работать это не будет.
Второй параметр теперь options. Если нужно задать список возвращаемых полей, используйте параметр projection в options:
$collection->find([], [‘projection’ => [‘id’, ‘name’, ‘email’]])
В новой библиотеке нет методов limit(), offset(), skip(), order(), nextOne(). Вместо использования методов добавляейте эти параметры в options. Например:

$collection->find([], [
    'skip' => 10,
    'limit' => 10,
    'sort' => [‘name’ => -1]
]);

*Строка в параметре limit теперь вызовет fatal error.
Так же, теперь нельзя применить метод count к курсору. Можно использовать 
$collection->count(), но не $collection->find()->count().

4. Метод update.

Теперь для этой цели много новых методов. И как с ними работать далеко не всегда очевидно.
Для себя я выбрал три:
updateOne([‘name’ => ‘foo’], [‘$set’ => [‘title’ => ‘test’, ...]]) — если нужно обновить только часть объекта. Переданный параметр ‘_id’ вызовет fatal error.
findOneAndReplace([‘name’ => ‘foo’], $fullObject) — если нужно переписать объект целиком. ‘_id’ должен быть объектом, не строкой.
updateMany([‘name’ => ‘foo’], [‘$set’ => [‘title’ => ‘test’, ...]]) — работает аналогично с updateOne.
Все эти методы возвращают MongoDB\UpdateResult, а не обновленный объект, как было раньше.

5. Остальное.

Некоторые методы были просто переименованы, например remove(), insertMany(). Практически во всех методах поменялись возвращаемые параметры.
Insert был заменен на insertOne и возвращает MongoDB\InsertOneResult.
Формат результатов в методе aggregate() был изменен.
Смотрите upgrade guide насчет других изменений.