php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
Doc Bug #52714 Intro to HTTP subsystem unclear
Submitted: 2010-08-27 06:30 UTC Modified: 2010-10-23 15:52 UTC
From: unsure at tactileint dot com Assigned: kalle (profile)
Status: Closed Package: Documentation problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
 [2010-08-27 06:30 UTC] unsure at tactileint dot com
Description:
------------
http://php.he.net/manual/en/intro.http.php: the intro to the "HTTP" package is 
unclear; specifically, there's HTTP that called the PHP script in the first 
place (incoming), then there's HTTP requests that the script can in turn do 
before the script returns (outgoing).  Does it concern both?  or just outgoing?

"powerful set of functionality for one of PHPs major applications" - that says 
to me, the incoming HTTP that called the script to build a web page.  That's the 
major application of PHP.  But, I think the package does very little for that, 
right?

"It eases handling of HTTP URLs, dates, redirects, headers and messages," = both 
incoming and outgoing.

" provides means for negotiation of clients preferred language and charset" = 
incoming

"a convenient way to send any arbitrary data with caching and resuming 
capabilities." => 'send' - do you mean, send as a reply to the incoming request, 
or send as the data for an outgoing request?

"It provides powerful request functionality, if built with CURL support." = 
outgoing.

OK, so if I rolled up my sleeves and read some of it i'd get my answer, but the 
Intro is supposed to answer big questions like that.  And this intro leaves me 
confused.  

Thanks, I know docs are hard work, I do a lot of it myself.  


Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2010-10-23 15:52 UTC] kalle@php.net
Automatic comment from SVN on behalf of kalle
Revision: http://svn.php.net/viewvc/?view=revision&revision=304659
Log: Fixed bug #52714 (Intro to HTTP subsystem unclear)
 [2010-10-23 15:52 UTC] kalle@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: kalle
 [2010-10-23 15:52 UTC] kalle@php.net
I rewrote parts of the book intro to make it more clear in some places, I even questioned myself on a few of the parts, hope this will make it more clear.
 [2020-02-07 06:08 UTC] phpdocbot@php.net
Automatic comment on behalf of kalle
Revision: http://git.php.net/?p=doc/en.git;a=commit;h=4b0c7d120a7612d97dc2a33bd3a1db50df43d49b
Log: Fixed bug #52714 (Intro to HTTP subsystem unclear)
 
PHP Copyright © 2001-2026 The PHP Group
All rights reserved.
Last updated: Wed Oct 07 23:00:01 2026 UTC