archived-doc-es/reference/mongo/mongoexception.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: fb8f8617efe7ef5c3488038bfcab2e8b8f9bb430 Maintainer: chuso Status: ready -->
<!-- Reviewed: no -->

<phpdoc:classref xml:id="class.mongoexception" 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 MongoException</title>
 <titleabbrev>MongoException</titleabbrev>
 
 <partintro>
  
  <!-- {{{ MongoException intro -->
  <section xml:id="mongoexception.intro">
   &reftitle.intro;
   <para>
    Excepción Mongo predeterminada.
   </para>
   
   <para>
    Abarca un gran número de condiciones de error que, eventualmente, podrán moverse
    a excepciones más específicas, pero que en cualquier caso siempre extenderán
    <classname>MongoException</classname>.
   </para>
   
   <itemizedlist>
    
    <listitem>
     <para>
      <literal>The MongoSomething object has not been correctly initialized by its constructor</literal>
     </para>
     <para>
      Código: 0
     </para>
     <para>
      Probablemente tu objeto Mongo no esté conectado al servidor de bases de datos.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>zero-length keys are not allowed, did you use $ with double quotes?</literal>
     </para>
     <para>
      Código: 1
     </para>
     <para>
      Se ha intentado guardar el valor "" como clave. En general, no se debe hacer esto. ""
      podría provocar errores al acceder a subobjetos, además de que es usado internamente por MongoDB. Sin embargo,
      si realmente quiere, puede asignar en su fichero php.ini el valor true a
      <link linkend="ini.mongo.allow-empty-keys">mongo.allow_empty_keys</link> 
      para sobrescribir esta comprobación. Si se sobrescribe,
      se recomienda encarecidamente establecer la comprobación estricta de errores
      para evitar errores de interpolación de textos.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>'.' not allowed in key: &lt;key&gt;</literal>
     </para>
     <para>
      Código: 2
     </para>
     <para>
      Se ha intentado escribir una clave que contiene un ".", lo cual está prohibido.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>insert too large: &lt;size&gt;, max: &lt;max&gt;</literal>
     </para>
     <para>
      Código: 3
     </para>
     <para>
      Se ha intentado enviar demasiada información de una vez a la base de datos: la
      base de datos sólo acepta inserciones de hasta un determinado tamaño (actualmente 16 MB).
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>no elements in doc</literal>
     </para>
     <para>
      Código: 4
     </para>
     <para>
      Se ha intentado guardar un documento que no contiene ningún campo.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>size of BSON doc is &lt;size&gt; bytes, max &lt;max&gt;MB</literal>
     </para>
     <para>
      Código: 5
     </para>
     <para>
      Se ha intentado guardar un documento con un tamaño superior al que MongoDB puede guardar.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>no documents given</literal>
     </para>
     <para>
      Código: 6
     </para>
     <para>
      Se ha intentado insertar por lotes un array vacío de documentos.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>MongoCollection::group takes an array, object, or MongoCode key</literal>
     </para>
     <para>
      Código: 7
     </para>
     <para>
      Se han enviado a <function>MongoCollection::group</function> parámetros del tipo equivocado
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>field names must be strings</literal>
     </para>
     <para>
      Código: 8
     </para>
     <para>
      Deben formatearse los selectores de la siguiente forma:
      <literal>array("field1" =&gt; 1, "field2" =&gt; 1, ..., "fieldN" =&gt; 1)</literal>.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>invalid regex</literal>
     </para>
     <para>
      Código: 9
     </para>
     <para>
      La expresión regular pasada a <classname>MongoRegex</classname> no cumple la
      forma correcta.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>MongoDBRef::get: $ref field must be a string</literal>
     </para>
     <para>
      Código: 10
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>MongoDBRef::get: $db field must be a string</literal>
     </para>
     <para>
      Código: 11
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>non-utf8 string: &lt;str&gt;</literal>
     </para>
     <para>
      Código: 12
     </para>
     <para>
      Sucede cuando se intenta enviar un texto que no es utf8 a la base
      de datos. Todos los textos que se envíen a la base de datos deben estar en UTF8. Revise las
      opciones de php.ini para conocer la opción de transición que evita esta excepción.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>mutex error: &lt;err&gt;</literal>
     </para>
     <para>
      Código: 13
     </para>
     <para>
      En entornos multihebra, el driver utiliza mutex para sincronizar las
      peticiones y las respuestas. Este es un error crítico que no se puede
      trazar. Es poco usual y debe notificarse a los mantenedores junto con cualquier
      información del sistema y los pasos que se han seguido para reproducir el error.
     </para>
    </listitem>
    
    <listitem>
     <para>
      <literal>index name too long: &lt;len&gt;, max &lt;max&gt; characters</literal>
     </para>
     <para>
      Código: 14
     </para>
     <para>
      No se crearán índices con nombres superiores a 128 caracteres. Si se
      obtuviera este error, se debería usar la opción "name" de
      <function>MongoCollection::ensureIndex</function> para
      crear un nombre más corto para el índice.
     </para>
    </listitem>
    
   </itemizedlist>
  </section>
  <!-- }}} -->
  
  <section xml:id="mongoexception.synopsis">
   &reftitle.classsynopsis;
   
   <!-- {{{ Synopsis -->
   <classsynopsis>
    <ooclass><classname>MongoException</classname></ooclass>
    
    <!-- {{{ Class synopsis -->
    <classsynopsisinfo>
     <ooclass>
      <classname>MongoException</classname>
     </ooclass>
     <ooclass>
      <modifier>extends</modifier>
      <classname>Exception</classname>
     </ooclass>
    </classsynopsisinfo>
    <!-- }}} -->
    
   </classsynopsis>
   <!-- }}} -->
   
  </section>
  
 </partintro>
 
</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
-->