With pecl version 1.0.9 of this driver, you can force long support by adding this to your php.ini:
mongo.native_long = 1
see:
http://jira.mongodb.org/browse/PHP-138
and
http://derickrethans.nl/64bit-ints-in-mongodb.html
MongoDB позволяет программистам сохранять и запрашивать данные, выраженные во всех основных типах PHP, составных типах (массивы, ассоциативные массивы и объекты) и полдюжины классов, предоставляемых драйвером PHP MongoDB (для регулярных выражений, дат и другие специализированные приложения).
NULL
TRUE
, FALSE
, и NULL
могут использоваться как есть.
Числа отличаются от строк в MongoDB: "123" не соответствует 123. Таким образом, если вы хотите убедиться, что числа отсортированы и сопоставлены правильно, вы должны убедиться, что они действительно сохраняются, как числа.
<?php
$doc = array("a" => 123, "b" => "123");
$collection->insert($doc);
$doc->find(array("a" => 123)); // совпадает
$doc->find(array("a" => "123")); // не совпадает
$doc->find(array("a" => 123.0)); // совпадает
$doc->find(array("b" => 123)); // не совпадает
$doc->find(array("b" => "123")); // совпадает
?>
Как отмечено выше, числа с плавающей запятой сравниваются с целыми числами или совпадают с ними, как и следовало ожидать.
По умолчанию, в 32-разрядной системе числа отправляются в базу данных, как 32-разрядные целые числа. В 64-битной системе они отправляются, как 64-битные целые числа. Для обратной совместимости все системы десериализуют 64-битные целые числа, как числа с плавающей запятой. Числа с плавающей точкой не являются точными. Если вам нужны точные значения, вы должны изменить настройки php.ini.
В 32-битной системе, если установлен mongo.long_as_object
,
64-битные целые числа будут возвращены, как объекты MongoInt64.
Целое число будет сохранено в поле значения с идеальной точностью (в виде строки).
Вы также можете использовать MongoInt64 для сохранения
64-разрядных целых чисел на 32-разрядных компьютерах.
В 64-битных системах вы можете установить mongo.long_as_object
или mongo.native_long
. mongo.native_long
вернет
64-битные целые и "нормальные" целые числа PHP.
Вы можете использовать MongoInt32 для сохранения 32-разрядных
целых чисел на 64-разрядных компьютерах.
Вам следует установить поведение mongo.long_as_object
и
mongo.native_long
, которое вы планируете использовать,
даже если это поведение по умолчанию (для защиты от будущих изменений по умолчанию).
Смотрите также: параметры php.ini, MongoInt32, MongoInt64.
Строки должны быть UTF-8. Строки не-UTF-8 должны быть либо преобразованы в UTF-8 перед отправкой в базу данных, либо сохранены, как двоичные данные.
Регулярные выражения могут использоваться для сопоставления строк и выражаются с использованием класса MongoRegex.
Строки, изображения и любые другие двоичные данные не в формате UTF-8 следует отправлять в базу данных с использованием типа MongoBinData.
Даты могут быть созданы с помощью класса MongoDate. Они хранятся в миллисекундах с начала Unix-эпохи.
MongoTimestamp не предназначен для сохранения дат или временных меток, он используется внутри MongoDB. Если вы не создаете инструмент, взаимодействующий с внутренними компонентами репликации или шардинга, вы должны использовать MongoDate, а не MongoTimestamp.
Драйвер автоматически создаст поле _id
перед вставкой
документа (если он не указан пользователем).
Это поле является экземпляром MongoId (в большинстве других языков
называется "ObjectId").
Эти идентификаторы имеют длину 12 байтов и состоят из:
4 байта метки времени
Никакие две записи не могут иметь одинаковый идентификатор, если они были вставлены в разное время.
3-х байтовый идентификатор машины
Никакие две записи не могут иметь одинаковый идентификатор, если они были вставлены на разных компьютерах.
2-х байтовый идентификатор потока
Никакие две записи не могут иметь одинаковый идентификатор, если они были вставлены разными потоками, работающими на одной машине.
3 байта значения приращения
Каждый раз, когда создается идентификатор, глобальный счетчик увеличивается и используется в качестве значения приращения следующего идентификатора.
MongoDB поставляется с механизмом JavaScript, так что вы можете встраивать JavaScript в запросы (используя предложение $where), отправлять его непосредственно в базу данных для выполнения и использовать для выполнения агрегации.
В целях безопасности используйте поле scope
MongoCode,
чтобы использовать переменные PHP в JavaScript.
Код, который не требует внешних значений, может использовать MongoCode или просто быть строкой.
Смотрите раздел о безопасности для получения дополнительной
информации об отправке JavaScript в базу данных.
Массивы и объекты также могут быть сохранены в базе данных. Массив с восходящими числовыми ключами будет сохранен, как массив, все остальное – как объект.
<?php
// $scores будет сохранен, как массив
$scores = array(98, 100, 73, 85);
$collection->insert(array("scores" => $scores));
// $scores будет сохранен, как объект
$scores = array("quiz1" => 98, "midterm" => 100, "quiz2" => 73, "final" => 85);
$collection->insert(array("scores" => $scores));
?>
Если вы запросите эти объекты с помощью оболочки базы данных, они будут выглядеть так:
> db.students.find() { "_id" : ObjectId("4b06beada9ad6390dab17c43"), "scores" : [ 98, 100, 73, 85 ] } { "_id" : ObjectId("4b06bebea9ad6390dab17c44"), "scores" : { "quiz1" : 98, "midterm" : 100, "quiz2" : 73, "final" : 85 } }
База данных также может сохранять произвольные объекты PHP (хотя они будут возвращаться в виде ассоциативных массивов). Поля используются для пар ключ/значение. Например, сообщение в блоге может выглядеть так:
<?php
// класс сообщения в блоге
class Post {
var $author;
var $content;
var $comments = array();
var $date;
public function __construct($author, $content) {
$this->author = $author;
$this->content = $content;
$this->date = new MongoDate();
}
public function setTitle($title) {
$this->title = $title;
}
}
// создаем простую запись в блоге и вставляем ее в базу данных
$post1 = new Post("Adam", "This is a blog post");
$blog->insert($post1);
// нет ничего ограничивающего тип поля "автор",
// поэтому мы можем сделать его вложенным объектом
$author = array("name" => "Fred", "karma" => 42);
$post2 = new Post($author, "This is another blog post.");
// мы создаем дополнительное поле, устанавливая заголовок
$post2->setTitle("Second Post");
$blog->insert($post2);
?>
Из оболочки базы данных это будет выглядеть примерно так:
> db.blog.find() { "_id" : ObjectId("4b06c263edb87a281e09dad8"), "author" : "Adam", "content" : "This is a blog post", "comments" : [ ], "date" : "Fri Nov 20 2009 11:22:59 GMT-0500 (EST)" } { "_id" : ObjectId("4b06c282edb87a281e09dad9"), "author" : { "name" : "Fred", "karma" : 42 }, "content" : "This is a blog post", "comments" : [ ], "date" : "Fri Nov 20 2009 11:23:30 GMT-0500 (EST)", "title" : "Second Post" }
Драйвер не будет обнаруживать эталонные циклы в массивах и объектах. Например, это выдаст фатальную ошибку:
<?php
$collection->insert($GLOBALS);
?>
Fatal error: Nesting level too deep - recursive dependency?
With pecl version 1.0.9 of this driver, you can force long support by adding this to your php.ini:
mongo.native_long = 1
see:
http://jira.mongodb.org/browse/PHP-138
and
http://derickrethans.nl/64bit-ints-in-mongodb.html