From 773cd45365748a02a000861a6405237ad21554a6 Mon Sep 17 00:00:00 2001
From: Kristina Chodorow <kristina@php.net>
Date: Mon, 22 Feb 2010 17:23:51 +0000
Subject: [PATCH] added mongo.utf8 option

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

diff --git a/reference/mongo/ini.xml b/reference/mongo/ini.xml
index f45d0a2f67..49097517c2 100644
--- a/reference/mongo/ini.xml
+++ b/reference/mongo/ini.xml
@@ -55,6 +55,11 @@
       <entry>"$"</entry>
       <entry>PHP_INI_ALL</entry>
      </row>
+     <row>
+      <entry><link linkend="ini.mongo.utf8">mongo.utf8</link></entry>
+      <entry>"1"</entry>
+      <entry>PHP_INI_ALL</entry>
+     </row>
     </tbody>
    </tgroup>
   </table>
@@ -167,6 +172,25 @@
     </listitem>
    </varlistentry>  
 
+   <varlistentry xml:id="ini.mongo.utf8">
+    <term>
+     <parameter>mongo.utf8</parameter>
+     <type>int</type>
+    </term>
+    <listitem>
+     <para>
+      If an exception should be thrown for non-UTF8 strings.  Until version 
+      1.0.4, the PHP driver would ignore non-UTF8 strings, even though you're
+      not supposed to insert them.  As of 1.0.4, the driver throws a 
+      <classname>MongoException</classname>.  To ease the transition for 
+      applications that insert non-UTF8 strings, you can turn this option off to
+      emulate the old, non-exception-throwning behavior.  This option will be
+      eliminated and exceptions always thrown for non-UTF8 strings starting with
+      version 1.0.6.
+     </para>
+    </listitem>
+   </varlistentry>  
+
   </variablelist>
  </para>
 </section>