#17784 [Opn->Csd]: fopen() 4th parameter not document

ID: 17784 Updated by: iliaa@php.net Reported By: mfischer@php.net -Status: Open +Status: Closed Bug Type: Documentation problem PHP Version: 4.0CVS-2002-06-16 New Comment: Thank you for your bug report. This issue has already been fixed in the latest released version of PHP, which you can download at http://www.php.net/downloads.php Previous Comments: ------------------------------------------------------------------------ [2002-07-26 14:11:11] wez@php.net 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. ------------------------------------------------------------------------ [2002-07-17 04:56:51] cynic@php.net whoa, kudos for the footwork, philip! :) ------------------------------------------------------------------------ [2002-07-16 18:07:57] philip@php.net 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] philip@php.net Still open, I'll document it. ------------------------------------------------------------------------ [2002-07-14 08:20:43] wez@php.net 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. ------------------------------------------------------------------------ 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