Add URL rewrite example

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@339973 c90b9560-bf6c-de11-be94-00142212c4b1

reference/outcontrol/examples.xml

@@ -2,6 +2,7 @@
 <!-- $Revision$ -->
 <appendix xml:id="outcontrol.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   &reftitle.examples;
+
   <section xml:id="outcontrol.examples.basic">
   <title>Basic usage</title>
   <para>
@@ -32,6 +33,55 @@ ob_end_flush();
    to the browser after data has already been sent.)
   </para>
  </section>
+
+  <section xml:id="outcontrol.examples.rewrite">
+  <title>Ouput rewrite usage</title>
+  <para>
+   Since PHP 7.1.0, <function>output_add_rewrite_var</function>, <function>output_reset_rewrite_vars</function> use dedicated output buffer. i.e. It does not use <link linkend="ini.session.use-trans-sid">trans sid</link> output buffer. 
+  </para>
+  <para>
+   <example>
+    <title>Output rewrite example</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// This code works with PHP 7.1.0, 7.0.10, 5.6.25 and up.
+
+// HTTP_HOST is default target host. Set manually to make sample code works.
+$_SERVER['HTTP_HOST'] = 'php.net';
+
+// Output rewriter only rewrite from. Add a=href.
+// Tags can be specified tag_name=url_attr, e.g. img=src,iframe=src
+// No space allowed between settings.
+// Form tag is special tag that add hidden input.
+ini_set('url_rewriter.tags','a=href,form=');
+var_dump(ini_get('url_rewriter.tags'));
+
+// This is added to URL and form
+output_add_rewrite_var('test', 'value');
+?>
+<a href="//php.net/index.php?bug=1234">bug1234</a>
+<form action="https://php.net/?bug=1234&edit=1" action="post">
+ <input type="text" name="title" />
+</form>
+]]>
+    </programlisting>
+    &example.outputs;
+    <screen>
+<![CDATA[
+<a href="//php.net/?bug=1234&test=value">bug1234</a>
+<form action="https://php.net/?bug=1234&edit=1" method="post"><input type="hidden" name="test" value="value" />
+ <input type="text" name="title" />
+</form>
+]]>
+    </screen>
+   </example>
+  </para>
+  <para>
+   Since PHP 7.1.0, output rewrite functions have it's own INI settings, <link linkend="ini.url-rewriter.tags">url_rewriter.tags</link> and <link linkend="ini.url-rewriter.hosts">url_rewriter.hosts</link>. 
+  </para>
+ </section>
+
 </appendix>
 
 <!-- Keep this comment at the end of the file