[PHP-DOC] Re: [PHP-DEV] Interesting result
I was talking about telling the 'undefined behaviour' case; not what happens with the values exactly. I don't see a drawback in documenting an 'undefined behaviour'. It's good for people to have a torough documentation which even warns them before they're doing silly things. Note that the majority of users of PHP are non-programmers. Warning them before they shoot themselves a good thing [tm]. On Mon, Dec 23, 2002 at 08:53:41AM -0800, David Gillies wrote : > --- Markus Fischer <[EMAIL PROTECTED]> wrote: > > So shouldn't we document those special case on > > the operators > > page ? > > > > No. Any developer worth his salt knows not to do silly > things like this. It's not a 'special case'. It's just > undefined behaviour. If your code uses syntax like > this it is broken. > > As for 'why', in the implementation sense, this > happens, I would imagine that the reference, by > increasing the refcount of the variable, moves > evaluation of the postincrement operator to a > different sequence point. Just don't do it. Modifying > the value of a variable twice between sequence points > yields UNDEFINED BEHAVIOUR. That mean anything at all > can happen, up to and including your hard drive being > reformatted and rude emails being sent to your boss. > > You do NOT neeed to know the details. As K&R points > out: "if you don't know *how* [assorted weird tricks] > are done on various machines, that innocence may help > to protect you." > > Best Wishes > > David Gillies > San Jose > Costa Rica > > > > On Sun, Dec 22, 2002 at 10:26:08AM +0200, Andrey > > Hristov wrote : > > > oukei, stopping to ask anymore :)) > > > > > > Andrey > > > > > > > > > - Original Message - > > > From: "Andi Gutmans" <[EMAIL PROTECTED]> > > > To: "Andrey Hristov" <[EMAIL PROTECTED]>; > > <[EMAIL PROTECTED]> > > > Sent: Saturday, December 21, 2002 7:20 PM > > > Subject: Re: [PHP-DEV] Interesting result > > > > > > > > > > Again, as it is undefined in PHP the question > > "Why" in itself is wrong :) > > > > > > > > Andi > > > > > > > > At 04:43 PM 12/21/2002 +0200, Andrey Hristov > > wrote: > > > > > > > > >- Original Message - > > > > >From: "Andi Gutmans" <[EMAIL PROTECTED]> > > > > >To: "Andrey Hristov" <[EMAIL PROTECTED]>; > > <[EMAIL PROTECTED]> > > > > >Sent: Saturday, December 21, 2002 4:17 PM > > > > >Subject: Re: [PHP-DEV] Interesting result > > > > > > > > > > > > > > > > It doesn't matter because the behavior here > > is undefined just like in > > > C. > > > > > > You can't use a variable and it's post/pre > > increment value in the same > > > > > > expression. > > > > > > > > > > > > > > > >Two years ago I've been told by a professort > > that a+++a+++a depends on > > > the > > > > >language and the compiler. Yesterday i found > > this page : > > > > > > >http://www.blueshoes.org/en/developer/syntax_exam/ > > > > >If a=1 -> > > > > >Java : 6 > > > > >PHP : 6 > > > > >gcc 2.95 : 3 > > > > > > > > > >I know that is "on the edge" and I will never > > use it in real script by I > > > was > > > > >curious why the > > > > >reference change the result. > > > > > > > > > >Best wishes, > > > > >Andrey > > > > > > > > > > > > > > > > > At 03:26 PM 12/21/2002 +0200, Andrey Hristov > > wrote: > > > > > > > Hi, > > > > > > >i got an interesting case : > > > > > > > > > > > > > > > > > > > >$a = 1; > > > > > > >var_dump($a + $a++); > > > > > > > > > > > > > > > > > > > > >$a = 1; > > > > > > >$x = &$a; > > > > > > >var_dump($a + $a++); > > > > > > > > > > > > > >?> > > > > > > >Result > > > > > > >int(2) > > > > > > >int(3) > > > > > > > > > > > > > > > > > > > > -- > > > PHP Development Mailing List <http://www.php.net/> > > > To unsubscribe, visit: > > http://www.php.net/unsub.php > > > > -- > > PHP Development Mailing List <http://www.php.net/> > > To unsubscribe, visit: http://www.php.net/unsub.php > > > > > __ > 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
[PHP-DOC] cvs: phpdoc /en/reference/classobj/functions class-exists.xml get-declared-classes.xml
mfischerMon Oct 21 09:41:40 2002 EDT Modified files: /phpdoc/en/reference/classobj/functions class-exists.xml get-declared-classes.xml Log: - Add "See also" to class_exists/get_declared_classes . Index: phpdoc/en/reference/classobj/functions/class-exists.xml diff -u phpdoc/en/reference/classobj/functions/class-exists.xml:1.2 phpdoc/en/reference/classobj/functions/class-exists.xml:1.3 --- phpdoc/en/reference/classobj/functions/class-exists.xml:1.2 Wed Apr 17 02:36:42 2002 +++ phpdoc/en/reference/classobj/functions/class-exists.xml Mon Oct 21 09:41:39 +2002 @@ -1,5 +1,5 @@ - + @@ -17,6 +17,9 @@ class_name has been defined, &false; otherwise. + + See also get_declared_classes. + Index: phpdoc/en/reference/classobj/functions/get-declared-classes.xml diff -u phpdoc/en/reference/classobj/functions/get-declared-classes.xml:1.2 phpdoc/en/reference/classobj/functions/get-declared-classes.xml:1.3 --- phpdoc/en/reference/classobj/functions/get-declared-classes.xml:1.2 Wed Apr 17 02:36:42 2002 +++ phpdoc/en/reference/classobj/functions/get-declared-classes.xml Mon Oct 21 +09:41:39 2002 @@ -1,5 +1,5 @@ - + @@ -35,6 +35,9 @@ the appendices. + + See also class_exists. + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc ini.xml
mfischerThu Oct 17 10:23:15 2002 EDT Modified files: /phpdoc/en/reference/errorfunc ini.xml Log: - Give a more uhm real world err... example of docref_root. Index: phpdoc/en/reference/errorfunc/ini.xml diff -u phpdoc/en/reference/errorfunc/ini.xml:1.4 phpdoc/en/reference/errorfunc/ini.xml:1.5 --- phpdoc/en/reference/errorfunc/ini.xml:1.4 Wed Oct 9 05:50:24 2002 +++ phpdoc/en/reference/errorfunc/ini.xml Thu Oct 17 10:23:15 2002 @@ -1,5 +1,5 @@ - + &reftitle.runtime; &extension.runtime; @@ -295,13 +295,13 @@ to set docref_ext to match the fileextensions of your copy docref_ext=.html. It is possible to use external references. For example you can use - docref_root=http://manual/en/. + docref_root=http://manual/en/ or + +docref_root="http://landonize.it/?how=url&theme=classic&filter=Landon&url=http%3A%2F%2Fwww.php.net%2F"; + + + Most of the time you want the docref_root value to end with a slash '/'. + But see the second example above which does not have nor need it. - - - The value of docref_root must end with a slash '/'. - - -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/image/functions imagecolorat.xml
mfischerWed Oct 16 19:47:42 2002 EDT Modified files: /phpdoc/en/reference/image/functionsimagecolorat.xml Log: - Document the behaviour on TrueColor images. Index: phpdoc/en/reference/image/functions/imagecolorat.xml diff -u phpdoc/en/reference/image/functions/imagecolorat.xml:1.3 phpdoc/en/reference/image/functions/imagecolorat.xml:1.4 --- phpdoc/en/reference/image/functions/imagecolorat.xml:1.3Thu Apr 18 13:13:09 2002 +++ phpdoc/en/reference/image/functions/imagecolorat.xmlWed Oct 16 19:47:42 +2002 @@ -1,5 +1,5 @@ - + @@ -17,6 +17,26 @@ Returns the index of the color of the pixel at the specified location in the image specified by image. + + +If PHP is compiled against GD library 2.0 or higher and the image is a +truecolor image, this function returns the RGB value of that pixel as +integer. Use bitshifting and masking to access the distinct red, green and blue +component values: + + Access distinct RGB values + + + + See also imagecolorset and -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions set-error-handler.xml
mfischerThu Oct 10 09:48:14 2002 EDT Modified files: /phpdoc/en/reference/errorfunc/functionsset-error-handler.xml Log: - Mention since which version object callbacks are available. Closes #19843. Index: phpdoc/en/reference/errorfunc/functions/set-error-handler.xml diff -u phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.8 phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.9 --- phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.8 Thu Aug 22 08:36:22 2002 +++ phpdoc/en/reference/errorfunc/functions/set-error-handler.xml Thu Oct 10 +09:48:14 2002 @@ -1,5 +1,5 @@ - + @@ -31,7 +31,12 @@ error occurred (an array that points to the active symbol table at the point the error occurred). -¬e.func-callback; + + + Instead of a function name, an array containing an object reference and + a method name can also be supplied. (Since PHP 4.3.0) + + The following error types cannot be handled with a user defined -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/imap/functions imap-append.xml imap-body.xml imap-bodystruct.xml imap-check.xml imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-delete.xml imap-deletemailbox.xml imap-expunge.xml imap-fetch-overview.xml imap-fetchbody.xml imap-fetchheader.xml imap-fetchstructure.xml imap-get-quota.xml imap-get-quotaroot.xml imap-getmailboxes.xml imap-getsubscribed.xml imap-header.xml imap-headerinfo.xml imap-headers.xml imap-list.xml imap-listmailbox.xml imap-listscan.xml imap-listsubscribed.xml imap-lsub.xml imap-mail-copy.xml imap-mail-move.xml imap-mailboxmsginfo.xml imap-msgno.xml imap-num-msg.xml imap-num-recent.xml imap-open.xml imap-ping.xml imap-renamemailbox.xml imap-reopen.xml imap-scanmailbox.xml imap-search.xml imap-set-quota.xml imap-setacl.xml imap-setflag-full.xml imap-sort.xml imap-status.xml imap-subscribe.xml imap-thread.xml imap-uid.xml imap-undelete.xml imap-unsubscribe.xml
mfischerWed Oct 9 10:55:05 2002 EDT Added files: /phpdoc/en/reference/imap/functions imap-list.xml imap-listscan.xml imap-lsub.xml Modified files: /phpdoc/en/reference/imap/functions imap-append.xml imap-body.xml imap-bodystruct.xml imap-check.xml imap-clearflag-full.xml imap-close.xml imap-createmailbox.xml imap-delete.xml imap-deletemailbox.xml imap-expunge.xml imap-fetch-overview.xml imap-fetchbody.xml imap-fetchheader.xml imap-fetchstructure.xml imap-get-quota.xml imap-get-quotaroot.xml imap-getmailboxes.xml imap-getsubscribed.xml imap-header.xml imap-headerinfo.xml imap-headers.xml imap-listmailbox.xml imap-listsubscribed.xml imap-mail-copy.xml imap-mail-move.xml imap-mailboxmsginfo.xml imap-msgno.xml imap-num-msg.xml imap-num-recent.xml imap-open.xml imap-ping.xml imap-renamemailbox.xml imap-reopen.xml imap-scanmailbox.xml imap-search.xml imap-set-quota.xml imap-setacl.xml imap-setflag-full.xml imap-sort.xml imap-status.xml imap-subscribe.xml imap-thread.xml imap-uid.xml imap-undelete.xml imap-unsubscribe.xml Log: - Sync most protos with current source. - Move alised documented to their real function name and document what an alias is. Index: phpdoc/en/reference/imap/functions/imap-append.xml diff -u phpdoc/en/reference/imap/functions/imap-append.xml:1.2 phpdoc/en/reference/imap/functions/imap-append.xml:1.3 --- phpdoc/en/reference/imap/functions/imap-append.xml:1.2 Wed Apr 17 02:39:16 2002 +++ phpdoc/en/reference/imap/functions/imap-append.xml Wed Oct 9 10:55:05 2002 @@ -1,5 +1,5 @@ - + @@ -11,11 +11,11 @@ Description - intimap_append - intimap_stream + boolimap_append + +resourceimap_stream stringmbox stringmessage - stringflags + stringoptions Returns &true; on sucess, &false; on error. @@ -23,8 +23,8 @@ imap_append appends a string message to the specified mailbox mbox. If the optional - flags is specified, writes the - flags to that mailbox also. + options is specified, writes the + options to that mailbox also. When talking to the Cyrus IMAP server, you must use "\r\n" as Index: phpdoc/en/reference/imap/functions/imap-body.xml diff -u phpdoc/en/reference/imap/functions/imap-body.xml:1.2 phpdoc/en/reference/imap/functions/imap-body.xml:1.3 --- phpdoc/en/reference/imap/functions/imap-body.xml:1.2Wed Apr 17 02:39:16 2002 +++ phpdoc/en/reference/imap/functions/imap-body.xmlWed Oct 9 10:55:05 2002 @@ -1,5 +1,5 @@ - + @@ -10,9 +10,9 @@ Description stringimap_body - intimap_stream + +resourceimap_stream intmsg_number - intflags + intoptions imap_body returns the body of the message, Index: phpdoc/en/reference/imap/functions/imap-bodystruct.xml diff -u phpdoc/en/reference/imap/functions/imap-bodystruct.xml:1.2 phpdoc/en/reference/imap/functions/imap-bodystruct.xml:1.3 --- phpdoc/en/reference/imap/functions/imap-bodystruct.xml:1.2 Wed Apr 17 02:39:16 2002 +++ phpdoc/en/reference/imap/functions/imap-bodystruct.xml Wed Oct 9 10:55:05 +2002 @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ Description objectimap_bodystruct - intstream_id +
Re: [PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-executable.xml
On Mon, Oct 07, 2002 at 07:15:54PM +0200, Derick Rethans wrote : > On Mon, 7 Oct 2002, Markus Fischer wrote: > > > mfischerMon Oct 7 11:45:38 2002 EDT > > > > Modified files: > > /phpdoc/en/reference/filesystem/functions is-executable.xml > > Log: > > - Document latest scientific researches on PHP functions > > (thanks to Marc Boeren for finding this). > > Great, but that makes the test framework not working on Win, as it needs > this function. Jup I know ... I was just thinking, until this is sorted out whether we're doing something on Win32 or not, let's document the current behaviour (maybe in the meantime a commit has changed everything, but then we still should document that Win32 since version 4.x.y.z). thanks for heads up, - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc Derick, while ($xml) $ass->get_new_ideas(); <[James]> Markus: IE on_user_fart() -- People doesn't seem to like the new XHTML2 specs :) -- -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions is-executable.xml
mfischerMon Oct 7 11:45:38 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions is-executable.xml Log: - Document latest scientific researches on PHP functions (thanks to Marc Boeren for finding this). Index: phpdoc/en/reference/filesystem/functions/is-executable.xml diff -u phpdoc/en/reference/filesystem/functions/is-executable.xml:1.2 phpdoc/en/reference/filesystem/functions/is-executable.xml:1.3 --- phpdoc/en/reference/filesystem/functions/is-executable.xml:1.2 Wed Apr 17 02:38:08 2002 +++ phpdoc/en/reference/filesystem/functions/is-executable.xml Mon Oct 7 11:45:38 +2002 @@ -1,5 +1,5 @@ - + @@ -24,6 +24,12 @@ linkend="features.remote-files">remote files; the file to be examined must be accessible via the server's filesystem. + + + This function is not available on + Win32. + + See also is_file and is_link. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/language variables.xml
mfischerWed Sep 11 09:53:10 2002 EDT Modified files: /phpdoc/en/language variables.xml Log: - Make paragraph about dynamically accessing super globals not possible a "Warning" so it's easier spotted. Index: phpdoc/en/language/variables.xml diff -u phpdoc/en/language/variables.xml:1.53 phpdoc/en/language/variables.xml:1.54 --- phpdoc/en/language/variables.xml:1.53 Thu Jul 25 05:59:48 2002 +++ phpdoc/en/language/variables.xmlWed Sep 11 09:53:09 2002 @@ -1,5 +1,5 @@ - + Variables @@ -714,14 +714,16 @@ ${$a}[1] for the second. - -Please note that variable variables cannot be used with PHP's -Superglobal arrays. -This means you cannot do things like ${$_GET}. If you are -looking for a way to handle availability of superglobals and the old -HTTP_*_VARS, you might want to try -referencing them. - + + + Please note that variable variables cannot be used with PHP's + Superglobal arrays. + This means you cannot do things like ${$_GET}. If you are + looking for a way to handle availability of superglobals and the old + HTTP_*_VARS, you might want to try + referencing them. + + -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/array/functions extract.xml
mfischerTue Sep 10 03:49:39 2002 EDT Modified files: /phpdoc/en/reference/array/functionsextract.xml Log: - Document new EXTR_REFS flag introduced by Andrei. Index: phpdoc/en/reference/array/functions/extract.xml diff -u phpdoc/en/reference/array/functions/extract.xml:1.4 phpdoc/en/reference/array/functions/extract.xml:1.5 --- phpdoc/en/reference/array/functions/extract.xml:1.4 Sun May 12 04:19:28 2002 +++ phpdoc/en/reference/array/functions/extract.xml Tue Sep 10 03:49:38 2002 @@ -1,5 +1,5 @@ - + @@ -36,6 +36,11 @@ EXTR_IF_EXISTS and EXTR_PREFIX_IF_EXISTS was introduced in version 4.2.0. + + + EXTR_REFS was introduced in version 4.3.0. + + extract checks each key to see whether it constitutes a valid variable name and also for collisions with @@ -108,6 +113,19 @@ Only create prefixed variable names if the non-prefixed version of the same variable exists in the current symbol table. This flag was added in PHP 4.2.0. + + + + + EXTR_REFS + + + Extracts variables as references. This effectively means that the + values of the imported variables are still referencing the values of + the var_array parameter. You can use this flag + on it's own or combine it with any other flag by OR'ing the + extract_type. This flag was added in PHP + 4.3.0. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/mysql/functions mysql-db-query.xml
mfischerFri Sep 6 09:02:35 2002 EDT Modified files: /phpdoc/en/reference/mysql/functionsmysql-db-query.xml Log: - Document the "changes database and not back" behaviour. - Incooperate user comment about insert/select/delete queries from [EMAIL PROTECTED] Index: phpdoc/en/reference/mysql/functions/mysql-db-query.xml diff -u phpdoc/en/reference/mysql/functions/mysql-db-query.xml:1.3 phpdoc/en/reference/mysql/functions/mysql-db-query.xml:1.4 --- phpdoc/en/reference/mysql/functions/mysql-db-query.xml:1.3 Sat May 25 17:09:15 2002 +++ phpdoc/en/reference/mysql/functions/mysql-db-query.xml Fri Sep 6 09:02:32 +2002 @@ -1,5 +1,5 @@ - + @@ -18,7 +18,9 @@ Returns a positive MySQL result resource to the query result, - or &false; on error. + or &false; on error. The function also returns &true;/&false; for + INSERT/UPDATE/DELETE + queries to indicate success/failure. mysql_db_query selects a database and @@ -27,6 +29,15 @@ MySQL server and if no such link is found it'll try to create one as if mysql_connect was called with no arguments. + + + Be aware that this function does NOT + switch back to the database you were connected before. In other words, + you can't use this function to temporarily run a + sql query on another database, you would have to manually switch back. + Users are strongly encouraged to use the + database.table syntax in their sql queries instead of + this function. See also mysql_connect and -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/pcre/functions pcre.pattern.modifiers.xml
mfischerFri Sep 6 07:32:29 2002 EDT Modified files: /phpdoc/en/reference/pcre/functions pcre.pattern.modifiers.xml Log: - /u modifier is now also supported since 4.2.3 Index: phpdoc/en/reference/pcre/functions/pcre.pattern.modifiers.xml diff -u phpdoc/en/reference/pcre/functions/pcre.pattern.modifiers.xml:1.3 phpdoc/en/reference/pcre/functions/pcre.pattern.modifiers.xml:1.4 --- phpdoc/en/reference/pcre/functions/pcre.pattern.modifiers.xml:1.3 Sat Aug 10 09:34:42 2002 +++ phpdoc/en/reference/pcre/functions/pcre.pattern.modifiers.xml Fri Sep 6 +07:32:29 2002 @@ -1,5 +1,5 @@ - + @@ -172,7 +172,8 @@ This modifier turns on additional functionality of PCRE that is incompatible with Perl. Pattern strings are treated as - UTF-8. This modifier is available from PHP 4.1.0 or greater. + UTF-8. This modifier is available from PHP 4.1.0 or greater + on Unix and from PHP 4.2.3 on win32. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/strings/functions strcoll.xml
mfischerFri Sep 6 07:27:36 2002 EDT Modified files: /phpdoc/en/reference/strings/functions strcoll.xml Log: - strcoll() is enabled for win32 since 4.2.3 Index: phpdoc/en/reference/strings/functions/strcoll.xml diff -u phpdoc/en/reference/strings/functions/strcoll.xml:1.2 phpdoc/en/reference/strings/functions/strcoll.xml:1.3 --- phpdoc/en/reference/strings/functions/strcoll.xml:1.2 Wed Apr 17 02:44:22 2002 +++ phpdoc/en/reference/strings/functions/strcoll.xml Fri Sep 6 07:27:36 2002 @@ -1,5 +1,5 @@ - + @@ -26,6 +26,12 @@ Note that this comparison is case sensitive, and unlike strcmp this function is not binary safe. + + + strcoll was added in PHP 4.0.5, but was not enabled + for win32 until 4.2.3. + + See also ereg, strcmp, strcasecmp, substr, -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/sem reference.xml
mfischerThu Sep 5 06:32:26 2002 EDT Modified files: /phpdoc/en/reference/semreference.xml Log: - Mention how to get sysvmsg support in. Index: phpdoc/en/reference/sem/reference.xml diff -u phpdoc/en/reference/sem/reference.xml:1.5 phpdoc/en/reference/sem/reference.xml:1.6 --- phpdoc/en/reference/sem/reference.xml:1.5 Fri Aug 9 06:26:11 2002 +++ phpdoc/en/reference/sem/reference.xml Thu Sep 5 06:32:25 2002 @@ -1,5 +1,5 @@ - + Semaphore, Shared Memory and IPC Functions Semaphore @@ -78,6 +78,8 @@ --enable-sysvsem. To enable the System V shared memory support compile PHP with the option --enable-sysvshm. + To enable the System V messages support compile PHP with the option + --enable-sysvmsg. -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/dir/functions readdir.xml
mfischerWed Sep 4 04:19:47 2002 EDT Modified files: /phpdoc/en/reference/dir/functions readdir.xml Log: - Give a trivial example how a directory could be named who evaluates to false. Index: phpdoc/en/reference/dir/functions/readdir.xml diff -u phpdoc/en/reference/dir/functions/readdir.xml:1.2 phpdoc/en/reference/dir/functions/readdir.xml:1.3 --- phpdoc/en/reference/dir/functions/readdir.xml:1.2 Wed Apr 17 02:37:35 2002 +++ phpdoc/en/reference/dir/functions/readdir.xml Wed Sep 4 04:19:47 2002 @@ -1,5 +1,5 @@ - + @@ -25,7 +25,7 @@ linkend="language.operators.comparison">Comparison Operators for more information) &false; since otherwise, any directory entry whose name evaluates to &false; will stop the - loop. + loop (e.g. a directory named "0"). -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
[PHP-DOC] cvs: phpdoc /en/reference/ftp/functions ftp-connect.xml
mfischerThu Aug 15 04:35:43 2002 EDT Modified files: /phpdoc/en/reference/ftp/functions ftp-connect.xml Log: - "timeout" parameter is available since 4.2.0 Index: phpdoc/en/reference/ftp/functions/ftp-connect.xml diff -u phpdoc/en/reference/ftp/functions/ftp-connect.xml:1.2 phpdoc/en/reference/ftp/functions/ftp-connect.xml:1.3 --- phpdoc/en/reference/ftp/functions/ftp-connect.xml:1.2 Wed Apr 17 02:38:15 2002 +++ phpdoc/en/reference/ftp/functions/ftp-connect.xml Thu Aug 15 04:35:43 2002 @@ -1,5 +1,5 @@ - + @@ -31,7 +31,7 @@ ftp_get_option. - This parameter is only available in CVS. + This parameter is available since 4.2.0 . -- PHP Documentation Mailing List (http://www.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php
Re: [PHP-DOC] cvs: phpdoc /en/appendices commandline.xml
On Sun, Jun 23, 2002 at 01:26:02AM -, Marcus Börger wrote : > helly Sat Jun 22 21:26:02 2002 EDT > > Modified files: > /phpdoc/en/appendices commandline.xml > Log: > explain cli and difference to cgi Are you sure you hit the right document? I don't see appendices/commandilne.xml being used anywhere (might be wrong?) , we were updating features/commandline.xml instead which is the one reflected at http://www.php.net/manual/en/features.commandline.php . - Markus
[PHP-DOC] cvs: phpdoc /en/reference/array constants.xml
mfischerSun Jun 16 10:19:58 2002 EDT Modified files: /phpdoc/en/reference/array constants.xml Log: - Correct tag. Index: phpdoc/en/reference/array/constants.xml diff -u phpdoc/en/reference/array/constants.xml:1.1 phpdoc/en/reference/array/constants.xml:1.2 --- phpdoc/en/reference/array/constants.xml:1.1 Sun Jun 16 10:19:01 2002 +++ phpdoc/en/reference/array/constants.xml Sun Jun 16 10:19:58 2002 @@ -1,5 +1,5 @@ - + &reftitle.constants; &extension.constants;
[PHP-DOC] cvs: phpdoc /en/reference/array constants.xml reference.xml
mfischerSun Jun 16 10:19:01 2002 EDT Added files: /phpdoc/en/reference/array constants.xml Modified files: /phpdoc/en/reference/array reference.xml Log: - Move constants to their own file. Index: phpdoc/en/reference/array/reference.xml diff -u phpdoc/en/reference/array/reference.xml:1.5 phpdoc/en/reference/array/reference.xml:1.6 --- phpdoc/en/reference/array/reference.xml:1.5 Sun May 12 04:19:28 2002 +++ phpdoc/en/reference/array/reference.xml Sun Jun 16 10:19:01 2002 @@ -1,5 +1,5 @@ - + Array Functions Arrays @@ -45,14 +45,7 @@ &no.resource; - -&reftitle.constants; - - CASE_UPPER and CASE_LOWER are - used with the array_change_key_case function. They - respectively are used for changing a string to upper case or lower case. - - + &reference.array.constants; &reftitle.seealso; Index: phpdoc/en/reference/array/constants.xml +++ phpdoc/en/reference/array/constants.xml &reftitle.constants; &extension.constants; CASE_LOWER (integer) CASE_LOWER is used with array_change_key_case and is used to convert array keys to lower case. This is also the default case for array_change_key_case. CASE_UPPER (integer) CASE_UPPER is used with array_change_key_case and is used to convert array keys to upper case.
[PHP-DOC] cvs: phpdoc /en/appendices migration4.xml /en/chapters security.xml /en/faq using.xml /en/features file-upload.xml remote-files.xml /en/language variables.xml /en/reference/array/functions each.xml /en/reference/cybermut/functions cybermut-testmac.xml /en/reference/funchand/functions call-user-func-array.xml /en/reference/http/functions setcookie.xml /en/reference/session/functions session-is-registered.xml session-register.xml session-unregister.xml /en/reference/var/functions get-defined-vars.xml
mfischerSun Jun 16 03:11:04 2002 EDT Modified files: /phpdoc/en/appendices migration4.xml /phpdoc/en/chapters security.xml /phpdoc/en/faq using.xml /phpdoc/en/features file-upload.xml remote-files.xml /phpdoc/en/language variables.xml /phpdoc/en/reference/array/functionseach.xml /phpdoc/en/reference/cybermut/functions cybermut-testmac.xml /phpdoc/en/reference/funchand/functions call-user-func-array.xml /phpdoc/en/reference/http/functions setcookie.xml /phpdoc/en/reference/session/functions session-is-registered.xml session-register.xml session-unregister.xml /phpdoc/en/reference/var/functions get-defined-vars.xml Log: - Use new superglobals by default, mention old way were applicable. Index: phpdoc/en/appendices/migration4.xml diff -u phpdoc/en/appendices/migration4.xml:1.23 phpdoc/en/appendices/migration4.xml:1.24 --- phpdoc/en/appendices/migration4.xml:1.23Thu Mar 28 12:16:34 2002 +++ phpdoc/en/appendices/migration4.xml Sun Jun 16 03:10:59 2002 @@ -1,5 +1,5 @@ - + Migrating from PHP 3 to PHP 4 @@ -261,8 +261,8 @@ that makes your script give him access rights he wasn't intended to have. So PHP 4 will now warn you whenever you use unquoted string constants as for example in - $HTTP_SERVER_VARS[REQUEST_METHOD]. Changing it - to $HTTP_SERVER_VARS['REQUEST_METHOD'] will + $_SERVER[REQUEST_METHOD]. Changing it + to $_SERVER['REQUEST_METHOD'] will make the parser happy and greatly improve the style and security of your code. Index: phpdoc/en/chapters/security.xml diff -u phpdoc/en/chapters/security.xml:1.47 phpdoc/en/chapters/security.xml:1.48 --- phpdoc/en/chapters/security.xml:1.47Thu Mar 28 12:16:36 2002 +++ phpdoc/en/chapters/security.xml Sun Jun 16 03:11:00 2002 @@ -1,5 +1,5 @@ - + Security @@ -384,7 +384,7 @@ Index: phpdoc/en/features/file-upload.xml diff -u phpdoc/en/features/file-upload.xml:1.38 phpdoc/en/features/file-upload.xml:1.39 --- phpdoc/en/features/file-upload.xml:1.38 Tue May 28 15:04:20 2002 +++ phpdoc/en/features/file-upload.xml Sun Jun 16 03:11:00 2002 @@ -1,5 +1,5 @@ - + Handling file uploads @@ -75,12 +75,12 @@ -The contents of $HTTP_POST_FILES are as +The contents of $_FILES are as follows. Note that this assumes the use of the file upload name 'userfile', as used in the example script above: - $HTTP_POST_FILES['userfile']['name'] + $_FILES['userfile']['name'] The original name of the file on the client machine. @@ -88,7 +88,7 @@ - $HTTP_POST_FILES['userfile']['type'] + $_FILES['userfile']['type'] The mime type of the file, if the browser provided this @@ -98,7 +98,7 @@ - $HTTP_POST_FILES['userfile']['size'] + $_FILES['userfile']['size'] The size, in bytes, of the uploaded file. @@ -106,7 +106,7 @@ - $HTTP_POST_FILES['userfile']['tmp_name'] + $_FILES['userfile']['tmp_name'] The temporary filename of the file in which the uploaded file @@ -118,9 +118,9 @@ - PHP 4.1.0 or later supports a short track variable - $_FILES. PHP 3 does not support - $HTTP_POST_FILES. + In PHP versions prior 4.1.0 this was named + $HTTP_POST_VARS and was not an autoglobal variable. + PHP 3 does not support $HTTP_POST_FILES. @@ -191,14 +191,14 @@ @@ -208,10 +208,10 @@ The PHP script which receives the uploaded file should implement whatever logic is necessary for determining what should be done with the uploaded file. You can for example use the -$HTTP_POST_FILES['userfile']['size'] variable +$_FILES['userfile']['size'] variable to throw away any files that are either too small or too big. You could use the -$HTTP_POST_FILES['userfile']['type'] variable +$_FILES['userfile']['type'] variable to throw away any files that didn't match a certain type criteria. Whatever the logic, you should either delete the file from the temporary directory or move it elsewhere. @@ -293,11 +293,12 @@ When the above form is submitted, the arrays -$HTTP_POST_FILES['userfile'], -$HTTP_POST_FILES['userfile']['name'], and -$HTTP_POST_FILES['userfile']['size'] will be -initialized. (As well as in $_FILES for PHP 4.1.0 or -later. $HTTP_POST_VARS in PHP 3. When +$_FILES['userfile'], +$_FILES['userfile']['name'], and +$_FILES['userfile']['size'] will be +initialized (as well as in $HTTP_POST_FILES for PHP version +prior 4.1.0). +When register_globals is on, globals for
Re: [PHP-DOC] Re: phpdoc /en/reference/mail/functions ezmlm-hash.xml
On Sat, Jun 15, 2002 at 07:02:54PM -0300, Alessander Thomaz wrote : > help... > > i'm not uptade to pt-BR What is the exact command you use to commit? Just explicitely name the files you want to commit, e.g. cvs commit phpdoc-bt_BR/ - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] cvs: phpdoc /en/appendices tokens.xml
mfischerThu Jun 13 10:41:05 2002 EDT Modified files: /phpdoc/en/appendices tokens.xml Log: - Ops. Index: phpdoc/en/appendices/tokens.xml diff -u phpdoc/en/appendices/tokens.xml:1.4 phpdoc/en/appendices/tokens.xml:1.5 --- phpdoc/en/appendices/tokens.xml:1.4 Thu Jun 13 10:35:47 2002 +++ phpdoc/en/appendices/tokens.xml Thu Jun 13 10:41:04 2002 @@ -1,5 +1,5 @@ - + List of Parser Tokens @@ -563,12 +563,6 @@ T_WHITESPACE - - - T_XOR_EQUAL - ^= - assignment - operators T_XOR_EQUAL
[PHP-DOC] cvs: phpdoc /en/appendices reserved.xml tokens.xml
mfischerThu Jun 13 10:35:48 2002 EDT Modified files: /phpdoc/en/appendices reserved.xml tokens.xml Log: - At least mention the new __CLASS__ and __FUNCTION__ constants in the manual somewhere ... Index: phpdoc/en/appendices/reserved.xml diff -u phpdoc/en/appendices/reserved.xml:1.22 phpdoc/en/appendices/reserved.xml:1.23 --- phpdoc/en/appendices/reserved.xml:1.22 Mon Jun 10 19:02:33 2002 +++ phpdoc/en/appendices/reserved.xml Thu Jun 13 10:35:47 2002 @@ -1,5 +1,5 @@ - + List of Reserved Words @@ -198,6 +198,12 @@ while + + +__FUNCTION__ + + +__CLASS__ Index: phpdoc/en/appendices/tokens.xml diff -u phpdoc/en/appendices/tokens.xml:1.3 phpdoc/en/appendices/tokens.xml:1.4 --- phpdoc/en/appendices/tokens.xml:1.3 Mon May 27 06:04:02 2002 +++ phpdoc/en/appendices/tokens.xml Thu Jun 13 10:35:47 2002 @@ -1,5 +1,5 @@ - + List of Parser Tokens @@ -569,6 +569,24 @@ ^= assignment operators + + + T_XOR_EQUAL + ^= + assignment + operators + + + T_FUNC_C + __FUNCTION__ + constants, since + PHP 4.3.0 + + + T_CLASS_C + __CLASS__ + constants, since + PHP 4.3.0
Re: [PHP-DOC] Documantation of + for arrays
Hi, it's not documented and there's also an open bug report about it. On Tue, Jun 11, 2002 at 12:24:11PM +0200, Michal Suchanek wrote : > I think this feature (merging arrays with + operator) needs more > documentation. > I did not find any word about this in > -operators page > -array type page > -array functions page > > The only documentation I found is in notes for array_merge. > I suggest adding description of this feature to one of the three > sections and provide links in the other two where it logically belongs. > > It is possible that the use of + with arrays is already documented > somewhere but I was unable to find it. Then adding links to the above > three sections could help. > > [EMAIL PROTECTED] -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
Re: [PHP-DOC] Splitting out ini setting per module like constants?
On Thu, Jun 13, 2002 at 01:24:20PM +0200, Gabor Hojtsy wrote : > Yes but we will also need an autogenerator script, to autogenerate > the constants index (to have it one place), much like the function > index... Ah ,so this is one part that is not yet finished, ok. But despite this, I could use the Ibase extension as a guide how all extension should look like. This means the files in appendix/* get deleted as we further process it and in some point in the future we'll have it autogenerated ? - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
Re: [PHP-DOC] Splitting out ini setting per module like constants?
Hi, On Tue, Jun 11, 2002 at 03:46:58PM +0200, Gabor Hojtsy wrote : > I cannot completely undestand what you cannot understand but you > can easily spot what we have done with Friedhelm. Open eg. the > reference.xml from the ibase extension. The new and clean structure > for reference.xml files is the -ed one you can see here. > Every section has it's own id with EXTNAME.SECTIONTYPE format. Every > section title is expressed by using a section title entity (to ease > translation for lasy guys such as me :). The constants.xml file > should be in the same dir, and look quite like the other s > in the reference.xml file (it could be easily modified from the > copy-pasted sources from appendices/*). Then if you move the constants > info from the appendices dir, the corresponding file should be deleted > from there, and the entity from phpdoc/reserved.constants.xml should > also be removed. Now that I've taken a look, I'm a bit confused. Ibase has cleaned out the cosntants in ibase/constants.xml , ok. But they are not listed in reserved.constants.html in the appendix. Wasn't it the idea to write down the constant one time in the extensions directory but also provide a comprehensive overview in the appendix? - MArkus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] cvs: phpdoc /en/reference/pcre reference.xml /en/reference/pcre/functions preg-match-all.xml preg-match.xml preg-split.xml
mfischerThu Jun 13 03:55:02 2002 EDT Modified files: /phpdoc/en/reference/pcre reference.xml /phpdoc/en/reference/pcre/functions preg-match-all.xml preg-match.xml preg-split.xml Log: - Update to latest PCRE changes. # Would be nice if someone can provide examples for preg_match() and # preg_match_all() with the new PREG_OFFSET_CAPTURE flag. Index: phpdoc/en/reference/pcre/reference.xml diff -u phpdoc/en/reference/pcre/reference.xml:1.2 phpdoc/en/reference/pcre/reference.xml:1.3 --- phpdoc/en/reference/pcre/reference.xml:1.2 Mon Apr 15 17:57:12 2002 +++ phpdoc/en/reference/pcre/reference.xml Thu Jun 13 03:55:02 2002 @@ -1,5 +1,5 @@ - + Regular Expression Functions (Perl-Compatible) PCRE @@ -58,10 +58,70 @@ Predefined constants - PREG_PATTERN_ORDER - PREG_SET_ORDER - PREG_SPLIT_NO_EMPTY - PREG_SPLIT_DELIM_CAPTURE + + PREG constants + + + + constant + description + + + + + PREG_PATTERN_ORDER + + Orders results so that $matches[0] is an array of full pattern + matches, $matches[1] is an array of strings matched by the first + parenthesized subpattern, and so on. This flag is only used with + preg_match_all. + + + + PREG_SET_ORDER + + Orders results so that $matches[0] is an array of first set of + matches, $matches[1] is an array of second set of matches, and so + on. This flag is only used with preg_match_all. + + + + PREG_OFFSET_CAPTURE + + See the description of + PREG_SPLIT_OFFSET_CAPTURE. This flag is + available since PHP 4.3.0 . + + + + PREG_SPLIT_NO_EMPTY + + This flag tells preg_split to only return only + non-empty pieces. + + + + PREG_SPLIT_DELIM_CAPTURE + + This flag tells preg_split to capture + parenthesized expression in the delimiter pattern as well. This flag + is available since PHP 4.0.5 . + + + + PREG_SPLIT_OFFSET_CAPTURE + + If this flag is set, for every occuring match the appendant string + offset will also be returned. Note that this changes the return + value in an array where very element is an array consisting of the + matched string at offset 0 and it's string offset into subject at + offset 1. This flag is available since PHP 4.3.0 + and is only used for preg_split. + + + + + @@ -71,10 +131,10 @@ Examples of valid patterns - /<\/\w+>/ - |(\d{3})-\d+|Sm - /^(?i)php[34]/ - {^\s+(\s+)?$} + /<\/\w+>/ + |(\d{3})-\d+|Sm + /^(?i)php[34]/ + {^\s+(\s+)?$} @@ -84,17 +144,17 @@ - /href='(.*)' - missing ending delimiter + /href='(.*)' - missing ending delimiter - /\w+\s*\w+/J - unknown modifier 'J' + /\w+\s*\w+/J - unknown modifier 'J' - 1-\d3-\d3-\d4| - missing starting delimiter + 1-\d3-\d3-\d4| - missing starting delimiter Index: phpdoc/en/reference/pcre/functions/preg-match-all.xml diff -u phpdoc/en/reference/pcre/functions/preg-match-all.xml:1.3 phpdoc/en/reference/pcre/functions/preg-match-all.xml:1.4 --- phpdoc/en/reference/pcre/functions/preg-match-all.xml:1.3 Sun May 12 12:13:12 2002 +++ phpdoc/en/reference/pcre/functions/preg-match-all.xml Thu Jun 13 03:55:02 +2002 @@ -1,5 +1,5 @@ - + @@ -13,7 +13,7 @@ stringpattern stringsubject arraymatches - intorder + intflags Searches subject for all matches to the regular @@ -26,7 +26,10 @@ on from end of the last match. - order can be one of two things: + flags can be a combination of the following flags + (note that it doesn't make sense to use + PREG_PATTERN_ORDER together with + PREG_SET_ORDER): PREG_PATTERN_ORDER @@ -94,11 +97,24 @@ + + PREG_OFFSET_CAPTURE + + + If this flag is set, for every occuring match the appendant string + offset will also be returned. Note that this changes the return + value in an array where every element is an array consisting of the + matched string at offset 0 and it's string offset + into subject at offset 1. + This flag is available since PHP 4.3.0 . + + + - If order is not specified, i
[PHP-DOC] Re: [PHP-DEV] Re: [PHP-DOC] Fwd: Re: [PHP-DEV] filesystem security questions
Hi, streams are mostly only visible internally right now. At least, this is what Andi was talking about, documenting the C API of streams because it should be used from now on but documentation is limited. So, this would be a candidate in Zend API docs ... ? But then, it's not Zend stuff, so it should be in the PHP manual, some C API section. - Markus On Wed, Jun 12, 2002 at 12:09:04PM +0200, Gabor Hojtsy wrote : > > Can someone please help out Wez? ;) > > I don't really know what streams are about [it's not documented ;)], > so if it's a new extension, Wez can start with copy-pasting one > extensions documentation (see phpdoc/en/reference/ANY_EXTENSION_NAME). > The XML files are quite self descriptive, so the tags to be used speak > for themselfs. > > But we would also be happy with a nicely formatted text file (like the > one in the overload/README), and so we can build up an XML file based > on it.
Re: [PHP-DOC] Error in documentation
On Wed, Jun 12, 2002 at 11:35:02AM +0200, Stéphane Giroud wrote : > I'm French so excuse me for my bad english. > > I found an error on page : > http://www.php.net/manual/en/function.domnode-child-nodes.php > (and in any language) > > In this page the function "child_nodes" is written (2 > X) "child-nodes" like in the title > (DomNode->child-nodes). Thanks, it's fixed in CVS. - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] cvs: phpdoc /en/reference/domxml/functions DomNode-child-nodes.xml
mfischerWed Jun 12 05:59:39 2002 EDT Modified files: /phpdoc/en/reference/domxml/functions DomNode-child-nodes.xml Log: - Fix typo. Index: phpdoc/en/reference/domxml/functions/DomNode-child-nodes.xml diff -u phpdoc/en/reference/domxml/functions/DomNode-child-nodes.xml:1.2 phpdoc/en/reference/domxml/functions/DomNode-child-nodes.xml:1.3 --- phpdoc/en/reference/domxml/functions/DomNode-child-nodes.xml:1.2Wed Apr 17 02:37:38 2002 +++ phpdoc/en/reference/domxml/functions/DomNode-child-nodes.xmlWed Jun 12 +05:59:38 2002 @@ -1,9 +1,9 @@ - + -DomNode->child-nodes +DomNode->child_nodes Returns children of node
[PHP-DOC] cvs: phpdoc /en/reference/info/functions ini-set.xml /en/reference/session reference.xml
mfischerWed Jun 12 05:50:49 2002 EDT Modified files: /phpdoc/en/reference/info/functions ini-set.xml /phpdoc/en/reference/sessionreference.xml Log: - Document new session.use_only_cookies ini setting. Index: phpdoc/en/reference/info/functions/ini-set.xml diff -u phpdoc/en/reference/info/functions/ini-set.xml:1.8 phpdoc/en/reference/info/functions/ini-set.xml:1.9 --- phpdoc/en/reference/info/functions/ini-set.xml:1.8 Mon Jun 10 17:59:22 2002 +++ phpdoc/en/reference/info/functions/ini-set.xml Wed Jun 12 05:50:45 2002 @@ -1,5 +1,5 @@ - + @@ -680,6 +680,11 @@ session.use_cookies "1" + PHP_INI_ALL + + + session.use_only_cookies + "0" PHP_INI_ALL Index: phpdoc/en/reference/session/reference.xml diff -u phpdoc/en/reference/session/reference.xml:1.5 phpdoc/en/reference/session/reference.xml:1.6 --- phpdoc/en/reference/session/reference.xml:1.5 Sat May 25 12:35:24 2002 +++ phpdoc/en/reference/session/reference.xml Wed Jun 12 05:50:49 2002 @@ -1,5 +1,5 @@ - + Session handling functions Sessions @@ -391,6 +391,16 @@ session.use_cookies specifies whether the module will use cookies to store the session id on the client side. Defaults to 1 (enabled). + + + + + session.use_only_cookies specifies whether the + module will only use cookies to + store the session id on the client side. Defaults to + 0 (disabled, for backward compatibility). Enabling + this setting prevents attacks involved passing session ids in URLs. + This setting was added in PHP 4.3.0.
Re: [PHP-DOC] Re: Bug #17660 Updated: Outdated Documentation
Hi, On Wed, Jun 12, 2002 at 07:31:58AM +0200, Markus Fischer wrote : > But for a start, I'll look forward to apply them if you send > them. But before you get me wrong, patches are meant to be against the docbook xml sources, NOT against the rendered HTML pages .. (just in case). - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] Re: Bug #17660 Updated: Outdated Documentation
Hi, On Tue, Jun 11, 2002 at 10:34:14PM -, [EMAIL PROTECTED] wrote : > ID: 17660 > Updated by: [EMAIL PROTECTED] > Reported By: [EMAIL PROTECTED] > Status: Open > Bug Type: Documentation problem > Operating System: Windows 95 > PHP Version: 4.2.1 > New Comment: > > Do I really need a cvs account to help with this? > Maybe I can just submit the corrections. Well, yes, you can try to send them to [EMAIL PROTECTED] . But there's always the risk that people have no time at the moment and no one applies it and after some time it gerts forgotten ;) But for a start, I'll look forward to apply them if you send them. - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
Re: [PHP-DOC] Splitting out ini setting per module like constants?
On Tue, Jun 11, 2002 at 03:33:35PM +0200, Gabor Hojtsy wrote : > No, it's not finished, it's on the way, with the general reference page > "facelift" project. Look at the reservered.constants.xml file in the phpdoc > root dir. It still contains many constant xml files (which are ugly named, > and not at the right place). And see in the appendices directory. Those > files are not moved. I have started this and Friedhelm caught up, by > ocassionally doing some files in alphabetical order... I would not be too > good to have more major reorganization in progress... Instead we should > join forces to do one in a shorter time AFAIK... I'm absolutely for joining :) If I now just would have understood what you tried to tell me about the file I would be glad - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
Re: [PHP-DOC] Splitting out ini setting per module like constants?
On Tue, Jun 11, 2002 at 02:19:18PM +0200, Gabor Hojtsy wrote : > > what do you think about giving it's module extension it's own > > ini-settings.xml file just like constants.xml and list them > > for each module and also all settings at once in the > > appendix? > > is also on the way. Having too much inconsistency is not the way to go, > so it would be better to first end the constants.xml files modifications, > and the start with ini.xml and/or config.xml. What is left to be done? I remember some commits, wasn't this finished? - MArkus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] Splitting out ini setting per module like constants?
Hi, what do you think about giving it's module extension it's own ini-settings.xml file just like constants.xml and list them for each module and also all settings at once in the appendix? - Markus -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] cvs: phpdoc /en/appendices predefined.xml reserved.xml /en/features http-auth.xml
mfischerMon Jun 10 19:02:35 2002 EDT Modified files: /phpdoc/en/features http-auth.xml /phpdoc/en/appendices reserved.xml predefined.xml Log: - Document the *AUTH* vars in the predefined appendix, use $_SERVER and $_REQUEST in the http auth example, closes #14804. # Wth has there been used !strcmp() to match strigns?! Removed. Index: phpdoc/en/features/http-auth.xml diff -u phpdoc/en/features/http-auth.xml:1.22 phpdoc/en/features/http-auth.xml:1.23 --- phpdoc/en/features/http-auth.xml:1.22 Sat May 11 16:29:49 2002 +++ phpdoc/en/features/http-auth.xmlMon Jun 10 19:02:32 2002 @@ -1,5 +1,5 @@ - + HTTP authentication with PHP @@ -25,14 +25,14 @@ @@ -104,15 +104,15 @@ exit; } - if (!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER))) { + if (!isset($_SERVER['PHP_AUTH_USER']) || ($SeenBefore == 1 && $OldAuth == +$_SERVER['$PHP_AUTH_USER']))) { authenticate(); } else { - echo "Welcome: $PHP_AUTH_USER"; - echo "Old: $OldAuth"; - echo "\n"; + echo "Welcome: {$_SERVER['$PHP_AUTH_USER']}"; + echo "Old: {$_REQUEST['$OldAuth']}"; + echo "\n"; echo "\n"; - echo "\n"; + echo "\n"; echo "\n"; echo "\n"; } Index: phpdoc/en/appendices/reserved.xml diff -u phpdoc/en/appendices/reserved.xml:1.21 phpdoc/en/appendices/reserved.xml:1.22 --- phpdoc/en/appendices/reserved.xml:1.21 Fri May 17 13:32:24 2002 +++ phpdoc/en/appendices/reserved.xml Mon Jun 10 19:02:33 2002 @@ -1,5 +1,5 @@ - + List of Reserved Words @@ -551,6 +551,36 @@ The URI which was given in order to access this page; for instance, '/index.html'. + + + + + + 'PHP_AUTH_USER' + + + When running under Apache as module doing HTTP authentication this + variable is set to the username prodived by the user. + + + + + + 'PHP_AUTH_PW' + + + When running under Apache as module doing HTTP authentication this + variable is set to the password prodived by the user. + + + + + + 'PHP_AUTH_TYPE' + + + When running under Apache as module doing HTTP authenticated this + variable is set to the authentication type. Index: phpdoc/en/appendices/predefined.xml diff -u phpdoc/en/appendices/predefined.xml:1.9 phpdoc/en/appendices/predefined.xml:1.10 --- phpdoc/en/appendices/predefined.xml:1.9 Mon May 27 07:31:07 2002 +++ phpdoc/en/appendices/predefined.xml Mon Jun 10 19:02:34 2002 @@ -1,5 +1,5 @@ - +
[PHP-DOC] cvs: phpdoc /en/reference/info/functions ini-set.xml
mfischerMon Jun 10 17:59:22 2002 EDT Modified files: /phpdoc/en/reference/info/functions ini-set.xml Log: - Include new mssql.max_procs ini option. Index: phpdoc/en/reference/info/functions/ini-set.xml diff -u phpdoc/en/reference/info/functions/ini-set.xml:1.7 phpdoc/en/reference/info/functions/ini-set.xml:1.8 --- phpdoc/en/reference/info/functions/ini-set.xml:1.7 Sat Jun 8 11:31:22 2002 +++ phpdoc/en/reference/info/functions/ini-set.xml Mon Jun 10 17:59:22 2002 @@ -1,5 +1,5 @@ - + @@ -406,6 +406,11 @@ mssql.max_links "-1" PHP_INI_SYSTEM + + + mssql.max_procs + "25" + PHP_INI_ALL mssql.min_error_severity
[PHP-DOC] cvs: phpdoc /en language-snippets.ent /en/chapters config.xml /en/features remote-files.xml /en/language control-structures.xml
mfischerMon Jun 10 17:41:16 2002 EDT Modified files: /phpdoc/en/language control-structures.xml /phpdoc/en/features remote-files.xml /phpdoc/en/chapters config.xml /phpdoc/en language-snippets.ent Log: - Add appropriate warnings that Windows does not support remote file access for the include/require friends. Index: phpdoc/en/language/control-structures.xml diff -u phpdoc/en/language/control-structures.xml:1.58 phpdoc/en/language/control-structures.xml:1.59 --- phpdoc/en/language/control-structures.xml:1.58 Fri May 24 09:23:17 2002 +++ phpdoc/en/language/control-structures.xml Mon Jun 10 17:41:15 2002 @@ -1,5 +1,5 @@ - + Control Structures @@ -1077,6 +1077,7 @@ require itself happens only once. + &warn.no-win32-fopen-wrapper; See also include, require_once, include_once, eval, @@ -1191,6 +1192,7 @@ being run on the remote server and the result is then being included into the local script. + &warn.no-win32-fopen-wrapper; include through HTTP @@ -1355,6 +1357,7 @@ require_once was added in PHP 4.0.1pl2 + &warn.no-win32-fopen-wrapper; See also: require, include, include_once, @@ -1392,6 +1395,7 @@ include_once was added in PHP 4.0.1pl2 + &warn.no-win32-fopen-wrapper; See also include, require, require_once, Index: phpdoc/en/features/remote-files.xml diff -u phpdoc/en/features/remote-files.xml:1.16 phpdoc/en/features/remote-files.xml:1.17 --- phpdoc/en/features/remote-files.xml:1.16Thu Apr 18 19:07:18 2002 +++ phpdoc/en/features/remote-files.xml Mon Jun 10 17:41:15 2002 @@ -1,5 +1,5 @@ - + Using remote files @@ -16,8 +16,10 @@ - You can't use remote files in include and - require statements on Windows. + The Windows version of PHP currently does not support + remote file accessing for the following functions: + include, include_once, + require and require_once. Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.56 phpdoc/en/chapters/config.xml:1.57 --- phpdoc/en/chapters/config.xml:1.56 Mon Jun 10 06:22:39 2002 +++ phpdoc/en/chapters/config.xml Mon Jun 10 17:41:15 2002 @@ -1,5 +1,5 @@ - + Configuration @@ -169,6 +169,14 @@ isable-url-fopen-wrapper. + + + On Windows, the following functions do not support remote file + accesing: include, + include_once, require and + require_once. + + Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.25 phpdoc/en/language-snippets.ent:1.26 --- phpdoc/en/language-snippets.ent:1.25Mon Apr 22 07:41:06 2002 +++ phpdoc/en/language-snippets.ent Mon Jun 10 17:41:16 2002 @@ -1,4 +1,4 @@ - + This extension is EXPERIMENTAL. The behaviour of this extension, @@ -16,6 +16,12 @@ This function is currently not documented; only the argument list is available.'> + +The Windows +version of PHP currently does not support remote +file accessing for this function, even if +allow_url_fopen is enabled. +'> As with anything that outputs its result directly to the browser, you can use the
[PHP-DOC] cvs: phpdoc /en/language oop.xml references.xml
mfischerMon Jun 10 06:51:59 2002 EDT Modified files: /phpdoc/en/language oop.xml references.xml Log: - Document that we have @new but not @&new or &@new, closes #14094. Index: phpdoc/en/language/oop.xml diff -u phpdoc/en/language/oop.xml:1.35 phpdoc/en/language/oop.xml:1.36 --- phpdoc/en/language/oop.xml:1.35 Mon Jun 10 04:43:11 2002 +++ phpdoc/en/language/oop.xml Mon Jun 10 06:51:57 2002 @@ -1,5 +1,5 @@ - + Classes and Objects @@ -343,6 +343,12 @@ ]]> + + +You also can use the @ operator to +mute errors occuring in the constructor, e.g. +@new. + Index: phpdoc/en/language/references.xml diff -u phpdoc/en/language/references.xml:1.22 phpdoc/en/language/references.xml:1.23 --- phpdoc/en/language/references.xml:1.22 Wed Dec 12 16:29:56 2001 +++ phpdoc/en/language/references.xml Mon Jun 10 06:51:58 2002 @@ -1,5 +1,5 @@ - + References Explained @@ -62,6 +62,13 @@ $this will operate on the copy, which is not always what is desired. Usually you want to have a single instance to work with, due to performance and memory consumption issues. + + + While you can use the @ operator to + mute any errors in the constructor when using it as + @new, this does not work when using the + &new statement. This is a limitation of the Zend + Engine and will therefore result in a parser error.
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions flock.xml
mfischerMon Jun 10 06:36:18 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions flock.xml Log: - Fix proto and #13191 (FAT FS doesn't support flock()ing). Index: phpdoc/en/reference/filesystem/functions/flock.xml diff -u phpdoc/en/reference/filesystem/functions/flock.xml:1.2 phpdoc/en/reference/filesystem/functions/flock.xml:1.3 --- phpdoc/en/reference/filesystem/functions/flock.xml:1.2 Wed Apr 17 02:38:07 2002 +++ phpdoc/en/reference/filesystem/functions/flock.xml Mon Jun 10 06:36:18 2002 @@ -1,5 +1,5 @@ - + @@ -12,7 +12,7 @@ boolflock intfp intoperation - intwouldblock + int&wouldblock PHP supports a portable way of locking complete files in an @@ -88,6 +88,12 @@ may not be able to rely on flock to protect files against other PHP scripts running in parallel threads of the same server instance! + + + flock is not supported on antiquated filesystems like + FAT and its derivates and will therefore always + return &false; under this environments (this is especially true for + Windows 98 users).
[PHP-DOC] cvs: phpdoc /en/chapters config.xml /en/faq installation.xml
mfischerMon Jun 10 06:22:39 2002 EDT Modified files: /phpdoc/en/chapters config.xml /phpdoc/en/faq installation.xml Log: - Document the PHPRC variable and some other php.ini related additionas, closes #13777. Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.55 phpdoc/en/chapters/config.xml:1.56 --- phpdoc/en/chapters/config.xml:1.55 Mon May 27 12:52:49 2002 +++ phpdoc/en/chapters/config.xml Mon Jun 10 06:22:39 2002 @@ -1,5 +1,5 @@ - + Configuration @@ -11,7 +11,19 @@ PHP 3.0, and simply &php.ini; as of PHP 4.0) is read when PHP starts up. For the server module versions of PHP, this happens only once when the web server is started. For the -CGI version, it happens on every invocation. +CGI and CLI version, it happens on +every invocation. + + +The default location of &php.ini; is a compile time option (see the FAQ entry), but can be changed +for the CGI and CLI version with the +-c command line switch, see the chapter about using +PHP from the command line. You can also use the +environment variable PHPRC for an additionaly path to +search for &php.ini;. + &php.ini; example Index: phpdoc/en/faq/installation.xml diff -u phpdoc/en/faq/installation.xml:1.16 phpdoc/en/faq/installation.xml:1.17 --- phpdoc/en/faq/installation.xml:1.16 Thu Mar 28 11:27:39 2002 +++ phpdoc/en/faq/installation.xml Mon Jun 10 06:22:39 2002 @@ -1,5 +1,5 @@ - + Installation Installation @@ -28,7 +28,8 @@ - By default on UNIX it should be in /usr/local/lib. + By default on UNIX it should be in /usr/local/lib + which is/lib. Most people will want to change this at compile-time with the --with-config-file-path flag. You would, for example, set it with something like: @@ -41,7 +42,15 @@ On Windows the default path for the &php.ini; file is the Windows - directory. + directory. If you're using the Apache webserver, &php.ini; is first + searched in the Apaches install directory, e.g. c:\program + files\apache group\apache. This way you can have + different &php.ini; files for different versions of Apache on the same + machine. + + + See also the chapter about the configuration file.
[PHP-DOC] cvs: phpdoc /en/language variables.xml
mfischerMon Jun 10 05:50:05 2002 EDT Modified files: /phpdoc/en/language variables.xml Log: - Fix #13645. Index: phpdoc/en/language/variables.xml diff -u phpdoc/en/language/variables.xml:1.47 phpdoc/en/language/variables.xml:1.48 --- phpdoc/en/language/variables.xml:1.47 Sun Jun 9 19:15:26 2002 +++ phpdoc/en/language/variables.xmlMon Jun 10 05:50:04 2002 @@ -1,5 +1,5 @@ - + Variables @@ -155,6 +155,12 @@ PHP predefined variables and their natures, please see the section Predefined variables. + + +If certain variables in variables_order are not set, their +appropriate superglobal arrays are also left empty. + PHP Superglobals
[PHP-DOC] cvs: phpdoc /en/language types.xml /en/reference/var/functions is-null.xml
mfischerMon Jun 10 05:15:37 2002 EDT Modified files: /phpdoc/en/language types.xml /phpdoc/en/reference/var/functions is-null.xml Log: - Properly document when a var is considered to be NULL and when not, closes #13577. Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.83 phpdoc/en/language/types.xml:1.84 --- phpdoc/en/language/types.xml:1.83 Sun Jun 9 15:52:00 2002 +++ phpdoc/en/language/types.xmlMon Jun 10 05:15:36 2002 @@ -1,5 +1,5 @@ - + Types @@ -1807,6 +1807,26 @@ The null type was introduced in PHP 4 + + A variable is considered to be &null; if + + + +it has been assigned the constant &null;. + + + + +it has not been set to any value yet. + + + + +it has been unset. + + + + Syntax @@ -1819,6 +1839,9 @@ $var = NULL; + + + See also is_null and unset. Index: phpdoc/en/reference/var/functions/is-null.xml diff -u phpdoc/en/reference/var/functions/is-null.xml:1.2 phpdoc/en/reference/var/functions/is-null.xml:1.3 --- phpdoc/en/reference/var/functions/is-null.xml:1.2 Wed Apr 17 02:44:57 2002 +++ phpdoc/en/reference/var/functions/is-null.xml Mon Jun 10 05:15:37 2002 @@ -1,5 +1,5 @@ - + @@ -19,7 +19,12 @@ &false; otherwise. - See also is_bool, + See the &null; type + when a variable is considered to be &null; and when not. + + + See also &null;, + is_bool, is_numeric, is_float, is_int,
[PHP-DOC] cvs: phpdoc /en/language oop.xml
mfischerMon Jun 10 04:43:11 2002 EDT Modified files: /phpdoc/en/language oop.xml Log: - Document that order of class definition is important (closes #13165). # Though the zend engine CAN handle class definitions not in the right order # this is not always true, especially when extending classes which extend # classes. See the report. Index: phpdoc/en/language/oop.xml diff -u phpdoc/en/language/oop.xml:1.34 phpdoc/en/language/oop.xml:1.35 --- phpdoc/en/language/oop.xml:1.34 Wed May 15 16:41:17 2002 +++ phpdoc/en/language/oop.xml Mon Jun 10 04:43:11 2002 @@ -1,5 +1,5 @@ - + Classes and Objects @@ -255,6 +255,25 @@ + +This is also called a "parent-child" relationship. You create a class, +parent, and use extends to create a new class +based on the parent class: the child class. You can +even use this new child class and create another class based on this child +class. + + + + Classes must be defined before they are used! If you want the class + Named_Cart to extend the class + Cart, you will have to define the class + Cart first. If you want to create another class called + Yellow_named_cart based on the class + Named_Cart you have to define + Named_Cart first. To make it short: the order in which + the classes are defined is important. + +
[PHP-DOC] cvs: phpdoc /en/reference/imap/functions imap-clearflag-full.xml imap-setflag-full.xml
mfischerMon Jun 10 04:04:10 2002 EDT Modified files: /phpdoc/en/reference/imap/functions imap-clearflag-full.xml imap-setflag-full.xml Log: - \\Recent can't be modified by the client, see RFC 2060 Section 2.3.2, closes #12864). Index: phpdoc/en/reference/imap/functions/imap-clearflag-full.xml diff -u phpdoc/en/reference/imap/functions/imap-clearflag-full.xml:1.2 phpdoc/en/reference/imap/functions/imap-clearflag-full.xml:1.3 --- phpdoc/en/reference/imap/functions/imap-clearflag-full.xml:1.2 Wed Apr 17 02:39:16 2002 +++ phpdoc/en/reference/imap/functions/imap-clearflag-full.xml Mon Jun 10 04:04:03 +2002 @@ -1,5 +1,5 @@ - + @@ -19,7 +19,7 @@ This function causes a store to delete the specified flag to the flags set for the messages in the specified sequence. The flags which you can unset are "\\Seen", "\\Answered", - "\\Flagged", "\\Deleted", "\\Draft", and "\\Recent" (as defined + "\\Flagged", "\\Deleted", and "\\Draft" (as defined by RFC2060). Index: phpdoc/en/reference/imap/functions/imap-setflag-full.xml diff -u phpdoc/en/reference/imap/functions/imap-setflag-full.xml:1.2 phpdoc/en/reference/imap/functions/imap-setflag-full.xml:1.3 --- phpdoc/en/reference/imap/functions/imap-setflag-full.xml:1.2Wed Apr 17 02:39:22 2002 +++ phpdoc/en/reference/imap/functions/imap-setflag-full.xmlMon Jun 10 04:04:06 +2002 @@ -1,5 +1,5 @@ - + @@ -21,7 +21,7 @@ The flags which you can set are "\\Seen", "\\Answered", - "\\Flagged", "\\Deleted", "\\Draft", and "\\Recent" (as defined + "\\Flagged", "\\Deleted", and "\\Draft" (as defined by RFC2060).
[PHP-DOC] cvs: phpdoc /en/reference/calendar constants.xml /en/reference/calendar/functions easter-date.xml easter-days.xml
mfischerMon Jun 10 03:53:22 2002 EDT Modified files: /phpdoc/en/reference/calendar constants.xml /phpdoc/en/reference/calendar/functions easter-date.xml easter-days.xml Log: - Update docs for new constants and correct since when the first parameter can be ommited. Index: phpdoc/en/reference/calendar/constants.xml diff -u phpdoc/en/reference/calendar/constants.xml:1.1 phpdoc/en/reference/calendar/constants.xml:1.2 --- phpdoc/en/reference/calendar/constants.xml:1.1 Fri Apr 19 09:49:59 2002 +++ phpdoc/en/reference/calendar/constants.xml Mon Jun 10 03:53:21 2002 @@ -1,5 +1,5 @@ - + &reftitle.constants; &extension.constants; @@ -150,6 +150,55 @@ CAL_MONTH_FRENCH +(integer) + + + + + + + + + + The following constants are available since PHP 4.3.0 : + + + + +CAL_EASTER_DEFAULT +(integer) + + + + + + + + + +CAL_EASTER_ROMAN +(integer) + + + + + + + + + +CAL_EASTER_ALWAYS_GREGORIAN +(integer) + + + + + + + + + +CAL_EASTER_ALWAYS_JULIAN (integer) Index: phpdoc/en/reference/calendar/functions/easter-date.xml diff -u phpdoc/en/reference/calendar/functions/easter-date.xml:1.2 phpdoc/en/reference/calendar/functions/easter-date.xml:1.3 --- phpdoc/en/reference/calendar/functions/easter-date.xml:1.2 Wed Apr 17 02:36:37 2002 +++ phpdoc/en/reference/calendar/functions/easter-date.xml Mon Jun 10 03:53:22 +2002 @@ -1,5 +1,5 @@ - + @@ -12,12 +12,16 @@ Description inteaster_date - intyear + intyear Returns the UNIX timestamp corresponding to midnight on Easter of - the given year. If no year is specified, the current year is - assumed. + the given year. + + + Since PHP 4.3.0, the year + parameter is optional and defaults to the current year according to the + localtime if ommited. Warning: This function will generate Index: phpdoc/en/reference/calendar/functions/easter-days.xml diff -u phpdoc/en/reference/calendar/functions/easter-days.xml:1.2 phpdoc/en/reference/calendar/functions/easter-days.xml:1.3 --- phpdoc/en/reference/calendar/functions/easter-days.xml:1.2 Wed Apr 17 02:36:37 2002 +++ phpdoc/en/reference/calendar/functions/easter-days.xml Mon Jun 10 03:53:22 +2002 @@ -1,5 +1,5 @@ - + @@ -13,12 +13,26 @@ Description inteaster_days - intyear + intyear + intmethod Returns the number of days after March 21 on which Easter falls - for a given year. If no year is specified, the current year is + for a given year. If no year is specified, the current year is assumed. + + + Since PHP 4.3.0, the year + parameter is optional and defaults to the current year according to the + localtime if ommited. + + + The method parameter was also introduced in + PHP 4.3.0 and allows to calculate easter dates based + on the Gregorian calendar during the years 1582 - 1752 when set to + CAL_EASTER_ROMAN. See the calendar constants for more valid + constants. This function can be used instead of
[PHP-DOC] cvs: phpdoc /en/reference/url/functions parse-url.xml
mfischerSun Jun 9 19:37:42 2002 EDT Modified files: /phpdoc/en/reference/url/functions parse-url.xml Log: - Document that parse_url does NOT validate the url in anyway, e.g. invalid hostnames containg _ are still parsed (closes #12706, #17533). Index: phpdoc/en/reference/url/functions/parse-url.xml diff -u phpdoc/en/reference/url/functions/parse-url.xml:1.3 phpdoc/en/reference/url/functions/parse-url.xml:1.4 --- phpdoc/en/reference/url/functions/parse-url.xml:1.3 Thu May 2 07:00:39 2002 +++ phpdoc/en/reference/url/functions/parse-url.xml Sun Jun 9 19:37:41 2002 @@ -1,5 +1,5 @@ - + @@ -58,6 +58,36 @@ + + This function is not meant to validate + the given URL, it only breaks it up into the above listed parts. Partial + urls are also accepted, parse_url tries its best to + parse them correctly. + + + Using parse_url + +$ php -r 'print_r( +parse_url("http://username:password@hostname/path?arg=value#anchor";));' +Array +( +[scheme] => http +[host] => hostname +[user] => username +[pass] => password +[path] => /path +[query] => arg=value +[fragment] => anchor +) + +$ php -r 'print_r( parse_url("http://invalid_host..name/";));' +Array +( +[scheme] => http +[host] => invalid_host..name +[path] => / +) + + See also pathinfo.
[PHP-DOC] cvs: phpdoc /en/language variables.xml
mfischerSun Jun 9 19:15:30 2002 EDT Modified files: /phpdoc/en/language variables.xml Log: - Document the behaviour of 'static' and 'global' when using references, closes $12454 (and probably a few others too). Index: phpdoc/en/language/variables.xml diff -u phpdoc/en/language/variables.xml:1.46 phpdoc/en/language/variables.xml:1.47 --- phpdoc/en/language/variables.xml:1.46 Mon Apr 29 04:41:49 2002 +++ phpdoc/en/language/variables.xmlSun Jun 9 19:15:26 2002 @@ -1,5 +1,5 @@ - + Variables @@ -452,6 +452,111 @@ ]]> + + +The Zend Engine 1, driving PHP4, implements the +static and global modifier for +variables in terms of references. For example, a true global variable +imported inside a function scope with the global +statement actually creates a reference to the global variable. This can +lead to unexpected behaviour which the following example addresses: + + + + + + + + + +Executing this example will result in the following output: + + + +NULL +object(stdClass)(0) { +} + + + +A similar behaviour applies to the static statement. +References are not stored statically: + + + + + + + + + +Executing this example will result in the following output: + + + +Static object: NULL +Static object: NULL + +Static object: NULL +Static object: object(stdClass)(1) { + ["property"]=> + int(1) +} + + + +This example demonstrates that when assigning a reference to a static +variable, it's not remembered when you call the +&get_instance_ref() function a second time. + +
[PHP-DOC] cvs: phpdoc /en/reference/imap reference.xml /en/reference/mysql reference.xml /en/reference/recode reference.xml
mfischerSun Jun 9 18:28:04 2002 EDT Modified files: /phpdoc/en/reference/imap reference.xml /phpdoc/en/reference/mysql reference.xml /phpdoc/en/reference/recode reference.xml Log: - Add important warning in which order to load the recode extension when PHP crashes, closes #12450. Index: phpdoc/en/reference/imap/reference.xml diff -u phpdoc/en/reference/imap/reference.xml:1.6 phpdoc/en/reference/imap/reference.xml:1.7 --- phpdoc/en/reference/imap/reference.xml:1.6 Sat Jun 1 12:31:22 2002 +++ phpdoc/en/reference/imap/reference.xml Sun Jun 9 18:28:04 2002 @@ -1,5 +1,5 @@ - + IMAP, POP3 and NNTP functions IMAP @@ -126,6 +126,14 @@ by David Wood and Managing IMAP by Dianna Mullet & Kevin Mullet. + + + Crashes and startup problems of PHP may be encountered + when loading this extension in conjunction with the recode extension. + See the recode extension for more + information. + + Index: phpdoc/en/reference/mysql/reference.xml diff -u phpdoc/en/reference/mysql/reference.xml:1.5 phpdoc/en/reference/mysql/reference.xml:1.6 --- phpdoc/en/reference/mysql/reference.xml:1.5 Sun Apr 21 07:20:46 2002 +++ phpdoc/en/reference/mysql/reference.xml Sun Jun 9 18:28:04 2002 @@ -1,5 +1,5 @@ - + MySQL Functions MySQL @@ -38,6 +38,14 @@ PHP to use the client libraries installed by MySQL, avoiding any conflicts. + + + Crashes and startup problems of PHP may be encountered + when loading this extension in conjunction with the recode extension. + See the recode extension for more + information. + + Index: phpdoc/en/reference/recode/reference.xml diff -u phpdoc/en/reference/recode/reference.xml:1.2 phpdoc/en/reference/recode/reference.xml:1.3 --- phpdoc/en/reference/recode/reference.xml:1.2Mon Apr 15 17:57:20 2002 +++ phpdoc/en/reference/recode/reference.xmlSun Jun 9 18:28:04 2002 @@ -1,5 +1,5 @@ - + GNU Recode functions Recode @@ -20,6 +20,19 @@ nearly 150 different character sets and is able to convert files between almost any pair. Most RFC 1345 character sets are supported. + + + Crashes and startup problems of PHP may be encountered + when loading the recode as extension after loading any extension of mysql or imap. Loading the recode before those + extension has proven to fix the problem. This is due a technical problem + that both the c-client library used by imap and recode have their own + hash_lookup() function and both mysql and recode have + their own hash_insert function. + + &reference.recode.functions;
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions fscanf.xml /en/reference/strings/functions sscanf.xml
mfischerSun Jun 9 17:50:25 2002 EDT Modified files: /phpdoc/en/reference/strings/functions sscanf.xml /phpdoc/en/reference/filesystem/functions fscanf.xml Log: - Document whitespace behaviour of the scanf functions, closes #12337. Index: phpdoc/en/reference/strings/functions/sscanf.xml diff -u phpdoc/en/reference/strings/functions/sscanf.xml:1.2 phpdoc/en/reference/strings/functions/sscanf.xml:1.3 --- phpdoc/en/reference/strings/functions/sscanf.xml:1.2Wed Apr 17 02:44:22 2002 +++ phpdoc/en/reference/strings/functions/sscanf.xmlSun Jun 9 17:50:17 2002 @@ -1,5 +1,5 @@ - + @@ -23,6 +23,13 @@ according to the specified format. If only two parameters were passed to this function, the values parsed will be returned as an array. + + + Any whitespace in the format string matches any whitespace in the input + string. This means that even a tab \n in the format string can match a + single space character in the input string. + + sscanf Example Index: phpdoc/en/reference/filesystem/functions/fscanf.xml diff -u phpdoc/en/reference/filesystem/functions/fscanf.xml:1.2 phpdoc/en/reference/filesystem/functions/fscanf.xml:1.3 --- phpdoc/en/reference/filesystem/functions/fscanf.xml:1.2 Wed Apr 17 02:38:08 2002 +++ phpdoc/en/reference/filesystem/functions/fscanf.xml Sun Jun 9 17:50:25 2002 @@ -1,5 +1,5 @@ - + @@ -24,6 +24,13 @@ Otherwise, if optional parameters are passed, the function will return the number of assigned values. The optional parameters must be passed by reference. + + + Any whitespace in the format string matches any whitespace in the input + stream. This means that even a tab \n in the format + string can match a single space character in the input stream. + + fscanf Example
[PHP-DOC] cvs: phpdoc /en/reference/errorfunc/functions set-error-handler.xml
mfischerSun Jun 9 17:24:21 2002 EDT Modified files: /phpdoc/en/reference/errorfunc/functionsset-error-handler.xml Log: - Document which error types can't be handled. Index: phpdoc/en/reference/errorfunc/functions/set-error-handler.xml diff -u phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.3 phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.4 --- phpdoc/en/reference/errorfunc/functions/set-error-handler.xml:1.3 Sun Apr 21 09:43:52 2002 +++ phpdoc/en/reference/errorfunc/functions/set-error-handler.xml Sun Jun 9 +17:24:20 2002 @@ -1,5 +1,5 @@ - + @@ -31,6 +31,15 @@ error occurred (an array that points to the active symbol table at the point the error occurred). + + + The following error types cannot be handled with a user defined + function: E_ERROR, E_PARSE, + E_CORE_ERROR, E_CORE_WARNING, + E_COMPILE_ERROR and + E_COMPILE_WARNING. + + The example below shows the handling of internal exceptions by triggering errors and handling them with a user
[PHP-DOC] cvs: phpdoc /en/language types.xml
mfischerSun Jun 9 15:52:00 2002 EDT Modified files: /phpdoc/en/language types.xml Log: - Explain more behaviours of using certain kind of keys for arrays. - Removed note about negative array keys. # Can someone explain me why there was an note about better not documented # negative array indices? Explain me what's wrong not documented it, if you've # good reason I will reconsider the removement. And the note was bogus too (IMHO). Index: phpdoc/en/language/types.xml diff -u phpdoc/en/language/types.xml:1.82 phpdoc/en/language/types.xml:1.83 --- phpdoc/en/language/types.xml:1.82 Sun May 26 11:50:03 2002 +++ phpdoc/en/language/types.xmlSun Jun 9 15:52:00 2002 @@ -1,5 +1,5 @@ - + Types @@ -1075,40 +1075,38 @@ pairs. - A key is either a nonnegative integer - + A key is either an integer or a string. - If a key is the standard representation of a non-negative + If a key is the standard representation of an integer, it will - be interpreted as such (i.e. '8' will be interpreted + be interpreted as such (i.e. "8" will be interpreted as 8, while - '08' will be interpreted as '08'). + "08" will be interpreted as "08"). A value can be anything. If you omit a key, the maximum of the integer-indices is taken, and - the new key will be that maximum + 1. If no integer-indices exist + the new key will be that maximum + 1. As integers can be negative, + this is also true for negative indices. Having e.g. the highest index + being -6 will result in being -5 + the new key. If no integer-indices exist yet, the key will be 0 (zero). If you specify a key that already has a value assigned to it, that value will be overwritten. + + + Using true as a key will evalute to + integer 1 as key. Using + false as a key will evalute to integer + 0 as key. Using NULL as a key + will evalute to an empty string. Using an emptry string as key will + create (or overwrite) a key with an empty string and its value, it is + not the same as using empty brackets. + + + You cannot use arrays or objects as keys. Doing so will result in a + warning: Illegal offset type.
[PHP-DOC] cvs: phpdoc /en/reference/info/functions ini-set.xml /en/reference/mail reference.xml
mfischerSat Jun 8 11:31:23 2002 EDT Modified files: /phpdoc/en/reference/info/functions ini-set.xml /phpdoc/en/reference/mail reference.xml Log: - Document "smtp_port" ini setting for win32. # Can someone test mail/reference.xml ? Somehow I was unable to configure my # phpdoc to process it (mestupidtoday) Index: phpdoc/en/reference/info/functions/ini-set.xml diff -u phpdoc/en/reference/info/functions/ini-set.xml:1.6 phpdoc/en/reference/info/functions/ini-set.xml:1.7 --- phpdoc/en/reference/info/functions/ini-set.xml:1.6 Sun May 19 12:14:23 2002 +++ phpdoc/en/reference/info/functions/ini-set.xml Sat Jun 8 11:31:22 2002 @@ -1,5 +1,5 @@ - + @@ -1125,6 +1125,11 @@ SMTP "localhost" + PHP_INI_ALL + + + smtp_port + 25 PHP_INI_ALL Index: phpdoc/en/reference/mail/reference.xml diff -u phpdoc/en/reference/mail/reference.xml:1.3 phpdoc/en/reference/mail/reference.xml:1.4 --- phpdoc/en/reference/mail/reference.xml:1.3 Sun May 26 22:09:00 2002 +++ phpdoc/en/reference/mail/reference.xml Sat Jun 8 11:31:23 2002 @@ -1,5 +1,5 @@ - + Mail functions Mail @@ -18,9 +18,23 @@ - DNS name or IP address of the SMTP server PHP under Windows - should use for mail sent with the mail - function. + Used under Windws only: DNS name or IP address of the SMTP server PHP + should use for mail sent with the mail function. + + + + + + + SMTP + int + + + + Used under Windws only: Number of the port to connect to the server + specified with the SMTP setting when sending mail + with mail; defaults to 25. Only available since + PHP 4.3.0.
[PHP-DOC] cvs: phpdoc /en/reference/array/functions list.xml
mfischerSat Jun 8 11:11:31 2002 EDT Modified files: /phpdoc/en/reference/array/functionslist.xml Log: - Document list() specific behaviour of the order of assigning the values to the variables. Index: phpdoc/en/reference/array/functions/list.xml diff -u phpdoc/en/reference/array/functions/list.xml:1.4 phpdoc/en/reference/array/functions/list.xml:1.5 --- phpdoc/en/reference/array/functions/list.xml:1.4Sun May 12 04:19:28 2002 +++ phpdoc/en/reference/array/functions/list.xmlSat Jun 8 11:11:31 2002 @@ -1,5 +1,5 @@ - + @@ -78,6 +78,44 @@ ]]> + + + + list assigns the values starting with the right-most + parameter. If you are using plain variables, you don't have to worry + about this. But if you are using arrays with indices you usually expect + the order of the indices in the array the same you wrote in the + list from left to write; which it isn't. It's + assigned in the reverse order. + + + + + Using list with array indices + + + + + Gives the following output (note the order of the elements compared in + which order they were written in the list syntax): + +array(3) { + [2]=> + string(8) "caffeine" + [1]=> + string(5) "brown" + [0]=> + string(6) "coffee" +} + See also each, array
Re: [PHP-DOC] Notes Status, 6111 total
Is there a page showing all doc pages and their notes count? - Markus On Sat, Jun 08, 2002 at 01:09:01PM -, [EMAIL PROTECTED] wrote : > Following are the top 20 pages of the manual, sorted by the number > of user notes contributed. These sections could use a polish, those > notes represent 14.2% of the 6111 total user notes. > > Notes | Page > ---+- > 103 | http://php.net/manual/en/function.setcookie.php >90 | http://php.net/manual/en/ref.session.php >52 | http://php.net/manual/en/language.oop.php >46 | http://php.net/manual/en/function.preg-replace.php >43 | http://php.net/manual/en/ref.imap.php >43 | http://php.net/manual/en/function.include.php >43 | http://php.net/manual/en/ref.pdf.php >43 | http://php.net/manual/en/ref.datetime.php >42 | http://php.net/manual/en/function.mail.php >40 | http://php.net/manual/en/ref.image.php >39 | http://php.net/manual/en/features.file-upload.php >37 | http://php.net/manual/en/function.exec.php >37 | http://php.net/manual/en/function.fopen.php >33 | http://php.net/manual/en/language.variables.predefined.php >31 | http://php.net/manual/en/ref.oci8.php >30 | http://php.net/manual/en/ref.domxml.php >30 | http://php.net/manual/en/function.odbc-connect.php >30 | http://php.net/manual/en/function.str-replace.php >29 | http://php.net/manual/en/function.mssql-connect.php >28 | http://php.net/manual/en/function.date.php -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc
[PHP-DOC] cvs: phpdoc /en/features commandline.xml
mfischerThu Jun 6 14:36:45 2002 EDT Modified files: /phpdoc/en/features commandline.xml Log: - Sync with latest commits to php_cgi.c . Index: phpdoc/en/features/commandline.xml diff -u phpdoc/en/features/commandline.xml:1.5 phpdoc/en/features/commandline.xml:1.6 --- phpdoc/en/features/commandline.xml:1.5 Thu May 16 16:52:38 2002 +++ phpdoc/en/features/commandline.xml Thu Jun 6 14:36:45 2002 @@ -1,5 +1,5 @@ - + Using PHP from the command line @@ -109,6 +109,65 @@ e.g. register_argc_argv). + + + + The ease the operating in the shell environment, the following constants + are defined: + + CLI specific Constants + + + + Constant + Description + + + + + STDIN + + An already opened stream to stdin. This saves + opening it with + +$stdin = fopen('php://stdin', 'r'); + + + + + STDOUT + + An already opened stream to stdout. This saves + opening it with + +$stdout = fopen('php://stdout', 'w'); + + + + + STDERR + + An already opened stream to stdout. This saves + opening it with + +$stderr = fopen('php://stderr', 'w'); + + + + + + + + + Given the above, you don't need to open e.g. a stream for + stderr yourself but simply use the constant instead of + the stream resource: + +php -r 'fwrite(STDERR, "stderr\n");' + + You do not need to explicitely close these streams, this is automatically + done by PHP. +
[PHP-DOC] cvs: phpdoc /en/reference/sockets/functions socket-select.xml
mfischerSat Jun 1 23:51:10 2002 EDT Modified files: /phpdoc/en/reference/sockets/functions socket-select.xml Log: - Warn abuot the no-so-intuitive behaviour of socket_select(). Index: phpdoc/en/reference/sockets/functions/socket-select.xml diff -u phpdoc/en/reference/sockets/functions/socket-select.xml:1.6 phpdoc/en/reference/sockets/functions/socket-select.xml:1.7 --- phpdoc/en/reference/sockets/functions/socket-select.xml:1.6 Fri May 10 03:57:20 2002 +++ phpdoc/en/reference/sockets/functions/socket-select.xml Sat Jun 1 23:51:10 +2002 @@ -1,5 +1,5 @@ - + @@ -39,10 +39,12 @@ The sockets listed in the except array will be watched for exceptions. - - On exit, the arrays are modified to indicate which socket resource - actually changed status. - + + + On exit, the arrays are modified to indicate which socket resource + actually changed status. + + You do not need to pass every array to socket_select. You can leave it out and use an
Re: [PHP-DOC] Re: Help - Problems generating the manual - missing
Hi guys, sorry, but no clue at all here :-/ -- GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc Wishlist: http://guru.josefine.at/~mfischer/wishlist
[PHP-DOC] cvs: phpdoc /en/reference/session/functions session-id.xml
mfischerThu May 30 07:59:16 2002 EDT Modified files: /phpdoc/en/reference/session/functions session-id.xml Log: - Add note about file session handlers and allowed characters. Index: phpdoc/en/reference/session/functions/session-id.xml diff -u phpdoc/en/reference/session/functions/session-id.xml:1.2 phpdoc/en/reference/session/functions/session-id.xml:1.3 --- phpdoc/en/reference/session/functions/session-id.xml:1.2Wed Apr 17 02:43:58 2002 +++ phpdoc/en/reference/session/functions/session-id.xmlThu May 30 07:59:16 +2002 @@ -1,5 +1,5 @@ - + @@ -14,13 +14,25 @@ session_id returns the session id for the - current session. If id is specified, it - will replace the current session id. + current session. + + + If id is specified, it will replace the current + session id. session_id needs to be called before + session_start for that purpose. Depending on the + session handler, not all characters are allowed within the session id. + For example, the file session handler only allows characters in the range + a-z, A-Z and 0-9! The constant SID can also be used to retrieve the current name and session id as a string suitable for - adding to URLs. + adding to URLs. Note that SID is only defined if + the client didn't sent the right cookie. See also Session handling. + + + See also session_start.
[PHP-DOC] cvs: phpdoc /en/reference/pcre/functions preg-split.xml
mfischerThu May 23 15:34:18 2002 EDT Modified files: /phpdoc/en/reference/pcre/functions preg-split.xml Log: - Document the new PREG_SPLIT_OFFSET_CAPTURE flag. Index: phpdoc/en/reference/pcre/functions/preg-split.xml diff -u phpdoc/en/reference/pcre/functions/preg-split.xml:1.2 phpdoc/en/reference/pcre/functions/preg-split.xml:1.3 --- phpdoc/en/reference/pcre/functions/preg-split.xml:1.2 Wed Apr 17 02:42:49 2002 +++ phpdoc/en/reference/pcre/functions/preg-split.xml Thu May 23 15:34:18 2002 @@ -1,5 +1,5 @@ - + @@ -57,6 +57,19 @@ + +PREG_SPLIT_OFFSET_CAPTURE + + + If this flag is set, for every occuring match the appendant string + offset will also be returned. Note that this changes the return + value in an array where very element is an array consisting of the + matched string at offset 0 and it's string offset + into subject at offset 1. + This flag is available since 4.3.0. + + + @@ -81,6 +94,46 @@ print_r($chars); ]]> + + + + + Splitting a string into matches and their offsets. + + + + + will yield + + + +
Re: [PHP-DOC] Question
On Wed, May 22, 2002 at 09:53:59PM -0400, Derek Organ wrote : > PHP is working fine, but it seems i have to enable sockets if I want to > do stuff with sockets. > > I installed all the php rpms I have and I can't get it to work with > socket support or java. > What do I do if I want to enable socket support, or add any extension > for that matter eg php with java support,...? You ask this question on php-general@ or [EMAIL PROTECTED] - Markus -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc - "I mean "When in doubt, blame mcrypt" is more often right than wrong :)" "Always right, never wrong :)" - Two PHP developers who want to remain unnamed
[PHP-DOC] cvs: phpdoc /en/reference/apache/functions virtual.xml
mfischerMon May 20 14:56:47 2002 EDT Modified files: /phpdoc/en/reference/apache/functions virtual.xml Log: - Document implementation of virtual() Index: phpdoc/en/reference/apache/functions/virtual.xml diff -u phpdoc/en/reference/apache/functions/virtual.xml:1.2 phpdoc/en/reference/apache/functions/virtual.xml:1.3 --- phpdoc/en/reference/apache/functions/virtual.xml:1.2Wed Apr 17 02:36:20 2002 +++ phpdoc/en/reference/apache/functions/virtual.xmlMon May 20 14:56:47 2002 @@ -1,5 +1,5 @@ - + @@ -23,6 +23,10 @@ use include or require; virtual cannot be used to include a document which is itself a PHP file. + + + To run the sub-request, all buffers are terminated and flushed to the + browser, pending headers are sent too.
[PHP-DOC] cvs: phpdoc /en/chapters config.xml /en/features safe-mode.xml
mfischerMon May 20 12:38:40 2002 EDT Modified files: /phpdoc/en/features safe-mode.xml /phpdoc/en/chapters config.xml Log: - Add documentation for safe_mode_gid and safe_mode_include_dir (closes #16691). Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.24 phpdoc/en/features/safe-mode.xml:1.25 --- phpdoc/en/features/safe-mode.xml:1.24 Sat May 11 16:29:49 2002 +++ phpdoc/en/features/safe-mode.xmlMon May 20 12:38:35 2002 @@ -1,5 +1,5 @@ - + Safe Mode @@ -11,19 +11,67 @@ especially ISP's, use safe mode for now. - The configuration directives that control safe mode are: - - - + +Configuration directives controlling safe mode are: + + + + Directive + Default value + + + + + +safe_mode + + Off + + + +safe_mode_gid + + 0 + + + +safe_mode_include_dir + + "" + + + +safe_mode_exec_dir + + 1 + + + +open_basedir + + "" + + + +safe_mode_allowed_env_vars + + PHP_ + + + +safe_mode_protected_env_vars + + LD_LIBRARY_PATH + + + +disable_functions + + "" + + + + When safe_mode is on, PHP checks to see @@ -50,6 +98,15 @@ allowed to access /etc/passwd owned by uid 0 in /docroot/script.php on line 2 ]]> + + + However, there may be environments where a strict UID + check is not appropriate and a relaxed GID check is + sufficient. This is supported by means of the safe_mode_gid switch. Setting it to + On performs the relaxed GID checking, + setting it to Off (the default) performs + UID checking. If instead of safe_mode, you set an Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.52 phpdoc/en/chapters/config.xml:1.53 --- phpdoc/en/chapters/config.xml:1.52 Fri May 10 09:26:33 2002 +++ phpdoc/en/chapters/config.xml Mon May 20 12:38:40 2002 @@ -1,5 +1,5 @@ - + Configuration @@ -845,6 +845,21 @@ + + + safe_mode_gid + boolean + + + +Whether to use UID (Off) or +GID (On) checking upon file +access. See Safe Mode for +more information. + + + + safe_mode_exec_dir @@ -855,6 +870,21 @@ If PHP is used in safe mode, system and the other functions executing system programs refuse to start programs that are not in this directory. + + + + + + safe_mode_include_dir + string + + + +UID/GID checks are bypassed when +including files from this directory and its subdirectories (directory +must also be in include_path +or full path must including). +
Re: [PHP-DOC] cvs: phpdoc /en/reference/info/functions ini-set.xml
On Sun, May 19, 2002 at 04:14:24PM -, Gabor Hojtsy wrote : > goba Sun May 19 12:14:24 2002 EDT > > Modified files: > /phpdoc/en/reference/info/functions ini-set.xml > Log: > Guys why don't think about XML special chars? Because it builds fine without it ? - Markus -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc - "I mean "When in doubt, blame mcrypt" is more often right than wrong :)" "Always right, never wrong :)" - Two PHP developers who want to remain unnamed
[PHP-DOC] cvs: phpdoc /en/reference/mail/functions mail.xml
mfischerSun May 19 12:12:35 2002 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: - Correct another '>' Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.7 phpdoc/en/reference/mail/functions/mail.xml:1.8 --- phpdoc/en/reference/mail/functions/mail.xml:1.7 Sun May 19 12:11:10 2002 +++ phpdoc/en/reference/mail/functions/mail.xml Sun May 19 12:12:35 2002 @@ -1,5 +1,5 @@ - + @@ -53,7 +53,7 @@ role="strong">not interpreted by the MTA in the first place, but are parsed by PHP. PHP < 4.3 only supported the Cc: - header element (and was case-sensitive). PHP >= 4.3 + header element (and was case-sensitive). PHP >= 4.3 supports all the mentioned header elements and is no longer case-sensitive.
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions glob.xml
mfischerSun May 19 12:10:05 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions glob.xml Log: - Remove para about not available on Windows platform. # If thinks would just happenalways that fast, Kudos Edin! Index: phpdoc/en/reference/filesystem/functions/glob.xml diff -u phpdoc/en/reference/filesystem/functions/glob.xml:1.2 phpdoc/en/reference/filesystem/functions/glob.xml:1.3 --- phpdoc/en/reference/filesystem/functions/glob.xml:1.2 Sat May 18 14:47:44 2002 +++ phpdoc/en/reference/filesystem/functions/glob.xml Sun May 19 12:10:02 2002 @@ -1,5 +1,5 @@ - + glob @@ -28,11 +28,6 @@ return &false; in safe mode. - - - This function is not available on the Windows platform. - - Convenient way how glob can replace
[PHP-DOC] cvs: phpdoc /en/reference/posix reference.xml
mfischerSun May 19 03:52:59 2002 EDT Modified files: /phpdoc/en/reference/posix reference.xml Log: - Posix extension should not really be used in environment where security matters. Also add note it's not availabvle on win32. # This renders all open posix reports about safe_mode obsolete. Index: phpdoc/en/reference/posix/reference.xml diff -u phpdoc/en/reference/posix/reference.xml:1.2 phpdoc/en/reference/posix/reference.xml:1.3 --- phpdoc/en/reference/posix/reference.xml:1.2 Mon Apr 15 17:57:17 2002 +++ phpdoc/en/reference/posix/reference.xml Sun May 19 03:52:59 2002 @@ -1,5 +1,5 @@ - + POSIX functions POSIX @@ -15,6 +15,25 @@ and this module tries to remedy this by providing easy access to these functions. + + + Sensitive data can be retrieved with the POSIX functions, e.g. + posix_getpwnam and friends. None of the POSIX function perform any kind of access + checking when safe mode is enabled. + It's therefore strongly advised to + disable the POSIX extension at all (use + --disable-posix in your configure line) if you're + operating in such an environment. + + + + + The POSIX extension is not available on the Windows platform. + + &reference.posix.functions;
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions glob.xml
mfischerSat May 18 14:47:50 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions glob.xml Log: - A bit more verobse on the safe mode thing. Index: phpdoc/en/reference/filesystem/functions/glob.xml diff -u phpdoc/en/reference/filesystem/functions/glob.xml:1.1 phpdoc/en/reference/filesystem/functions/glob.xml:1.2 --- phpdoc/en/reference/filesystem/functions/glob.xml:1.1 Sat May 18 10:08:25 2002 +++ phpdoc/en/reference/filesystem/functions/glob.xml Sat May 18 14:47:44 2002 @@ -1,5 +1,5 @@ - + glob @@ -24,7 +24,8 @@ This function is disabled in safe mode. + linkend="ini.safe-mode">safe mode and therefore will always + return &false; in safe mode.
[PHP-DOC] cvs: phpdoc /en/reference/filesystem functions.xml /en/reference/filesystem/functions glob.xml
mfischerSat May 18 10:08:25 2002 EDT Added files: /phpdoc/en/reference/filesystem/functions glob.xml Modified files: /phpdoc/en/reference/filesystem functions.xml Log: - Preliminary documentation for glob(). # Far from finished, volunteers are welcome: # - Document tll he flags # - Give more examples # - Describe what the patterns are really Index: phpdoc/en/reference/filesystem/functions.xml diff -u phpdoc/en/reference/filesystem/functions.xml:1.1 phpdoc/en/reference/filesystem/functions.xml:1.2 --- phpdoc/en/reference/filesystem/functions.xml:1.1Sun Apr 14 20:00:43 2002 +++ phpdoc/en/reference/filesystem/functions.xmlSat May 18 10:08:25 2002 @@ -41,6 +41,7 @@ &reference.filesystem.functions.ftell; &reference.filesystem.functions.ftruncate; &reference.filesystem.functions.fwrite; +&reference.filesystem.functions.glob; &reference.filesystem.functions.is-dir; &reference.filesystem.functions.is-executable; &reference.filesystem.functions.is-file; Index: phpdoc/en/reference/filesystem/functions/glob.xml +++ phpdoc/en/reference/filesystem/functions/glob.xml glob Find pathnames matching a pattern Description arrayglob stringpattern intflags The glob function searches for all the pathnames matching pattern according to the rules used by the shell. No tilde expansion or parameter substitution is done. Returns an array containing the matched files/directories or &false; on error. This function is disabled in safe mode. This function is not available on the Windows platform. Convenient way how glob can replace opendir and friends. This could result in the following output: funclist.txt size 44686 funcsummary.txt size 267625 quickref.txt size 137820 See also opendir, readdir and closedir.
[PHP-DOC] cvs: phpdoc /en/reference/mail/functions mail.xml
mfischerSat May 18 07:04:04 2002 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: - Document latest Win32 mail() changes. Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.4 phpdoc/en/reference/mail/functions/mail.xml:1.5 --- phpdoc/en/reference/mail/functions/mail.xml:1.4 Wed May 15 14:11:21 2002 +++ phpdoc/en/reference/mail/functions/mail.xml Sat May 18 07:04:04 2002 @@ -1,5 +1,5 @@ - + @@ -41,6 +41,23 @@ mail returns &true; if the mail was successfully accepted for delivery, &false; otherwise. + + + The Windows implementation of mail differs in many + ways from the Unix implementation. First, it doesn't use a local binary + for composing messages but only operates on direct sockets which means a + MTA is needed listening on a network socket (which + can either on the localhost or a remote machine). Second, the custom + headers like From:, Cc:, + Bcc: and Date: are not interpreted by the MTA + in the first place, but are parsed by PHP. + PHP < 4.3 only supported the Cc: + header element (and was case-sensitive). PHP >= 4.3 + supports all the mentioned header element and is no longer + case-sensitive. + + Sending mail. @@ -61,9 +78,7 @@ You must use \r\n to seperate headers, although some Unix mail transfer agents may work with just a single newline - (\n). The Cc: header is case sensitive and must - be written as Cc: on Win32 systems. The Bcc: - header is also not supported on Win32 systems. + (\n).
[PHP-DOC] cvs: phpdoc /en/reference/array/functions array-merge.xml
mfischerSat May 18 05:55:41 2002 EDT Modified files: /phpdoc/en/reference/array/functionsarray-merge.xml Log: - More outlining that numeric keys are preservered. Index: phpdoc/en/reference/array/functions/array-merge.xml diff -u phpdoc/en/reference/array/functions/array-merge.xml:1.4 phpdoc/en/reference/array/functions/array-merge.xml:1.5 --- phpdoc/en/reference/array/functions/array-merge.xml:1.4 Sun May 12 04:19:28 2002 +++ phpdoc/en/reference/array/functions/array-merge.xml Sat May 18 05:55:41 2002 @@ -1,5 +1,5 @@ - + @@ -20,10 +20,11 @@ the end of the previous one. It returns the resulting array. - If the input arrays have the same string keys, then the later - value for that key will overwrite the previous one. If, however, - the arrays have the same numeric key, the later value will not - overwrite the original value, but will be appended. + If the input arrays have the same string keys, then the later value for + that key will overwrite the previous one. If, however, the arrays + contain numeric keys, the later value will not overwrite the original value, but will be + appended. @@ -48,6 +49,49 @@ [3] => b [shape] => trapezoid [4] => 4 +) +]]> + + + + + + + Simple array_merge example + + + + + Don't forget that numeric keys will be renumbered! + + + + + + If you want to completely preserve the arrays and just want to append + them to each other, use the + operator: + + + + The numeric key will be preserved and thus the association remains. + +
[PHP-DOC] cvs: phpdoc /en/reference/mail/functions mail.xml
mfischerWed May 15 14:11:23 2002 EDT Modified files: /phpdoc/en/reference/mail/functions mail.xml Log: - Rephrase text for return value. Index: phpdoc/en/reference/mail/functions/mail.xml diff -u phpdoc/en/reference/mail/functions/mail.xml:1.3 phpdoc/en/reference/mail/functions/mail.xml:1.4 --- phpdoc/en/reference/mail/functions/mail.xml:1.3 Sun May 5 10:11:47 2002 +++ phpdoc/en/reference/mail/functions/mail.xml Wed May 15 14:11:21 2002 @@ -1,5 +1,5 @@ - + @@ -38,8 +38,8 @@ RFC 2049. - mail returns &true; if the mail - is successfully sent, &false; otherwise. + mail returns &true; if the mail was successfully + accepted for delivery, &false; otherwise.
[PHP-DOC] cvs: phpdoc /en/features commandline.xml
mfischerTue May 14 05:06:28 2002 EDT Modified files: /phpdoc/en/features commandline.xml Log: - Minor improvements. Index: phpdoc/en/features/commandline.xml diff -u phpdoc/en/features/commandline.xml:1.3 phpdoc/en/features/commandline.xml:1.4 --- phpdoc/en/features/commandline.xml:1.3 Fri May 10 18:08:56 2002 +++ phpdoc/en/features/commandline.xml Tue May 14 05:06:23 2002 @@ -1,5 +1,5 @@ - + Using PHP from the command line @@ -68,7 +68,9 @@ It is desired that any output coming from print, echo and friends is - immidiately written to the output and not cached in any buffer. + immidiately written to the output and not cached in any buffer. You + still can use output buffering + if you want to defer or manipulate standard output. @@ -131,6 +133,7 @@ @@ -144,6 +147,7 @@ @@ -273,11 +277,11 @@ As long as the arguments you want to pass to your script do not start with the - character, there's nothing special to watch out for. Passing an argument to your script which starts with a - - will cause trouble because PHP - thinks it has to handle it. To prevent this use the argument list separator - --. After the argument has been parsed by - PHP, every argument following it is passed - untoched/unparsed to your script. + - will cause trouble because PHP + itself thinks it has to handle it. To prevent this use the argument list + separator --. After the argument has been parsed by + PHP, every argument following it is passed + untoched/unparsed to your script. @@ -412,7 +416,7 @@ &php.ini; or you can specify a custom INI file directly (which does not need to be named &php.ini;), e.g.: -
Re: [PHP-DOC] Addition request to documentation of cli (http://www.php.net/manual/en/features.commandline.php)
Hi, all I can say: you're welcome to contribute and you've some expirience in any parts there. I admit a dedicated CGI page might be a good idea. Yet someone has to take the time and write it down. Not me this time ;-) - Markus On Tue, May 14, 2002 at 09:43:13AM +0200, Jochen Riehm wrote : > Dear PHP-Documentors, > > I came across the above mentioned page and I am missing on information in the > doc: > > if the cli interface is generated, what about the cgi interface? Will it be > generated too, is it not available anymore or can you choose and if so how? > If they can be generated both at the same time, how can I distinguish between > the two since they will probably both be called php or php.exe? > > I would very much appreciate it if you could add that information to the > documentation. > > Yours sincerely > > Jochen Riehm > -- > Jochen Riehm > DBRent GmbH > [EMAIL PROTECTED] -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc - "I mean "When in doubt, blame mcrypt" is more often right than wrong :)" "Always right, never wrong :)" - Two PHP developers who want to remain unnamed
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions show-source.xml
mfischerMon May 13 17:12:45 2002 EDT Modified files: /phpdoc/en/reference/misc/functions show-source.xml Log: - Remove documentation, everything is in highlight_file, no need to document thigns twice but still leave the entry because it's very popular. Index: phpdoc/en/reference/misc/functions/show-source.xml diff -u phpdoc/en/reference/misc/functions/show-source.xml:1.2 phpdoc/en/reference/misc/functions/show-source.xml:1.3 --- phpdoc/en/reference/misc/functions/show-source.xml:1.2 Wed Apr 17 02:40:43 2002 +++ phpdoc/en/reference/misc/functions/show-source.xml Mon May 13 17:12:45 2002 @@ -1,5 +1,5 @@ - + @@ -15,39 +15,11 @@ choice="opt">boolreturn - The show_source function prints out a syntax - higlighted version of the code contained in filename - using the colors defined in the built-in syntax highlighter for PHP. + This function is an alias highlight_file. For more + informatin see the documentation there. - If the second parameter return is set to &true; - then show_source will return the highlighted - code as a string instead of printing it out. If the second parameter is - not set to &true; then show_source will - return &true; on success, &false; on failure. - - - - The return parameter became available in PHP - 4.2.0. Before this time it behaved like the default, which is &false; - - - - This function is an alias for the function - highlight_file - - - - Care should be taken when using the - show_source and - highlight_file functions to make sure that - you do not inadvertently reveal sensitive information such as - passwords or any other type of information that might create a - potential security risk. - - - - See also highlight_string, + See also highlight_string and highlight_file.
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions touch.xml
mfischerMon May 13 14:39:49 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions touch.xml Log: - Document third parameter Index: phpdoc/en/reference/filesystem/functions/touch.xml diff -u phpdoc/en/reference/filesystem/functions/touch.xml:1.2 phpdoc/en/reference/filesystem/functions/touch.xml:1.3 --- phpdoc/en/reference/filesystem/functions/touch.xml:1.2 Wed Apr 17 02:38:10 2002 +++ phpdoc/en/reference/filesystem/functions/touch.xml Mon May 13 14:39:48 2002 @@ -1,5 +1,5 @@ - + @@ -12,12 +12,15 @@ inttouch stringfilename inttime + intatime Attempts to set the access and modification time of the file named by filename to the value given by time. If the option time is not given, uses the present time. This is equivalent to what utime - (sometimes referred to as utimes) does. + (sometimes referred to as utimes) does. If the third option + atime is present, the access time of the given + filename is also modified. If the file does not exist, it is created.
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions rename.xml
mfischerSun May 12 13:28:59 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions rename.xml Log: - Fix return value. Index: phpdoc/en/reference/filesystem/functions/rename.xml diff -u phpdoc/en/reference/filesystem/functions/rename.xml:1.2 phpdoc/en/reference/filesystem/functions/rename.xml:1.3 --- phpdoc/en/reference/filesystem/functions/rename.xml:1.2 Wed Apr 17 02:38:10 2002 +++ phpdoc/en/reference/filesystem/functions/rename.xml Sun May 12 13:28:59 2002 @@ -1,5 +1,5 @@ - + @@ -9,7 +9,7 @@ Description - intrename + boolrename stringoldname stringnewname
Re: [PHP-DOC] cvs: phpdoc /en/reference/array
Hi, ignore it, I see you fixed it already ;-) - Markus On Sun, May 12, 2002 at 10:22:46AM +0200, Markus Fischer wrote : > Hi, > > is it just me or does this look like you commited a > translation to the en branch ?! > > - Markus > > On Sun, May 12, 2002 at 08:10:35AM -, Adrian Jurjica wrote : > > adiju Sun May 12 04:10:35 2002 EDT > > > > Modified files: > > /phpdoc/en/reference/array reference.xml > > /phpdoc/en/reference/array/functionsarray-change-key-case.xml > [...] > > Log: > > Translation of array functions. -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
Re: [PHP-DOC] cvs: phpdoc /en/reference/array
Hi, is it just me or does this look like you commited a translation to the en branch ?! - Markus On Sun, May 12, 2002 at 08:10:35AM -, Adrian Jurjica wrote : > adiju Sun May 12 04:10:35 2002 EDT > > Modified files: > /phpdoc/en/reference/arrayreference.xml > /phpdoc/en/reference/array/functions array-change-key-case.xml [...] > Log: > Translation of array functions.
[PHP-DOC] cvs: phpdoc /en/features safe-mode.xml
mfischerSat May 11 16:25:39 2002 EDT Modified files: /phpdoc/en/features safe-mode.xml Log: - Sync. Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.22 phpdoc/en/features/safe-mode.xml:1.23 --- phpdoc/en/features/safe-mode.xml:1.22 Sat May 11 16:05:44 2002 +++ phpdoc/en/features/safe-mode.xmlSat May 11 16:25:38 2002 @@ -1,5 +1,5 @@ - + Safe Mode @@ -276,6 +276,14 @@ highlight_file, show_source + + + &sm.uidcheck; &sm.uidcheck.dir; (note: only affected since PHP 4.2.1) + + + + + parse_ini_file &sm.uidcheck; &sm.uidcheck.dir; (note: only affected since PHP 4.2.1)
[PHP-DOC] cvs: phpdoc /en/reference/filesystem/functions parse-ini-file.xml
mfischerSat May 11 16:24:52 2002 EDT Modified files: /phpdoc/en/reference/filesystem/functions parse-ini-file.xml Log: - Update. # Go Rasmus go :-) Index: phpdoc/en/reference/filesystem/functions/parse-ini-file.xml diff -u phpdoc/en/reference/filesystem/functions/parse-ini-file.xml:1.3 phpdoc/en/reference/filesystem/functions/parse-ini-file.xml:1.4 --- phpdoc/en/reference/filesystem/functions/parse-ini-file.xml:1.3 Mon Apr 29 04:09:01 2002 +++ phpdoc/en/reference/filesystem/functions/parse-ini-file.xml Sat May 11 16:24:52 +2002 @@ -1,5 +1,5 @@ - + @@ -29,6 +29,13 @@ the time you run your script. This function can be used to read in your own application's configuration files. + + + + Since PHP 4.2.1 this function is also affected by safe_mode and open_basedir. + The structure of the ini file is similar to that of
[PHP-DOC] cvs: phpdoc /en/features safe-mode.xml
mfischerSat May 11 16:05:44 2002 EDT Modified files: /phpdoc/en/features safe-mode.xml Log: - Sync functions. Index: phpdoc/en/features/safe-mode.xml diff -u phpdoc/en/features/safe-mode.xml:1.21 phpdoc/en/features/safe-mode.xml:1.22 --- phpdoc/en/features/safe-mode.xml:1.21 Fri Mar 29 11:13:54 2002 +++ phpdoc/en/features/safe-mode.xmlSat May 11 16:05:44 2002 @@ -1,5 +1,5 @@ - + Safe Mode @@ -271,6 +271,15 @@ (case-insensitive) will not be returned. Warning: this is broken with the aol-server implementation of getallheaders! + + + + highlight_file, + show_source + + + &sm.uidcheck; &sm.uidcheck.dir; (note: only affected since PHP 4.2.1) + Any function that uses
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
mfischerSat May 11 16:05:24 2002 EDT Modified files: /phpdoc/en/reference/misc/functions highlight-file.xml Log: - Don't forget to mention open_basedir restriction. Index: phpdoc/en/reference/misc/functions/highlight-file.xml diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 phpdoc/en/reference/misc/functions/highlight-file.xml:1.4 --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 Sat May 11 14:51:44 2002 +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 16:05:23 +2002 @@ -1,5 +1,5 @@ - + @@ -45,8 +45,8 @@ Since PHP 4.2.1 this function is also affected by safe mode, i.e. only files which pass the - safe mode restriction are shown. + linkend="ini.safe-mode">safe_mode and open_basedir.
Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
Hi, My point still is that this is a change in behaviour. fopen() and readfile() didn't had such a change lately, they were affected by safe_mode since a long time if not since the beginning. And yes, if function which in the past were not affected by safe_mode/open_basedir suddenly are, I am for documenting this change. - Markus On Sat, May 11, 2002 at 12:20:20PM -0700, Rasmus Lerdorf wrote : > Well, the harm is that I don't see such noted on fopen(), readfile(), > include, etc. If you start putting them in for other functions won't > people then naturally assume that these other functions are not subject to > safe-mode/open_basedir restrictions? > > On Sat, 11 May 2002, Markus Fischer wrote: > > > Hi, > > > > there are reports about this (don't know their # though). > > > > Am I the only who thinks that documenting such a change of > > the behaviour of a function is important? > > > > And if it's like you said, then it just is that way. Nothing > > is more painful for a user to find out a function now behaves > > differently without a note why and since when. There's no > > harm done, I only can see a benefit. > > > > - Markus > > > > On Sat, May 11, 2002 at 12:04:51PM -0700, Rasmus Lerdorf wrote : > > > If such functions exist, then they need to be fixed. If you find some, > > > submit a bug report. It's like documenting for each and every function > > > whether it works or not. Yes, there are bugs in some functions, that > > > doesn't mean that in every working function we put a note that says, "Hey, > > > this function actually works". > > > > > > -Rasmus > > > > > > On Sat, 11 May 2002, Markus Fischer wrote: > > > > > > > Hi, > > > > > > > > the fact that would you said is true, but is only the theory, > > > > doesn't convince me not to document the things, especially > > > > such BC things. With theory I mean there're a still a few PHP > > > > functions out there accessing the file system which arent' > > > > covered by either safe_mode or open_basedir (I darkly > > > > remmeber some posix() things, but I'm not sure). > > > > > > > > Personally I reather also document the fact the > > > > highlight_file is also affected by open_basedir then removing > > > > the paragraph completely. > > > > > > > > - Markus > > > > > > > > On Sat, May 11, 2002 at 11:54:58AM -0700, Rasmus Lerdorf wrote : > > > > > Well, and open_basedir, but do we really need to document this? > > > > > Theoretically every function that reads files and subject to > > > > > safe-mode/open_basedir restrictions. > > > > > > > > > > -Rasmus > > > > > > > > > > On Sat, 11 May 2002, Markus Fischer wrote: > > > > > > > > > > > mfischerSat May 11 14:51:46 2002 EDT > > > > > > > > > > > > Modified files: > > > > > > /phpdoc/en/reference/misc/functions highlight-file.xml > > > > > > Log: > > > > > > - highlight_file() is now affected by safe_mode. > > > > > > > > > > > > > > > > > > Index: phpdoc/en/reference/misc/functions/highlight-file.xml > > > > > > diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 >phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 > > > > > > --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 Wed >Apr 17 02:40:42 2002 > > > > > > +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 >14:51:44 2002 > > > > > > @@ -1,5 +1,5 @@ > > > > > > > > > > > > - > > > > > > + > > > > > > > > > > > > > > > > > > > > > > > > @@ -40,6 +40,13 @@ > > > > > >you do not inadvertently reveal sensitive information such as > > > > > >passwords or any other type of information that might create a > > > > > >potential security risk. > > > > > > + > > > > > > + > > > > > > + > > > > > > + > > > > > > + Since PHP 4.2.1 this function is also affected by > > > > > + linkend="ini.safe-mode">safe mode, i.e. only files which >pass the > > > > > > + safe mode restriction are >shown. > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > -- > > > > Please always Cc to me when replying to me on the lists. > > > > GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc > > > > "I'm not stupid, you know? :)" - Jani Taskinen > > > > > > > > -- > > Please always Cc to me when replying to me on the lists. > > GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc > > "I'm not stupid, you know? :)" - Jani Taskinen > > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
Hi, there are reports about this (don't know their # though). Am I the only who thinks that documenting such a change of the behaviour of a function is important? And if it's like you said, then it just is that way. Nothing is more painful for a user to find out a function now behaves differently without a note why and since when. There's no harm done, I only can see a benefit. - Markus On Sat, May 11, 2002 at 12:04:51PM -0700, Rasmus Lerdorf wrote : > If such functions exist, then they need to be fixed. If you find some, > submit a bug report. It's like documenting for each and every function > whether it works or not. Yes, there are bugs in some functions, that > doesn't mean that in every working function we put a note that says, "Hey, > this function actually works". > > -Rasmus > > On Sat, 11 May 2002, Markus Fischer wrote: > > > Hi, > > > > the fact that would you said is true, but is only the theory, > > doesn't convince me not to document the things, especially > > such BC things. With theory I mean there're a still a few PHP > > functions out there accessing the file system which arent' > > covered by either safe_mode or open_basedir (I darkly > > remmeber some posix() things, but I'm not sure). > > > > Personally I reather also document the fact the > > highlight_file is also affected by open_basedir then removing > > the paragraph completely. > > > > - Markus > > > > On Sat, May 11, 2002 at 11:54:58AM -0700, Rasmus Lerdorf wrote : > > > Well, and open_basedir, but do we really need to document this? > > > Theoretically every function that reads files and subject to > > > safe-mode/open_basedir restrictions. > > > > > > -Rasmus > > > > > > On Sat, 11 May 2002, Markus Fischer wrote: > > > > > > > mfischerSat May 11 14:51:46 2002 EDT > > > > > > > > Modified files: > > > > /phpdoc/en/reference/misc/functions highlight-file.xml > > > > Log: > > > > - highlight_file() is now affected by safe_mode. > > > > > > > > > > > > Index: phpdoc/en/reference/misc/functions/highlight-file.xml > > > > diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 >phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 > > > > --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 Wed Apr 17 >02:40:42 2002 > > > > +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 >14:51:44 2002 > > > > @@ -1,5 +1,5 @@ > > > > > > > > - > > > > + > > > > > > > > > > > > > > > > @@ -40,6 +40,13 @@ > > > >you do not inadvertently reveal sensitive information such as > > > >passwords or any other type of information that might create a > > > >potential security risk. > > > > + > > > > + > > > > + > > > > + > > > > + Since PHP 4.2.1 this function is also affected by > > > + linkend="ini.safe-mode">safe mode, i.e. only files which pass the > > > > + safe mode restriction are shown. > > > > > > > > > > > > > > > > > > > > > > > > -- > > Please always Cc to me when replying to me on the lists. > > GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc > > "I'm not stupid, you know? :)" - Jani Taskinen > > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
Hi, the fact that would you said is true, but is only the theory, doesn't convince me not to document the things, especially such BC things. With theory I mean there're a still a few PHP functions out there accessing the file system which arent' covered by either safe_mode or open_basedir (I darkly remmeber some posix() things, but I'm not sure). Personally I reather also document the fact the highlight_file is also affected by open_basedir then removing the paragraph completely. - Markus On Sat, May 11, 2002 at 11:54:58AM -0700, Rasmus Lerdorf wrote : > Well, and open_basedir, but do we really need to document this? > Theoretically every function that reads files and subject to > safe-mode/open_basedir restrictions. > > -Rasmus > > On Sat, 11 May 2002, Markus Fischer wrote: > > > mfischerSat May 11 14:51:46 2002 EDT > > > > Modified files: > > /phpdoc/en/reference/misc/functions highlight-file.xml > > Log: > > - highlight_file() is now affected by safe_mode. > > > > > > Index: phpdoc/en/reference/misc/functions/highlight-file.xml > > diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 >phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 > > --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 Wed Apr 17 >02:40:42 2002 > > +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 14:51:44 >2002 > > @@ -1,5 +1,5 @@ > > > > - > > + > > > > > > > > @@ -40,6 +40,13 @@ > >you do not inadvertently reveal sensitive information such as > >passwords or any other type of information that might create a > >potential security risk. > > + > > + > > + > > + > > + Since PHP 4.2.1 this function is also affected by > + linkend="ini.safe-mode">safe mode, i.e. only files which pass the > > + safe mode restriction are shown. > > > > > > > > > > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
Re: [PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
Hi, show_source() is only an alias to highlight_file() though it seems it has a separete documentation for no reason. If no one objects I'll remove every documentation for safe_mode and just hint a link to highlight_file() (removing it complete won't be good because it seems it's more "well known") because there's no point in documenting things twice. - Markus On Sat, May 11, 2002 at 06:51:46PM -, Markus Fischer wrote : > mfischer Sat May 11 14:51:46 2002 EDT > > Modified files: > /phpdoc/en/reference/misc/functions highlight-file.xml > Log: > - highlight_file() is now affected by safe_mode. > > > Index: phpdoc/en/reference/misc/functions/highlight-file.xml > diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 >phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 > --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 Wed Apr 17 02:40:42 >2002 > +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 14:51:44 >2002 > @@ -1,5 +1,5 @@ > > - > + > > > > @@ -40,6 +40,13 @@ >you do not inadvertently reveal sensitive information such as >passwords or any other type of information that might create a >potential security risk. > + > + > + > + > + Since PHP 4.2.1 this function is also affected by + linkend="ini.safe-mode">safe mode, i.e. only files which pass the > + safe mode restriction are shown. > > > > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
[PHP-DOC] cvs: phpdoc /en/reference/misc/functions highlight-file.xml
mfischerSat May 11 14:51:46 2002 EDT Modified files: /phpdoc/en/reference/misc/functions highlight-file.xml Log: - highlight_file() is now affected by safe_mode. Index: phpdoc/en/reference/misc/functions/highlight-file.xml diff -u phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 phpdoc/en/reference/misc/functions/highlight-file.xml:1.3 --- phpdoc/en/reference/misc/functions/highlight-file.xml:1.2 Wed Apr 17 02:40:42 2002 +++ phpdoc/en/reference/misc/functions/highlight-file.xml Sat May 11 14:51:44 +2002 @@ -1,5 +1,5 @@ - + @@ -40,6 +40,13 @@ you do not inadvertently reveal sensitive information such as passwords or any other type of information that might create a potential security risk. + + + + + Since PHP 4.2.1 this function is also affected by safe mode, i.e. only files which pass the + safe mode restriction are shown.
[PHP-DOC] cvs: phpdoc /en/reference/info/functions extension-loaded.xml
mfischerFri May 10 17:33:04 2002 EDT Modified files: /phpdoc/en/reference/info/functions extension-loaded.xml Log: - '-m' doesn't output version number (since today :) Index: phpdoc/en/reference/info/functions/extension-loaded.xml diff -u phpdoc/en/reference/info/functions/extension-loaded.xml:1.4 phpdoc/en/reference/info/functions/extension-loaded.xml:1.5 --- phpdoc/en/reference/info/functions/extension-loaded.xml:1.4 Sun May 5 12:55:17 2002 +++ phpdoc/en/reference/info/functions/extension-loaded.xml Fri May 10 17:33:04 +2002 @@ -1,5 +1,5 @@ - + @@ -34,9 +34,6 @@ list all available extensions: $ php -m -Running PHP 4.3.0-dev -Zend Engine v1.2.1, Copyright (c) 1998-2002 Zend Technologies - [PHP Modules] xml tokenizer
[PHP-DOC] cvs: phpdoc /en/reference/info/functions dl.xml
mfischerFri May 10 17:32:20 2002 EDT Modified files: /phpdoc/en/reference/info/functions dl.xml Log: - Use tag where appropriate. Index: phpdoc/en/reference/info/functions/dl.xml diff -u phpdoc/en/reference/info/functions/dl.xml:1.6 phpdoc/en/reference/info/functions/dl.xml:1.7 --- phpdoc/en/reference/info/functions/dl.xml:1.6 Wed May 8 13:45:23 2002 +++ phpdoc/en/reference/info/functions/dl.xml Fri May 10 17:32:19 2002 @@ -1,5 +1,5 @@ - + @@ -18,9 +18,9 @@ parameter is only the filename of the extension to load which also depends on your platform. For example, the sockets extension (if compiled as a shared - module, not the default!) would be called sockets.so - on unix platforms whereas it is called php_sockets.dll - on the windows platform. + module, not the default!) would be called sockets.so + on unix platforms whereas it is called + php_sockets.dll on the windows platform. &return.success; If the functionality of loading modules is not available @@ -53,7 +53,7 @@ Windows - If not explicitly set in the &php.ini;, the extension is - loaded from c:\php4\extensions\ by default. + loaded from c:\php4\extensions\ by default. Unix - If not explicitly set in the &php.ini;, the default extension @@ -82,8 +82,9 @@ Taking into account the above, the directory then defaults to/lib/php/extension/ - -ZEND_MODULE_API_NO, e.g. - /usr/local/php/lib/php/extensions/debug-non-zts-20010901 - or /usr/local/php/lib/php/extensions/no-debug-zts-20010901. + /usr/local/php/lib/php/extensions/debug-non-zts-20010901 + or + /usr/local/php/lib/php/extensions/no-debug-zts-20010901.
Re: [PHP-DOC] Where to document the (not so new but still new) CLIsapi?
Hi, As you may notice, I've commited something I wish to name 'preliminary initial cli glimpse'. I like the idea Thomas sugested because it's likely that CGI and CLI will diverge more and more in the future. Since we've now a bunch of new text (and I didn't yet deleted the old documentation, we might need the phrases for CGI) we can start putting this in shape as you guys decide. cheers, - Markus On Fri, May 10, 2002 at 11:06:19PM +0200, Thomas Schöfbeck wrote : > Hi there, > > the current existing differences can grow, and since CGI and CLI are > different modules in also different dirs, I'd suggest to make a > "Using PHP from the command line" as is, but now divided in > like "CGI Module" and "CLI Module", so that a TOC would look like > Using PHP from the command line > CGI Module > CLI Module > > just my 2 cents, > Thomas > > > Gabor Hojtsy wrote: > > > > Write a single CLI chapter, explaining all of the CLI > > > features and telling people where this differs from the CGI > > > CLI interface or put up a separate page for the CGI? > > > > > > Personally I'm for documenting everything, for which I think > > > keeping CGI command line separate would be a good thing. So > > > we woukd have a command CLI chapter, documenting fully CGI in > > > one part and fully CLI in the other. However I'm not that > > > familiar what's best for docbook organization with such > > > things. > > > > Uh, this is not to make our work easier... The command line features > > are quite the same with CLI and CGI (except parameters I guess). So it > > may be quite messy to mix the current command line chapter with CLI > > and CGI explanations... I still don't know what's the best... > > > > Goba > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
[PHP-DOC] cvs: phpdoc /en/features commandline.xml
mfischerFri May 10 17:11:06 2002 EDT Modified files: /phpdoc/en/features commandline.xml Log: - Initial cli documentation. # Now let's get this into the right place Index: phpdoc/en/features/commandline.xml diff -u phpdoc/en/features/commandline.xml:1.1 phpdoc/en/features/commandline.xml:1.2 --- phpdoc/en/features/commandline.xml:1.1 Mon May 6 06:43:56 2002 +++ phpdoc/en/features/commandline.xml Fri May 10 17:11:05 2002 @@ -1,18 +1,632 @@ - - + Using PHP from the command line + + + Since version 4.3, PHP supports a new + SAPI type (Server Application Programming Interface) + named CLI which means Command Line + Interface. As the name implies, this SAPI type + main focus is on developing shell (or desktop as well) applications with + PHP. There are quite some differences between the + CLI SAPI and other SAPIs which are + further explained throughout this chapter. + + + The CLI SAPI was released for the first time with + PHP 4.2.0, but was still experimental back then and had + to be explicitely enabled with --enable-cli when running + ./configure. Since PHP 4.3.0 the + CLI SAPI is no longer experimental and is therefore + always built and installed as the + php (called php.exe on Windows) + binary. + + + Remarkable differences of the CLI SAPI compared to other + SAPIs: + + + + Unlikely the CGI SAPI, no headers are written to the + output. + + + Though the CGI SAPI provies a way to suppress HTTP + headers, there's not equivalent switch to enable them in the CLI + SAPI. + + + + + The are certain &php.ini; directives which are overriden by the CLI + SAPI because the do not make sense in shell environments: + + Overriden &php.ini; directives + + + + Directive + CLI SAPI default value + Comment + + + + + html_errors + &false; + + It can be quite hard to read the error message in your shell when + it's cluttered with all those meaningless HTML + tags, therefore this directive defaults to &false;. + + + + implicit_flush + &true; + + It is desired that any output coming from + print, echo and friends is + immidiately written to the output and not cached in any buffer. + + + + max_execution_time + 0 (unlimited) + + Due to endless possibilities of using PHP in + shell environments, the maximum execution time has been set to + unlimited. Whereas applications written for the web are executed + within splits of a seconds, shell application tend to have a much + longer execution time. + + + + register_argc_argv + &true; + + The global PHP variables $argc + (number of arguments passed to the application) and + $argv (array of the actual arguments) are always + registered and filled in with the appropriate values when using the + CLI SAPI. + + + + + + + + + This directives cannot be initialzied with another value from the + configuration file &php.ini; or a custom one (if specified). This is a + limitation because those default values are applied after all + configuration files have been parsed. However, their value can be changed + during runtime (which does not make sense for all of those directives, + e.g. register_argc_argv). + + + + + + The CLI SAPI does not change the current directory to the directory + of the executed script ! + + + Example showing the difference to the CGI SAPI: + + + + + + When using the CGI version, the output is + + + + This clearly shows that PHP changes its current + directory to the one of the executed script. + + + Using the CLI SAPI yields: + + + + This allows for greater flexibility when writing shell tools in + PHP. + + + + The CGI SAPI supports the CLI SAPI + behaviour by means of the -C switch when ran from the + command line. + + + + + + + The list of command line options provided by the PHP + binary can be queryied anytime by running PHP with the + -h switch: + + + + + + The CLI SAPI has three different ways of getting the + PHP code you want to execute: + + + + Telling PHP to execute a certain file. + + + + + + Both ways (using the -f switch or not) execute the + given file my_script.php. You can choose any file to + execute, your PHP scripts do not have to end with the + .php extension but can give them any name or extension + you want them to have. +
Re: [PHP-DOC] Where to document the (not so new but still new) CLI sapi?
On Fri, May 10, 2002 at 08:42:39PM +0200, Friedhelm Betz wrote : > see http://www.php-start.de/features/ for a possible solution. > Of course this could be changed or altered in any way. > > Let me know and I'll commit and you can write the docu :-) Too late :) The docu is mainly written already, being placed in features/commandline for now. I'll commit it soon so people start fixing^H^H^H^H^H^Hextending it ;-) - Markus -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
[PHP-DOC] cvs: phpdoc /en/chapters config.xml
mfischerFri May 10 09:26:34 2002 EDT Modified files: /phpdoc/en/chapters config.xml Log: - Document 'implicit_flush'. Index: phpdoc/en/chapters/config.xml diff -u phpdoc/en/chapters/config.xml:1.51 phpdoc/en/chapters/config.xml:1.52 --- phpdoc/en/chapters/config.xml:1.51 Mon May 6 06:46:22 2002 +++ phpdoc/en/chapters/config.xml Fri May 10 09:26:33 2002 @@ -1,5 +1,5 @@ - + Configuration @@ -448,6 +448,29 @@ soon as they try to output something after a client has aborted their connection. ignore_user_abort. + + + + + + +implicit_flush +boolean + + + + &false; by default. Changing this to &true; tells PHP to tell the + output layer to flush itself automatically after every output block. + This is equivalent to calling the PHP function + flush after each and every call to + print or echo and each and + every HTML block. + + + When using PHP within an web environment, turning + this option on has serious performance implications and is generally + recommended for debugging purposes only. This value defaults to + &true; when operating under the CLI SAPI.
Re: [PHP-DOC] cvs: phpdoc /entities global.ent
Hi, this reminds I'ld like to introduce a new entity CLI. For now, it would only be CLI until we finished the organization discussion. I had something like &cli; or &features.cli; in mind . - Markus On Fri, May 10, 2002 at 08:32:33AM -, Philip Olson wrote : > philipFri May 10 04:32:33 2002 EDT > > Modified files: > /phpdoc/entities global.ent > Log: > url.foldoc.epoch -> http://wombat.doc.ic.ac.uk/foldoc/foldoc.cgi?EPOCH > > > Index: phpdoc/entities/global.ent > diff -u phpdoc/entities/global.ent:1.23 phpdoc/entities/global.ent:1.24 > --- phpdoc/entities/global.ent:1.23 Thu May 9 12:00:01 2002 > +++ phpdoc/entities/global.entFri May 10 04:32:33 2002 > @@ -1,6 +1,6 @@ >
Re: [PHP-DOC] Where to document the (not so new but still new) CLI sapi?
Hi, Ok, now happened what I didn't foresee :) I just wanted to start writing down some CLI specific features when i realized that in fact we have two CLI executables. The CGI version is still present and will for a long time, and has its own command line interface (it's mostly the same, but there are switches in CGI which aren't in CLI and of course the other way round). How we should handle this now? Write a single CLI chapter, explaining all of the CLI features and telling people where this differs from the CGI CLI interface or put up a separate page for the CGI? Personally I'm for documenting everything, for which I think keeping CGI command line separate would be a good thing. So we woukd have a command CLI chapter, documenting fully CGI in one part and fully CLI in the other. However I'm not that familiar what's best for docbook organization with such things. - Markus On Mon, May 06, 2002 at 01:04:25PM +0200, Friedhelm Betz wrote : > > >> What about Features/Comandline Scripting with the content of > >> appendices/commandline.xml plus the cli-doku? > > > Agreed. > > I just moved the commandline.xml from appendices to > features/commandline (also correcting id and links). > Docu for cli could go here. > > > Friedhelm -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen
[PHP-DOC] cvs: phpdoc /en/reference/sockets/functions socket-select.xml
mfischerFri May 10 03:57:20 2002 EDT Modified files: /phpdoc/en/reference/sockets/functions socket-select.xml Log: - Add a more verbose example. Index: phpdoc/en/reference/sockets/functions/socket-select.xml diff -u phpdoc/en/reference/sockets/functions/socket-select.xml:1.5 phpdoc/en/reference/sockets/functions/socket-select.xml:1.6 --- phpdoc/en/reference/sockets/functions/socket-select.xml:1.5 Mon May 6 10:51:41 2002 +++ phpdoc/en/reference/sockets/functions/socket-select.xml Fri May 10 03:57:20 +2002 @@ -1,5 +1,5 @@ - + @@ -49,6 +49,21 @@ empty array or &null; instead. Also do not forget that those arrays are passed by reference and will be modified after socket_select returns. + + + Example: + + +
[PHP-DOC] cvs: phpdoc /en/reference/sockets/functions socket-select.xml
mfischerMon May 6 10:51:46 2002 EDT Modified files: /phpdoc/en/reference/sockets/functions socket-select.xml Log: - Typo. # Now I know how closely others are reading my commits :-) Index: phpdoc/en/reference/sockets/functions/socket-select.xml diff -u phpdoc/en/reference/sockets/functions/socket-select.xml:1.4 phpdoc/en/reference/sockets/functions/socket-select.xml:1.5 --- phpdoc/en/reference/sockets/functions/socket-select.xml:1.4 Wed May 1 05:31:56 2002 +++ phpdoc/en/reference/sockets/functions/socket-select.xml Mon May 6 10:51:41 +2002 @@ -1,5 +1,5 @@ - + @@ -97,7 +97,7 @@ - Be aware that some socket imeplementations need to be handled very + Be aware that some socket implementations need to be handled very carefully. A few basic rules:
Re: [PHP-DOC] Where to document the (not so new but still new) CLI sapi?
Hi, maybe ... either way, it should be there soon so we can start documenting it. We can move things always around later (it's not like PHP where we would break API BC or so ;-) - Markus On Sun, May 05, 2002 at 08:09:08PM +0200, Gabor Hojtsy wrote : > > Where should the new CLI sapi be documented? > > > > There are certain unique changes done to the SAPI which have > > to be documented ASAP. Can someone with a good understanding > > of the phpdoc structure create a new section somewhere so > > people can contribute and properly document it? > > The question is if there would be any documentation for > the other SAPIs? If yes, then we need to open a new chapter > in the intro part I think. Or maybe a new appendix. > > Goba > -- Please always Cc to me when replying to me on the lists. GnuPG Key: http://guru.josefine.at/~mfischer/C2272BD0.asc "I'm not stupid, you know? :)" - Jani Taskinen