Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:70145
Return-Path: <christopher.jones@oracle.com>
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Delivered-To: mailing list internals@lists.php.net
Received: (qmail 91744 invoked from network); 15 Nov 2013 00:39:23 -0000
Received: from unknown (HELO lists.php.net) (127.0.0.1)
  by localhost with SMTP; 15 Nov 2013 00:39:23 -0000
Authentication-Results: pb1.pair.com header.from=christopher.jones@oracle.com; sender-id=pass
Authentication-Results: pb1.pair.com smtp.mail=christopher.jones@oracle.com; spf=pass; sender-id=pass
Received-SPF: pass (pb1.pair.com: domain oracle.com designates 156.151.31.81 as permitted sender)
X-PHP-List-Original-Sender: christopher.jones@oracle.com
X-Host-Fingerprint: 156.151.31.81 userp1040.oracle.com  
Received: from [156.151.31.81] ([156.151.31.81:18448] helo=userp1040.oracle.com)
	by pb1.pair.com (ecelerity 2.1.1.9-wez r(12769M)) with ESMTP
	id A9/90-22022-53D65825 for <internals@lists.php.net>; Thu, 14 Nov 2013 19:39:18 -0500
Received: from ucsinet21.oracle.com (ucsinet21.oracle.com [156.151.31.93])
	by userp1040.oracle.com (Sentrion-MTA-4.3.1/Sentrion-MTA-4.3.1) with ESMTP id rAF0dE34009220
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=OK);
	Fri, 15 Nov 2013 00:39:15 GMT
Received: from aserz7022.oracle.com (aserz7022.oracle.com [141.146.126.231])
	by ucsinet21.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rAF0dDLJ015545
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO);
	Fri, 15 Nov 2013 00:39:14 GMT
Received: from abhmp0016.oracle.com (abhmp0016.oracle.com [141.146.116.22])
	by aserz7022.oracle.com (8.14.4+Sun/8.14.4) with ESMTP id rAF0dDmu002642;
	Fri, 15 Nov 2013 00:39:13 GMT
Received: from hubby.local (/50.150.115.211)
	by default (Oracle Beehive Gateway v4.0)
	with ESMTP ; Thu, 14 Nov 2013 16:39:12 -0800
Message-ID: <52856D2F.50304@oracle.com>
Date: Thu, 14 Nov 2013 16:39:11 -0800
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.8; rv:24.0) Gecko/20100101 Thunderbird/24.1.0
MIME-Version: 1.0
To: Yasuo Ohgaki <yohgaki@ohgaki.net>,
        "internals@lists.php.net" <internals@lists.php.net>
References: <60B9BBE0-BC3F-490A-AD78-9EBC22C808CF@googlemail.com> <CAGa2bXZ1XVf0HZ4oQ8r0gsaw6UmxuQfEquVMcTZjk5wfPwqcGQ@mail.gmail.com> <5279F08B.1050803@gmail.com> <CAGa2bXZ4H1grkR3HpH_rEgtGgsQ3boeuy24mSShDF365eO+D7g@mail.gmail.com> <527AC5F2.5090401@gmail.com> <CAGa2bXZaP04jb1Qq+8Qnjv+=0giEZADsfGrmvDrZyt5bc7wxoA@mail.gmail.com> <CAGa2bXaqTC_XPEeC_NwQp4C4UFbwDWVgtjB7G1PbMzO_S2r3=g@mail.gmail.com> <1384253404.3572.23.camel@guybrush> <CAJRMtAFyTr6RTa91Awte=UTEpaLqpP9Q_WWGPbTcM53dJssTvQ@mail.gmail.com> <CAGa2bXbbQDz_tc=_wijhwcTmY1Z0QdL7gTEvZAj5dLPPO2UT3A@mail.gmail.com> <CAGa2bXY7rkKLFu6mkqcVR8pEOAdfz=JVty67k-EdUM8fu3HTFg@mail.gmail.com>
In-Reply-To: <CAGa2bXY7rkKLFu6mkqcVR8pEOAdfz=JVty67k-EdUM8fu3HTFg@mail.gmail.com>
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 8bit
X-Source-IP: ucsinet21.oracle.com [156.151.31.93]
Subject: Re: [PHP-DEV] CLI Web Server customization
From: christopher.jones@oracle.com (Christopher Jones)



On 11/14/13 2:37 PM, Yasuo Ohgaki wrote:

> Correction. It does block script, but not request.
> Any correction, improvement is appreciated.
>
> Index: commandline.xml
> ===================================================================
> --- commandline.xml (êÓ¸çó 332115)
> +++ commandline.xml (\m³Ôü)
> @@ -1606,12 +1606,14 @@
>     </para>
>
>     <para>
> -   This web server is designed for developmental purposes only, and should
> not
> -   be used in production.
> +    Multiple requests are handled concurrently, but PHP scripts are
> +    served sequentially. It blocks PHP scripts if a scripts stalled.
>     </para>

I don't think the distinction is useful for the end user.  At face
value readers might see it as contradictory: "is it concurrent or
sequential?".  Or the description needs clarification to explain the
subtleties.

Also, consider this grammar/wording correction for the last sentence:
"PHP applications will stall if a request is blocked"

>
>     <para>
> -    Requests are served sequentially.
> +   This web server is designed for developmental purposes mainly, and
> +   it is not aimed to be a full featured web server. Use of built-in
> +   web server under public internet is discouraged.
>     </para>

Perhaps say:

   This web server was designed to aid application development.  It may
   also be useful for testing purposes or for application
   demonstrations that are run in controlled environments.  It is not
   intended to be a full-featured web server.  It should not be used on
   a public network.

Chris

-- 
christopher.jones@oracle.com  http://twitter.com/ghrd
Free PHP & Oracle book:
http://www.oracle.com/technetwork/topics/php/underground-php-oracle-manual-098250.html