1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-25 07:52:21 +01:00
Files
archived-doc-es/reference/mongo/mongoid.xml
Pedro Antonio Gil Rodríguez 80920f7051 Actualización a la última versión
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@338572 c90b9560-bf6c-de11-be94-00142212c4b1
2016-02-07 22:15:51 +00:00

134 lines
4.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2d13c477872bffca1251aae994b83d531ec53144 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<phpdoc:classref xml:id="class.mongoid" xmlns:phpdoc="http://php.net/ns/phpdoc" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Clase MongoId </title>
<titleabbrev>MongoId</titleabbrev>
<partintro>
<!-- {{{ MongoId intro -->
<section xml:id="mongoid.intro">
&reftitle.intro;
<para>
Identificador único creado para objetos de bases de datos. Se se inserta un objeto sin
un campo _id en una base de datos , éste se añadirá con una instancia de
<classname>MongoId</classname>. Si los datos tuvieran un campo único natural
(p.ej., un nombre de usuario o una marca de tiempo) no habría problema en usarlo
como _id, y en este caso no se reemplazaría por un
<classname>MongoId</classname>.
</para>
<para>
Las instancias de <classname>MongoId</classname> cumplen la función de los campos
autoincrementales de las base de datos relacionales: ofrecen una clave única cuando
los datos no tienen una clave natural. Los autoincrementales no funcionan correctamente
en bases de datos compartidas, ya que es difícil determinar el siguiente número de
la secuencia. Esta clase establece las limitaciones necesarias para generar
rápidamente un valor único entre servidores compartidos.
</para>
<para>
Cada MongoId contiene 12 bytes (componiendo un string de 24 caracteres hexadecimales).
Los cuatro primeros bytes son un timestamp, los tres siguientes son un hash del nombre
de máquina del cliente, los dos siguiente son los bytes menos significativos del
id del proceso en ejecución del script, y los últimos tres corresponden a un
valor incremental.
</para>
<para>
<classname>MongoId</classname> es serializable y deserializable. Su forma serializada
es similar a su forma en string:
<screen>
<![CDATA[
C:7:"MongoId":24:{4af9f23d8ead0e1d32000000}
]]>
</screen>
</para>
</section>
<!-- }}} -->
<section xml:id="mongoid.synopsis">
&reftitle.classsynopsis;
<!-- {{{ Synopsis -->
<classsynopsis>
<ooclass><classname>MongoId</classname></ooclass>
<!-- {{{ Class synopsis -->
<classsynopsisinfo>
<ooclass>
<classname>MongoId</classname>
</ooclass>
</classsynopsisinfo>
<!-- }}} -->
<fieldsynopsis>
<modifier>public</modifier>
<type>string</type>
<varname linkend="mongoid.props.id">$id</varname>
<initializer>&null;</initializer>
</fieldsynopsis>
<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.mongoid')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[1])" />
</classsynopsis>
<!-- }}} -->
</section>
<section>
<title>Campos</title>
<variablelist>
<varlistentry xml:id="mongoid.props.id">
<term><varname>$id</varname></term>
<listitem>
<simpara>
Este campo contiene la respresentación string de este objeto.
</simpara>
<note>
<simpara>
El nombre de la propiedad comienza con un carácter <literal>$</literal>. Se podría
acceder a ella empleando la
<link linkend="language.types.string.parsing.complex">sintaxis analizada de
variables complejas</link> (p.ej., <literal>$mongoId->{'$id'}</literal>).
</simpara>
</note>
</listitem>
</varlistentry>
</variablelist>
</section>
<section>
&reftitle.seealso;
<para>
Documentación de MongoDB sobre <link xlink:href="&url.mongodb.dochub.objectids;">ObjectIds</link>.
</para>
</section>
</partintro>
&reference.mongo.entities.mongoid;
</phpdoc:classref>
<!-- 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
-->