From 5dc9ad2fb79b9b5a28cd9f75ad9144810b20299a Mon Sep 17 00:00:00 2001
From: Philip Olson <philip@php.net>
Date: Fri, 1 Jul 2011 14:09:12 +0000
Subject: [PATCH] Added basic cli web server documentation.

git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@312768 c90b9560-bf6c-de11-be94-00142212c4b1
---
 features/commandline.xml | 73 +++++++++++++++++++++++++++++++++++++++-
 1 file changed, 72 insertions(+), 1 deletion(-)

diff --git a/features/commandline.xml b/features/commandline.xml
index 02578a1c08..df55c2f8fe 100644
--- a/features/commandline.xml
+++ b/features/commandline.xml
@@ -1579,7 +1579,78 @@ php >
   </note>
  </section>
  <!--}}}-->
- 
+
+ <!--Built-in CLI Web Server: {{{-->
+ <section xml:id="features.commandline.webserver">
+  <title>Built-in web server</title>
+
+  <para>
+   As of PHP 5.4.0, the &cli.sapi; provides a built-in web server.
+  </para>
+
+  <para>
+   This web server is designed for developmental purposes only, and should not
+   be used in production.
+  </para>
+
+  <example>
+   <title>Loading a file</title> 
+   <programlisting role="shell">
+<![CDATA[
+$ php -S localhost:8000 test.php
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+PHP Development Server is listening on localhost:8000 in . ... Press Ctrl-C to quit.
+]]>
+   </screen>
+  </example>
+
+  <example>
+   <title>Loading a directory</title> 
+   <programlisting role="shell">
+<![CDATA[
+$ php -S localhost:8000 -t foo/
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+PHP Development Server is listening on localhost:8000 in foo/ ... Press Ctrl-C to quit.
+]]>
+   </screen>
+  </example>
+
+  <example>
+   <title>Example output while making HTTP requests</title> 
+   <programlisting role="php">
+<![CDATA[
+<?php
+// hello.php
+echo htmlspecialchars($_GET['hello'], ENT_QUOTES, 'UTF-8');
+?>
+]]>
+   </programlisting>
+   <programlisting role="shell">
+<![CDATA[
+$ php -S localhost:8000 hello.php
+]]>
+   </programlisting>
+   &example.outputs.similar;
+   <screen>
+<![CDATA[
+[Fri Jul  1 06:29:04 2011] ::1:63530: /
+[Fri Jul  1 06:29:10 2011] ::1:63532: /?hello=world
+[Fri Jul  1 06:29:11 2011] ::1:63533: /?hello=you
+]]>
+   </screen>
+  </example>
+
+ </section>
+ <!--}}}-->
+
 </chapter>
 
 <!-- Keep this comment at the end of the file