From c30d564338ae32a941e3838e97148aa6be117494 Mon Sep 17 00:00:00 2001
From: Kristina Chodorow <kristina@php.net>
Date: Thu, 5 Aug 2010 22:18:37 +0000
Subject: [PATCH] domain socket support

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@301915 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/mongo/connecting.xml | 43 ++++++++++++++++++++++++++++++++++
 1 file changed, 43 insertions(+)

diff --git a/reference/mongo/connecting.xml b/reference/mongo/connecting.xml
index 1f4fe1c143..81ddea61d9 100644
--- a/reference/mongo/connecting.xml
+++ b/reference/mongo/connecting.xml
@@ -165,4 +165,47 @@ for ($i=0; $i<1000; $i++) {
   </para>
  </section>
 
+ <section>
+  <title>Domain Socket Support</title>
+
+  <para>
+   If you are running MongoDB locally and have version 1.0.9 or better of the 
+   driver, you can connect to the database via file.  MongoDB automatically
+   opens a socket file on startup: /tmp/mongodb-&lt;port&gt;.sock 
+   (C:\tmp\mongodb-&lt;27017&gt;.sock on Windows).
+  </para>
+
+  <para>
+   To connect to the socket file, specify the path in your MongoDB connection 
+   string:
+  </para>
+
+  <programlisting role="php">
+<![CDATA[
+<?php
+
+$m = new Mongo("mongodb:///tmp/mongo-27017.sock");
+
+?>
+]]>
+  </programlisting>
+
+  <para>
+   If you would like to use authentication on connection (as described above)
+   with a socket file, you must specify a port of 0 so that the connection
+   string parser knows where the end of the connection string is.
+  </para>
+
+  <programlisting role="php">
+<![CDATA[
+<?php
+
+$m = new Mongo("mongodb://username:password@/tmp/mongo-27017.sock:0/foo");
+
+?>
+]]>
+  </programlisting>
+
+ </section>
+
 </section>