Введение в MongoDB

Выбор коллекции, в которой вы хотите сохранить ваши объекты, очень похож на выбор базы данных; выберите коллекцию сообщений , обратившись к ней как к свойству объекта MongoDB .

 <?php $collection = $db->posts; 

$collection теперь содержит объект MongoCollection представляющий коллекцию сообщений.

Если нет базы данных или коллекции с указанным вами именем, MongoDB создаст новую с этим именем, как только вы вставите свой первый объект документа. В качестве альтернативы вы можете заставить MongoDB создать коллекцию ранее, используя метод createCollection() .

 <?php $collection = $db->createCollection("posts"); 

Вставка документов

Чтобы вставить новый объект в коллекцию публикаций, вы используете MongoCollection insert() объекта MongoCollection , передавая массив данных для сохранения.

 <?php $document = array( "title" => "cat with a hat", "content" => "once upon a time a cat with a hat ..."); $collection->insert($document); 

Вы можете видеть, что $document — это просто простой ассоциативный массив. После вызова insert() массив изменяется с новым ключом _id и добавлением значения экземпляра объекта MongoId .

  массив
 (
     [title] => кот в шляпе
     [content] => однажды кот в шляпе ...
     [_id] => Объект MongoId
         (
             [$ id] => 4ea2213af7ede43c53000000
         )
 ) 

_id является первичным ключом для документа и должен быть уникальным для каждого объекта документа в коллекции. Как правило, хорошей идеей будет позволить MongoDB назначить ключ, так как тогда вы можете быть уверены, что столкновений не будет.

Если вы попытаетесь снова использовать тот же массив с insert() вы получите MongoCursorException так как идентификатор уже существует в коллекции. Идите и попробуйте вставить один и тот же документ дважды …

 <?php $document = array( "title" => "cat with a hat", "content" => "once upon a time a cat with a hat ..."); $collection->insert($document); $collection->insert($document); 

Хм, а это что? Нет исключения было выброшено?

Вы не получили ошибку, потому что вы не делаете безопасную вставку . Расширение MongoDB для PHP по умолчанию выполняет все операции асинхронно, поэтому вам не нужно ждать, пока сервер ответит, что данные были успешно сохранены. Эта функция позволяет перейти к следующей задаче, не дожидаясь подтверждения того, были ли данные сохранены или нет, и это может быть очень удобно, но для важных данных вы можете захотеть убедиться, что объект документа действительно был сохранен и никаких ошибок не произошло. Вы можете достичь этого, передав массив во втором параметре insert() с ключом safe, установленным в true.

Попробуйте еще раз, но на этот раз передайте второй параметр insert() .

 <?php $insertOpts = array("safe" => true); $collection->insert($document, $insertOpts); $collection->insert($document, $insertOpts); 

Теперь вы получите исключение, о котором я упоминал ранее, поскольку вы выполняете безопасную вставку, а другой объект с таким же идентификатором уже существует в коллекции.

Обновление документов

Если вы хотите изменить существующий объект документа, вы можете использовать метод save() .

 <?php $document["author"] = "Shreef"; $collection->save($document); 

Если переданный массив не имеет ключа _id , документ будет вставлен и будет назначен первичный ключ. Если массив уже имеет ключ _id, объект документа будет обновлен. Как и insert() , save() также принимает необязательный второй параметр.

Метод save() — не единственный способ обновить существующий объект; Вы также можете использовать метод update() . update() принимает критерии объекта, который вы хотите обновить, в качестве первого параметра, а обновленный объект — в качестве второго параметра.

Допустим, я хочу найти все объекты, ключ автора которых равен «Shreef», и обновить значение до «Timothy». Я мог бы попробовать следующее:

 <?php $collection->update( array("author" => "Shreef"), array("author" => "Timothy")); 

Хотя это работает, оно также имеет непреднамеренное последствие удаления всех других полей в соответствующих документах; единственные поля, которые у них были бы, были бы автором ! Это не то, что я хотел. Чтобы обновить только значение ключа автора и оставить остальные ключи / значения нетронутыми, необходимо использовать модификатор $set .

 <?php $collection->update( array("author" => "Shreef"), array('$set' => array("author" => "Timothy"))); 

Но это все еще не совсем то, что я хотел, так как MongoDB обновит только первый соответствующий объект, который он найдет. Чтобы обновить все соответствующие объекты документа, вам нужно передать массив в качестве третьего параметра для update() с ключом множественного числа, установленным в значение true.

 <?php $collection->update( array("author" => "Shreef"), array('$set' => array("author" => "Timothy")), array("multiple" => true)); 

Наконец я могу обновить все соответствующие записи так, как я хотел. Модификатор $set обеспечивает обновление только значения ключа автора , а множественный ключ сообщает MongoDB об обновлении каждого соответствующего объекта документа, который он находит.

Выбор документов

Чтобы выбрать все сохраненные документы из коллекции, которые соответствуют некоторым критериям, вы используете метод find() . Метод принимает критерии вашего запроса в качестве первого параметра и, необязательно, в качестве второго параметра, он может взять массив имен полей, которые нужно вернуть вместо всего объекта.

 <?php $cursor = $collection->find(array("author" => "shreef")); foreach ($cursor as $document) { print_r($document); } 

find() возвращает объект MongoCursor который вы можете использовать для перебора результатов.

Если вы хотите получить только одно значение, вы можете использовать метод findOne() который будет возвращать только массив с полями первого соответствующего объекта.

 <?php $document = $collection->findOne(array("author" => "shreef")); print_r($document); 

Резюме

MongoDB — это очень простая, но мощная база данных, которую вы можете использовать, если у вас большие объемы неструктурированных данных. Есть много, намного больше возможностей, чем то, что я упомянул в этой статье, и, возможно, я напишу еще одну статью, обсуждая некоторые из них в будущем. До этого старайтесь следовать примерам, упомянутым в статье, и не стесняйтесь оставлять комментарии на любые ваши вопросы.

Изображение через график / Shutterstock