ID: 17784
Updated by: [EMAIL PROTECTED]
Reported By: [EMAIL PROTECTED]
Status: Open
Bug Type: Documentation problem
PHP Version: 4.0CVS-2002-06-16
New Comment:
I still don't have time to properly document this, but I'm
pasting part of my email conversation with Philip here,
just in case someone else does get the time before I do.
Thanks very much to Philip for the effort in researching
this stuff!
Wez said:
> The concept is this:
> Sometimes it is useful to specify some more advanced tuning
paramters
> for a file (or stream) before it is opened. In the case of HTTP,
> it is also useful to be able to share context settings - the main
> thing here is to store cookies from one request and then use them
> for subsequent fopen("http://...";) requests.
>
> This concept was expanded to allow callbacks to monitor progress:
> you should be able to find more details on this on the marc archives
-
> search for something like "stream progress notification"; this was
> implemented in response to someone requesting the feature for FTP,
> so adding FTP in there might help narrow the search.
>
> The context functions were (re)named as follows:
>
> stream_context_create()
> stream_context_get_options()
> stream_context_set_option()
> stream_context_set_params()
>
> Context parameters have the following structure, much like an
> array, so I'll display it like an array:
>
> context => array(
> notification => callback for notification function
> options => array(
> http => array(optionname => optionvalue) // for http
> ftp => ftp wrapper options
> ... => other wrapper options
> )
> )
>
> ATM, only the notification parameter has been set and no options
> for the other wrappers have been finalized, so it only makes sense
> to document that part of it right now.
And Philip said:
Feel free to add the information below to the bug
report, I unassigned myself, and wrote all the
information I knew into it. See:
http://bugs.php.net/bug.php?id=17784
Btw, that thread you speak of (stream progress
notification" is here:
RFC: stream notification handlers
http://marc.theaimsgroup.com/?l=php-dev&m=101826854819192
Somehow I missed it. Hopefully if you mention the
stuff below in that report someone will document it.
Sorry I can't :( Btw, this is some cool stuff! I'm
slowly understanding it.
Previous Comments:
------------------------------------------------------------------------
[2002-07-17 04:56:51] [EMAIL PROTECTED]
whoa, kudos for the footwork, philip! :)
------------------------------------------------------------------------
[2002-07-16 18:07:57] [EMAIL PROTECTED]
This has been briefly documented, I lack the knowledge to take it
further. Here's some related information:
Re: [PHP-DEV] streams and options
http://marc.theaimsgroup.com/?l=php-dev&m=101922976301407
Also, in NEWS:
PHP now has a new stream system that allows it to
do some clever stuff with fopen() and fsockopen().
As a result:
. URL wrappers natively supports https:// URLs
. fsockopen() adds support for ssl:// and tls://
connections via TCP/IP
. copy($srcfilename, $destfilename) can now be used with
URL wrappers
. zlib wrappers/streams can be used even on systems
without fopencookie()
. Added 'compress.bzip2://' stream and wrapper support.
. Added user-space streams - it is now possible to define
a class in PHP code and register it as a URL wrapper.
. Most extensions now support streams when passing files,
which means that those extensions will support URL
wrappers. (Wez)
More related php-dev threads:
Stream Filters and Interfaces (a bit long)
http://marc.theaimsgroup.com/?l=php-dev&m=101924701219677
URLs, fopen wrappers and RFC 2718
http://marc.theaimsgroup.com/?l=php-dev&m=101915071800583
Am unassigning from self, remains open.
------------------------------------------------------------------------
[2002-07-14 13:50:37] [EMAIL PROTECTED]
Still open, I'll document it.
------------------------------------------------------------------------
[2002-07-14 08:20:43] [EMAIL PROTECTED]
Just a quick note, because the docs haven't shown up on
the site yet, and I don't have time to resync my phpdoc
tree - the zcontext is for specifying tuning parameters
and callbacks. I did post an example to php-dev a while
back.
I will properly document this stuff when my workload
decreases to something just below fever pitch.
------------------------------------------------------------------------
[2002-07-01 17:34:37] [EMAIL PROTECTED]
This bug has been fixed in CVS. You can grab a snapshot of the
CVS version at http://snaps.php.net/. In case this was a documentation
problem, the fix will show up soon at http://www.php.net/manual/.
In case this was a PHP.net website problem, the change will show
up on the PHP.net site and on the mirror sites.
Thank you for the report, and for helping us make PHP better.
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/17784
--
Edit this bug report at http://bugs.php.net/?id=17784&edit=1
--
PHP Documentation Mailing List (http://www.php.net/)
To unsubscribe, visit: http://www.php.net/unsub.php
