-
Notifications
You must be signed in to change notification settings - Fork 146
/
objectid.xml
160 lines (143 loc) · 4.92 KB
/
objectid.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: e9214a2619efc5906fab59cd42fb7404c4dc49a5 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.mongodb-bson-objectid" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>The MongoDB\BSON\ObjectId class</title>
<titleabbrev>MongoDB\BSON\ObjectId</titleabbrev>
<partintro>
<!-- {{{ MongoDB\BSON\ObjectId intro -->
<section xml:id="mongodb-bson-objectid.intro">
&reftitle.intro;
<para>
Type BSON pour un
<link xlink:href="&url.mongodb.docs.bson;#objectid">ObjectId</link>. La
valeur se compose de 12 octets, où les quatre premiers octets sont un
timestamp qui reflètent la création de l'ObjectId. Plus précisément,
la valeur se compose de :
</para>
<itemizedlist>
<listitem><simpara>une valeur de 4 octets représentant les secondes depuis l'époque UNIX,</simpara></listitem>
<listitem><simpara>un nombre aléatoire de 5 octets unique à une machine et un processus, et</simpara></listitem>
<listitem><simpara>un compteur de 3 octets, commençant par une valeur aléatoire.</simpara></listitem>
</itemizedlist>
<para>
Dans MongoDB, chaque document stocké dans une collection requiert un champ
<literal>_id</literal> unique qui agit comme clé primaire. Si un document
inséré omet le champ <literal>_id</literal>, l'extension génère
automatiquement un ObjectId pour le champ <literal>_id</literal>.
</para>
<para>
L'utilisation d'ObjectId pour le champ <literal>_id</literal> fournit les
avantages supplémentaires suivants:
</para>
<itemizedlist>
<listitem><simpara>
L'heure de création de l'ObjectId peut être accédée à l'aide de la méthode
<methodname>MongoDB\BSON\ObjectId::getTimestamp</methodname>.
</simpara></listitem>
<listitem><simpara>
Le tri sur un champ <literal>_id</literal> qui stocke des valeurs ObjectId
équivaut à peu près au tri par date de création.
</simpara></listitem>
</itemizedlist>
</section>
<!-- }}} -->
<section xml:id="mongodb-bson-objectid.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>MongoDB\BSON\ObjectId</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<modifier>final</modifier>
<ooclass>
<classname>MongoDB\BSON\ObjectId</classname>
</ooclass>
<oointerface>
<interfacename>MongoDB\BSON\ObjectIdInterface</interfacename>
</oointerface>
<oointerface>
<interfacename>MongoDB\BSON\Type</interfacename>
</oointerface>
<oointerface>
<interfacename>Serializable</interfacename>
</oointerface>
<oointerface>
<interfacename>JsonSerializable</interfacename>
</oointerface>
<oointerface>
<interfacename>Stringable</interfacename>
</oointerface>
</classsynopsisinfo>
<!-- }}} -->
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.mongodb-bson-objectid')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />
</classsynopsis>
<!-- }}} -->
</section>
<section role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>PECL mongodb 1.12.0</entry>
<entry>
Implémente <interfacename>Stringable</interfacename> pour PHP 8.0+.
</entry>
</row>
<row>
<entry>PECL mongodb 1.3.0</entry>
<entry>
<para>
Renommé de <literal>MongoDB\BSON\ObjectID</literal> vers
<literal>MongoDB\BSON\ObjectId</literal>.
</para>
<para>
Implémente <interfacename>MongoDB\BSON\ObjectIdInterface</interfacename>.
</para>
</entry>
</row>
<row>
<entry>PECL mongodb 1.2.0</entry>
<entry>
Implémente <interfacename>Serializable</interfacename> et
<interfacename>JsonSerializable</interfacename>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</section>
</partintro>
&reference.mongodb.bson.entities.objectid;
</reference>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->