php-doc-en/reference/mongo/mongoconnectionexception.xml

<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->
<phpdoc:classref xml:id="class.mongoconnectionexception" 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>The MongoConnectionException class</title>
 <titleabbrev>MongoConnectionException</titleabbrev>

 <partintro>

  <!-- {{{ Mongoconnectionexception intro -->
  <section xml:id="mongoconnectionexception.intro">
   &reftitle.intro;
   <para>
    Thrown when the driver fails to connect to the database.
   </para>

   <para>
    There are a number of possible error messages, to attempt 
    to help you diagnose the connection problem.  These are:
   </para>

   <itemizedlist>
    <listitem>
     <para>
      <literal>No server name given.</literal>
     </para>
     <para>
      This error occurs if you pass in "" as the server name, 
      probably because of an typo with string interpolation, 
      e.g., "$servr" instead of "$server".
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>
       failed to get left host [hostname] or port [portnum] 
       from [server].
      </literal>
     </para>
     <para>
      <literal>
       failed to get right host [hostname] or port [portnum] 
       from [server].
      </literal>
     </para>
     <para>
      This indicated that the first or second server 
      respectively in a "server1,server2" connection string 
      was malformed.  "[hostname]" and "[portnum]" will be as 
      much as the driver could dicipher of it.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>
       failed to get host [hostname] or port [portnum] 
       from [server].
      </literal>
     </para>
     <para>
       This indicated that the server string was malformed.  
       "[hostname]" and "[portnum]" will be as much as the 
       driver could dicipher of it.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>paired connection, but no right host given</literal>
     </para>
     <para>
      The user attempted to create a paired connection but 
      passed a string that only listed one server to connect to.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>Operation in progress</literal>
     </para>
     <para>
      Connecting to the database timed out.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>More links than your body has room for: N of M</literal>
     </para>
     <para>
      N is the number of open connections and M is the 
      maximum number of connections allowed.  By default, 
      the driver allows unlimited simultaneous connections 
      to the database.  If you wish to limit them, you can set 
      mongo.max_connections and/or mongo.max_persistent (for 
      limiting perisistent connections).  If you try to create 
      more than that number of connections, you will get this 
      error.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>couldn't determine master</literal>
     </para>
     <para>
      Neither server in a paired connection appeared to be master.
     </para>
    </listitem>
    <listitem>
     <para>
      <literal>couldn't get host info for [server]</literal>
     </para>
     <para>
      This indicated that DNS could not resolve the server address 
      you gave.  This could easily be caused by a typo, for example, 
      "server" instead of "$server".
     </para>
    </listitem>
   </itemizedlist>

   <para>  
    If the error message is not listed above, it is probably an error 
    from the C socket, and you can search the web for its usual cause.
   </para>
  </section>
  <!-- }}} -->

  <section xml:id="mongoconnectionexception.synopsis">
   &reftitle.classsynopsis;

   <!-- {{{ Synopsis -->
   <classsynopsis>
    <ooclass><classname>MongoConnectionException</classname></ooclass>

    <!-- {{{ Class synopsis -->
    <classsynopsisinfo>
     <ooclass>
      <modifier>extends</modifier>
      <classname>MongoException</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
-->