From 475e63b089ee0cd918914d40bd18921b09b46f79 Mon Sep 17 00:00:00 2001
From: Rui Hirokawa <hirokawa@php.net>
Date: Mon, 10 Jan 2011 01:40:51 +0000
Subject: [PATCH] added enc_type option to http_build_query.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@307319 c90b9560-bf6c-de11-be94-00142212c4b1
---
 reference/url/constants.xml                  | 22 ++++++++++++++++++++
 reference/url/functions/http-build-query.xml | 22 ++++++++++++++++++++
 2 files changed, 44 insertions(+)

diff --git a/reference/url/constants.xml b/reference/url/constants.xml
index 5d5eb72396..dc33bb2c50 100644
--- a/reference/url/constants.xml
+++ b/reference/url/constants.xml
@@ -93,6 +93,28 @@
    <listitem>
     <simpara>
      
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry>
+   <term>
+    <constant>PHP_QUERY_RFC1738</constant>
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     
+    </simpara>
+   </listitem>
+  </varlistentry>
+  <varlistentry>
+   <term>
+    <constant>PHP_QUERY_RFC3986</constant>
+    (<type>integer</type>)
+   </term>
+   <listitem>
+    <simpara>
+     
     </simpara>
    </listitem>
   </varlistentry>
diff --git a/reference/url/functions/http-build-query.xml b/reference/url/functions/http-build-query.xml
index cb198b3e16..dff420331f 100644
--- a/reference/url/functions/http-build-query.xml
+++ b/reference/url/functions/http-build-query.xml
@@ -13,6 +13,7 @@
    <methodparam><type>mixed</type><parameter>query_data</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>numeric_prefix</parameter></methodparam>
    <methodparam choice="opt"><type>string</type><parameter>arg_separator</parameter></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>enc_type</parameter></methodparam>
   </methodsynopsis>
   <para>
    Generates a URL-encoded query string from the associative (or indexed)
@@ -65,6 +66,21 @@
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>enc_type</parameter></term>
+     <listitem>
+      <para>
+        By default, or ,
+        if <constant>PHP_QUERY_RFC1738</constant> is specified, 
+        RFC1738 based scheme, that is the same way as in
+        <literal>application/x-www-form-urlencoded</literal> media type,
+        is used. The spaces are encoded as plus (+) signs in this case.
+        If <constant>PHP_QUERY_RFC3986</constant> is specified, 
+        it encodes the given string 
+        according to <link xlink:href="&url.rfc;3986">RFC 3986</link>.
+      </para>
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -100,6 +116,12 @@
         Square brackets are escaped.
        </entry>
       </row>
+      <row>
+       <entry>5.3.6</entry>
+       <entry>
+         The <parameter>enc_type</parameter> parameter was added.
+       </entry>
+      </row>
      </tbody>
     </tgroup>
    </informaltable>