Re: [PHP-DOC] streams reference
>--Cross-Post from php-doc discussion thread-- > > You may want to mention what the following means, this is > from a phpinfo() on www.php.net: > > Registered PHP Streams: http > php > ftp > https > compress.zlib > I mention using phpinfo() to see what wrappers are available, but not detail on all the builtin streams. I've got references (w/ links) to Apendix I for that. > Is there a function to get this specific information? Would > that be useful? Maybe something like get_registered_streams(). > That does sound like it'd be useful... Unfortunately there isn't a userland function for that. There *IS* however, a PHPAPI call for it: PHPAPI HashTable *php_stream_get_url_stream_wrappers_hash(); It wouldn't take much to make a userland wrapper for it since it already returns a hash table... stream_get_wrappers(); sounds like an appropriate name > When are certain streams not available, like, I assume > allow_url_fopen dictates the availability of the http stream? > FTP module for ftp, etc. > This is all documented in Apendix I (which is linked a couple times from ref.stream), do you think we need to go into it in detail on ref.stream as well? -Pollita Cross posting to php-dev re: addition of stream_get_wrappers() addition. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] strspn and strcspn
On Thu, 2 Jan 2003, Andrey Hristov wrote: > Hi all, > maybe little offtopic but strspn() and strcspn() can get additional 2 > parameters (starting 4.3.0) > I have sent modified xmls to php-doc but was asked for a diff (unified). > Unfortunately I cannot provide it. > I have also asked for php-doc karma but not received. > > Philip, may I send the xmls to you? Please just write in this email what these new parameters are named and what they do, it will then be implemented. Looking at a unified diff should/is a requirement before any commit, as is make test. ;) Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
You may want to mention what the following means, this is from a phpinfo() on www.php.net: Registered PHP Streams: http php ftp https compress.zlib Is there a function to get this specific information? Would that be useful? Maybe something like get_registered_streams(). When are certain streams not available, like, I assume allow_url_fopen dictates the availability of the http stream? FTP module for ftp, etc. Anyway, something else to consider in case you haven't yet :) Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/stream reference.xml
pollita Thu Jan 2 21:54:21 2003 EDT Modified files: /phpdoc/en/reference/stream reference.xml Log: typo / local revision mismatch ... all fixed... Index: phpdoc/en/reference/stream/reference.xml diff -u phpdoc/en/reference/stream/reference.xml:1.1 phpdoc/en/reference/stream/reference.xml:1.2 --- phpdoc/en/reference/stream/reference.xml:1.1Thu Jan 2 21:41:14 2003 +++ phpdoc/en/reference/stream/reference.xmlThu Jan 2 21:54:21 2003 @@ -1,5 +1,5 @@ - + Stream functions Streams @@ -92,7 +92,7 @@ - + &reftitle.examples; @@ -173,9 +173,6 @@ - -For PHP Streams Development, See Also: - &reference.stream.functions; -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/stream reference.xml /en/reference/stream/functions stream-get-meta-data.xml stream-register-wrapper.xml stream-set-blocking.xml stream-set-timeout.xml stream-set-write-buffer.xml
pollita Thu Jan 2 21:41:14 2003 EDT Added files: /phpdoc/en/reference/stream reference.xml /phpdoc/en/reference/stream/functions stream-set-write-buffer.xml stream-set-timeout.xml stream-set-blocking.xml stream-register-wrapper.xml stream-get-meta-data.xml Log: Finish moving streams documentation to its own section... Index: phpdoc/en/reference/stream/reference.xml +++ phpdoc/en/reference/stream/reference.xml Stream functions Streams &reftitle.intro; Streams were introduced with PHP 4.3.0 as a way of generalizing file, network, data compression, and other opperations which share a common set of functions and uses. In its simplest definition, a stream is any I/O conduit for exchanging information. Some streams work on the local filesystem, some use network connections (sockets), while others might potentially focus on communication devices such as printers or modems. Because any variety of stream may be added to PHP via the stream_register_wrapper function, there is no set limit on what can be done with them. See for a listing of stream wrappers built into PHP. A stream is referenced as: scheme://target scheme(string) - The name of the stream wrapper to be used. Examples include: file, http, https, ftp, ftps, compress.zlib, compress.bz2, ssl, tls, and php. See for a list of PHP builtin wrappers. target - Depends on the wrapper used. For filesystem related streams this is typically a path and filename of the desired file. For network related streams this is typically a hostname often with a path appended. Again, see for a description of targets for builtin streams. Filters may also be applied to streams to further process data on its way into or out of a stream related call. Documentation on this functionality is comming soon. &reftitle.required; &no.requirement; &reftitle.install; Streams are an integral part of PHP as of version 4.3.0. No steps are required to enable them. &reftitle.runtime; &no.config; &reftitle.resources; &no.resource; &reftitle.constants; &no.constants; Stream Errors As with any file or socket related function, an opperation on a stream may fail for a variety of normal reasons (i.e.: Unable to connect to remote host, file not found, etc...). A stream related call may also fail because the desired stream is not registered on the running system. See the output of php_info for a list of streams supported by your installation of PHP. As with most PHP internal functions if a failure occours an E_WARNING message will be generated describing the nature of the error. &reftitle.examples; Using file_get_contents() to retrieve data from multiple sources Writting data to a compressed file For PHP Streams Development, See Also: &reference.stream.functions; Index: phpdoc/en/reference/stream/functions/stream-set-write-buffer.xml +++ phpdoc/en/reference/stream/functions/stream-set-write-buffer.xml stream_set_write_buffer Sets file buffering on the given stream Description intstream_set_write_buffer resourcestream intbuffer Output using fwrite is normally buffered at 8K. This means that if there are two processes wanting to write to the same output stream (a file), each is paused after 8K of data to allow the other to write. stream_set_write_buffer sets the buffering for write operations on the given filepointer stream to buffer bytes. If buffer is 0 then write operations are unbuffered. This ensures that all writes with fwrite are completed before other processes are allowed to write to that output stream. The function returns 0 on success, or EOF if the request cannot be honored. The following example demonstrates how to use stream_set_write_buffer to create an unbuffered stream. stream_set_write_buffer example See also fopen and fwrite. Index: phpdoc/en/reference/stream/functions/stream-set-timeout.xml +++ phpdoc/en/reference/stream/functions/stream-set-timeout.xml stream_set_timeout Set timeout period on a stream Descr
[PHP-DOC] cvs: phpdoc / manual.xml.in /en/reference/filesystem/functions stream-get-meta-data.xml stream-register-wrapper.xml stream-set-blocking.xml stream-set-timeout.xml stream-set-write-buffer.xml
pollita Thu Jan 2 21:37:57 2003 EDT Removed files: /phpdoc/en/reference/filesystem/functions stream-get-meta-data.xml stream-register-wrapper.xml stream-set-blocking.xml stream-set-timeout.xml stream-set-write-buffer.xml Modified files: /phpdoc manual.xml.in Log: Moved current streams documentation to its own reference section. Added reference manual page for streams. Index: phpdoc/manual.xml.in diff -u phpdoc/manual.xml.in:1.139 phpdoc/manual.xml.in:1.140 --- phpdoc/manual.xml.in:1.139 Tue Nov 26 14:52:48 2002 +++ phpdoc/manual.xml.inThu Jan 2 21:37:56 2003 @@ -186,6 +186,7 @@ &reference.swf.reference; &reference.snmp.reference; &reference.sockets.reference; + &reference.stream.reference; &reference.strings.reference; &reference.sybase.reference; &reference.tokenizer.reference; -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/chapters config.xml
nicos Thu Jan 2 21:26:43 2003 EDT Modified files: /phpdoc/en/chapters config.xml Log: fixing tabs Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.88 phpdoc/en/chapters/config.xml:1.89 --- phpdoc/en/chapters/config.xml:1.88 Thu Jan 2 21:20:44 2003 +++ phpdoc/en/chapters/config.xml Thu Jan 2 21:26:43 2003 @@ -1,5 +1,5 @@ - + Configuration @@ -476,7 +476,7 @@ use this directive you must have enabled it at compile time. So, your configure line would have included: --enable-memory-limit. Note that you have to set - it to -1 if you don't want any limit for your memory. +it to -1 if you don't want any limit for your memory. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/chapters config.xml
nicos Thu Jan 2 21:20:44 2003 EDT Modified files: /phpdoc/en/chapters config.xml Log: adding comment about memory_limit (bug fixe #20247 Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.87 phpdoc/en/chapters/config.xml:1.88 --- phpdoc/en/chapters/config.xml:1.87 Sat Nov 30 06:08:05 2002 +++ phpdoc/en/chapters/config.xml Thu Jan 2 21:20:44 2003 @@ -1,5 +1,5 @@ - + Configuration @@ -475,7 +475,8 @@ scripts for eating up all available memory on a server. In order to use this directive you must have enabled it at compile time. So, your configure line would have included: ---enable-memory-limit +--enable-memory-limit. Note that you have to set + it to -1 if you don't want any limit for your memory. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] #18293 - mkdir()
Hello, The user wants to add to http://www.php.net/manual/en/function.mkdir.php some informations about the second argument of mkdir() which is unix mode. Where should we point him? It would be nice if someone adds a link or a nice description in the documentation. Thank you for your comments. -- Regards. M.CHAILLAN Nicolas [EMAIL PROTECTED] www.WorldAKT.com Hébergement de sites internets. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
> Please make that dir stream not streams as to make > the shortcuts nicer for api vs function reference. > Half a step ahead of ya... ./en/reference/stream/reference.xml ./en/reference/stream/functions/stream-get-meta-data.xml ./en/reference/stream/functions/stream-register-wrapper.xml ./en/reference/stream/functions/stream-set-blocking.xml ./en/reference/stream/functions/stream-set-timeout.xml ./en/reference/stream/functions/stream-set-write-buffer.xml My documentation of filters is going to be limited to start with, for the moment I want to get *something* in place. I'll be fleshing out the reference.xml page with filter documentation and adding the other stream_* functions tomorrow and over the weekend. I'll also have the x-links between the API and the userland pages in place by tonight. -Pollita (forgot to run ./configure last time now to start that build again) -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
> Yup, as I mentioned pollita on #php, a new dir > "en/reference/streams" would be the best way to go. > > +1 for that addition. Please make that dir stream not streams as to make the shortcuts nicer for api vs function reference. Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
> A major benefit of this new section will be having its > own large introduction. This is much needed as it needs > to be wordy, and include examples and comparisons of a > few other "alternative/older" methods. > > I do not volunteer doing this as I don't understand the > topic of streams yet but I do look forward to these docs, > please put them in laymens terms ;) > I've got a draft of stream/reference.xml already and am just doing the make now to take a look at it in a browser. Once I have something that works I'll commit the changes to create the stream section in the reference, move the existing function definitions over, and add the reference.xml page itself. Once that's all in place, we can improve on the wording in reference.xml and add the additional documentation pages in stream/functions. -Pollita -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
--- Derick Rethans <[EMAIL PROTECTED]> wrote: > On Thu, 2 Jan 2003, Gabor Hojtsy wrote: > > > > Actually, turns out: > > > stream_get_meta_data > > > stream_register_wrapper > > > stream_set_blocking > > > stream_set_timeout > > > stream_set_write_buffer > > > > > > ARE in the manual under the filesystem section. > Should the missing > > > functions be added in there? Or still go ahead > with creating a new streams > > > section and move these guys over? > > > > IMHO, it should be a new streams section. Streams > are used by many > > other things, not just file functions (eg. > include/require). > > I would favor that too. Yup, as I mentioned pollita on #php, a new dir "en/reference/streams" would be the best way to go. +1 for that addition. = --- Jesus M. Castagnetto <[EMAIL PROTECTED]> __ Do you Yahoo!? Yahoo! Mail Plus - Powerful. Affordable. Sign up now. http://mailplus.yahoo.com -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
On Thu, 2 Jan 2003, Derick Rethans wrote: > On Thu, 2 Jan 2003, Gabor Hojtsy wrote: > > > > Actually, turns out: > > > stream_get_meta_data > > > stream_register_wrapper > > > stream_set_blocking > > > stream_set_timeout > > > stream_set_write_buffer > > > > > > ARE in the manual under the filesystem section. Should the missing > > > functions be added in there? Or still go ahead with creating a new streams > > > section and move these guys over? > > > > IMHO, it should be a new streams section. Streams are used by many > > other things, not just file functions (eg. include/require). > > I would favor that too. A major benefit of this new section will be having its own large introduction. This is much needed as it needs to be wordy, and include examples and comparisons of a few other "alternative/older" methods. I do not volunteer doing this as I don't understand the topic of streams yet but I do look forward to these docs, please put them in laymens terms ;) Regards, Philip -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
IMHO, since streams have become such an integral part of PHP, it would be best to create a full new section about them, and make links from all other files to the new section... - Tularis Sara Golemon wrote: Sounds appropriate to me. Looks like only streams information exists for dev/api people currently: http://www.php.net/streams So in the end we will have php.net/streams going to the API docs and php.net/stream going to the function reference (ref.stream). Be sure to link each to one another! :) Actually, turns out: stream_get_meta_data stream_register_wrapper stream_set_blocking stream_set_timeout stream_set_write_buffer ARE in the manual under the filesystem section. Should the missing functions be added in there? Or still go ahead with creating a new streams section and move these guys over? -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
On Thu, 2 Jan 2003, Gabor Hojtsy wrote: > > Actually, turns out: > > stream_get_meta_data > > stream_register_wrapper > > stream_set_blocking > > stream_set_timeout > > stream_set_write_buffer > > > > ARE in the manual under the filesystem section. Should the missing > > functions be added in there? Or still go ahead with creating a new streams > > section and move these guys over? > > IMHO, it should be a new streams section. Streams are used by many > other things, not just file functions (eg. include/require). I would favor that too. Derick -- - Derick Rethans http://derickrethans.nl/ PHP Magazine - PHP Magazine for Professionals http://php-mag.net/ - -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
> Actually, turns out: > stream_get_meta_data > stream_register_wrapper > stream_set_blocking > stream_set_timeout > stream_set_write_buffer > > ARE in the manual under the filesystem section. Should the missing > functions be added in there? Or still go ahead with creating a new streams > section and move these guys over? IMHO, it should be a new streams section. Streams are used by many other things, not just file functions (eg. include/require). Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
> > Sounds appropriate to me. Looks like only streams > information exists for dev/api people currently: > > http://www.php.net/streams > > So in the end we will have php.net/streams going to > the API docs and php.net/stream going to the > function reference (ref.stream). Be sure to link > each to one another! :) > Actually, turns out: stream_get_meta_data stream_register_wrapper stream_set_blocking stream_set_timeout stream_set_write_buffer ARE in the manual under the filesystem section. Should the missing functions be added in there? Or still go ahead with creating a new streams section and move these guys over? -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
Hi all, maybe little offtopic but strspn() and strcspn() can get additional 2 parameters (starting 4.3.0) I have sent modified xmls to php-doc but was asked for a diff (unified). Unfortunately I cannot provide it. I have also asked for php-doc karma but not received. Philip, may I send the xmls to you? Andrey - Original Message - From: "Philip Olson" <[EMAIL PROTECTED]> To: "Sara Golemon" <[EMAIL PROTECTED]> Cc: <[EMAIL PROTECTED]> Sent: Thursday, January 02, 2003 9:26 PM Subject: Re: [PHP-DOC] streams reference > > Sounds appropriate to me. Looks like only streams > information exists for dev/api people currently: > > http://www.php.net/streams > > So in the end we will have php.net/streams going to > the API docs and php.net/stream going to the > function reference (ref.stream). Be sure to link > each to one another! :) > > There are many undocumented functions to document: > > http://zend.com/phpfunc/nodoku.php > > That phpfunc hasn't updated since 4.3.0 but anyway > we have some work to do it seems. :) > > Regards, > Philip > -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] streams reference
Sounds appropriate to me. Looks like only streams information exists for dev/api people currently: http://www.php.net/streams So in the end we will have php.net/streams going to the API docs and php.net/stream going to the function reference (ref.stream). Be sure to link each to one another! :) There are many undocumented functions to document: http://zend.com/phpfunc/nodoku.php That phpfunc hasn't updated since 4.3.0 but anyway we have some work to do it seems. :) Regards, Philip On Thu, 2 Jan 2003, Sara Golemon wrote: > ((A questing in OPN/#php brought up the following issue)) > > So we've got all these streams in php now, but (for all I can tell) no > Streams section in the manual reference. Is anyone working on documenting > these already? Most functions seem to be ported versions of already > existing functions (socket_*, f*, etc...). I'd be happy to start work on > making manual pages for these functions, but I don't want to go all > willy-nilly creating whole new sections in the manual without checking > first. > > A quick rgrep shows the following stream_* functions: > > stream_get_meta_data > stream_select > stream_context_get_options > stream_context_set_option > stream_context_set_params > stream_context_create > stream_filter_prepend > stream_filter_append > stream_set_blocking > stream_set_timeout > stream_set_write_buffer > stream_register_wrapper > stream_register_filter > > -Pollita > > > > > -- > PHP Documentation Mailing List (http://www.php.net/) > To unsubscribe, visit: http://www.php.net/unsub.php > -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/chapters install.apache2.xml
pollita Thu Jan 2 13:55:26 2003 EDT Modified files: /phpdoc/en/chapters install.apache2.xml Log: Broken entity reference Index: phpdoc/en/chapters/install.apache2.xml diff -u phpdoc/en/chapters/install.apache2.xml:1.6 phpdoc/en/chapters/install.apache2.xml:1.7 --- phpdoc/en/chapters/install.apache2.xml:1.6 Wed Jan 1 14:12:43 2003 +++ phpdoc/en/chapters/install.apache2.xml Thu Jan 2 13:55:26 2003 @@ -1,5 +1,5 @@ - + Servers-Apache 2.0 @@ -29,7 +29,7 @@ PHP 4.3.0 or later available at -&url.php.downloads. +&url.php.downloads;. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/network/functions checkdnsrr.xml dns-get-record.xml getmxrr.xml /entities global.ent
pollita Thu Jan 2 13:42:53 2003 EDT Modified files: /phpdoc/entitiesglobal.ent /phpdoc/en/reference/network/functions dns-get-record.xml getmxrr.xml checkdnsrr.xml Log: Added reference to PEAR Net_DNS class for windows support of equivalent functionality (not otherwise available due to lack of support in windows resolver library) Index: phpdoc/entities/global.ent diff -u phpdoc/entities/global.ent:1.71 phpdoc/entities/global.ent:1.72 --- phpdoc/entities/global.ent:1.71 Tue Dec 31 15:54:11 2002 +++ phpdoc/entities/global.ent Thu Jan 2 13:42:52 2003 @@ -1,6 +1,6 @@ + dns_get_record @@ -19,7 +19,9 @@ -This function is not implemented on Windows platforms. +This function is not implemented on Windows platforms. Try the +PEAR class +Net_DNS. Index: phpdoc/en/reference/network/functions/getmxrr.xml diff -u phpdoc/en/reference/network/functions/getmxrr.xml:1.3 phpdoc/en/reference/network/functions/getmxrr.xml:1.4 --- phpdoc/en/reference/network/functions/getmxrr.xml:1.3 Mon Jul 29 04:44:40 2002 +++ phpdoc/en/reference/network/functions/getmxrr.xml Thu Jan 2 13:42:52 2003 @@ -1,5 +1,5 @@ - + @@ -28,7 +28,15 @@ weight array is given, it will be filled with the weight information gathered. -¬e.no-windows; + + + + This function is not implemented on Windows platforms. Try the + PEAR class + Net_DNS. + + + See also checkdnsrr, gethostbyname, Index: phpdoc/en/reference/network/functions/checkdnsrr.xml diff -u phpdoc/en/reference/network/functions/checkdnsrr.xml:1.3 phpdoc/en/reference/network/functions/checkdnsrr.xml:1.4 --- phpdoc/en/reference/network/functions/checkdnsrr.xml:1.3Sun Dec 8 03:51:55 2002 +++ phpdoc/en/reference/network/functions/checkdnsrr.xmlThu Jan 2 13:42:52 +2003 @@ -1,5 +1,5 @@ - + @@ -37,7 +37,15 @@ -¬e.no-windows; + + + + This function is not implemented on Windows platforms. Try the + PEAR class + Net_DNS. + + + See also getmxrr, gethostbyaddr, -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] dns_*() vs. PEAR::Net_DNS
On Thu, 2 Jan 2003, Sara Golemon wrote: > Anyway, my question is... Would it be appropriate to ammend the notes > which currently show on those manual pages: > > Note: This function is not implemented on Windows platforms. > > with a mention of the PEAR alternative?: > > Note: This function is not implemented on Windows platforms. Try the pear > class Net_DNS. > > Possibly with a link to the package ( > http://pear.php.net/package-info.php?pacid=59 ) That sounds like a good idea to me. > > The thing is I don't see a lot of endorsement of PEAR classes on the > PHP.net site in general and I've NEVER seen mention of PEAR packages in > the manual at all. They have their own manual: http://pear.php.net/manual/en/ Derick -- - Derick Rethans http://derickrethans.nl/ PHP Magazine - PHP Magazine for Professionals http://php-mag.net/ - -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] dns_*() vs. PEAR::Net_DNS
> Anyway, my question is... Would it be appropriate to ammend the notes > which currently show on those manual pages: > > Note: This function is not implemented on Windows platforms. > > with a mention of the PEAR alternative?: > > Note: This function is not implemented on Windows platforms. Try the pear > class Net_DNS. > > Possibly with a link to the package ( > http://pear.php.net/package-info.php?pacid=59 ) > > The thing is I don't see a lot of endorsement of PEAR classes on the > PHP.net site in general and I've NEVER seen mention of PEAR packages in > the manual at all. Well, as far as I see, it's perfectly OK, to mention a PEAR class, and add a link. It is sort of an "official PHP product". PEAR is meant to complement the PHP core and extensions with advanced (~higher level) functionality. Goba -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] dns_*() vs. PEAR::Net_DNS
I've fielded a number of complaints about the lack of Win32 support for dns_get_record/dns_get_mx/get_check_record and sadly I have to tell them that the limitation is not in PHP but in Windows (lack of proper libresolv). After reading up on the RFCs and writting a non-libresolv based extension ( http://169.229.139.97/ if anyone cares to look ) version of these functions I discovered that there's already a perfectly good (much better in fact -- handles all RFC DNS types and classes) PEAR class which will do exactly the same thing and doesn't require adding bloat to PHP. Anyway, my question is... Would it be appropriate to ammend the notes which currently show on those manual pages: Note: This function is not implemented on Windows platforms. with a mention of the PEAR alternative?: Note: This function is not implemented on Windows platforms. Try the pear class Net_DNS. Possibly with a link to the package ( http://pear.php.net/package-info.php?pacid=59 ) The thing is I don't see a lot of endorsement of PEAR classes on the PHP.net site in general and I've NEVER seen mention of PEAR packages in the manual at all. -Pollita -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] streams reference
((A questing in OPN/#php brought up the following issue)) So we've got all these streams in php now, but (for all I can tell) no Streams section in the manual reference. Is anyone working on documenting these already? Most functions seem to be ported versions of already existing functions (socket_*, f*, etc...). I'd be happy to start work on making manual pages for these functions, but I don't want to go all willy-nilly creating whole new sections in the manual without checking first. A quick rgrep shows the following stream_* functions: stream_get_meta_data stream_select stream_context_get_options stream_context_set_option stream_context_set_params stream_context_create stream_filter_prepend stream_filter_append stream_set_blocking stream_set_timeout stream_set_write_buffer stream_register_wrapper stream_register_filter -Pollita -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
