[PHP-DOC] Error in require_once() documentation
Hi
I noticed an little mistake in the documentation of the require_once() function.
Here you say:
Example 11-8. require_once() is case insensitive on Windows
It should be
Example 11-8. require_once() is case sensitive on Windows
(insensitive = sensitive)
In fact:
require_once('a_file.php');
is seen by require_once() as different from
require_once('A_File.php');
even if the file is the same on Windows
Thank you
Michele
PS: great job you guys @ php.net !!!
Re: [PHP-DOC] Error in require_once() documentation
Michele Locati wrote:
In fact:
require_once('a_file.php');
is seen by require_once() as different from
require_once('A_File.php');
even if the file is the same on Windows
What's your PHP and Windows version? This function is case insensitive
on my Windows box.
Jakub Vrana
[PHP-DOC] Fw: your php tutorial on my own site
I'm not quite sure what he's asking, I don't suppose any of the Dutch translators would like to speak to him? Thanks, - Original Message - From: [EMAIL PROTECTED] To: Aidan Lister [EMAIL PROTECTED] Sent: Friday, July 16, 2004 4:33 AM Subject: Re: your php tutorial on my own site Not really, I want to set the manual on my site, and if you give me permission then I post the dutch manual on my site and underneath it, I set a link to your site. Can I do that? I hope now it is beter to uderstand now. Tim - Original Message - From: Aidan Lister [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Thursday, July 15, 2004 1:58 PM Subject: Re: your php tutorial on my own site Hi Tim, I'm not quite sure what you're asking. If you'd like to view the manual in Dutch, check out: http://www.php.net/manual/nl/ If you'd like to help with the translation, apply for a CVS account. If you'd like to link to php.net, you're most welcome, you don't need to ask permission! I hope that answers your question, thanks for taking the time to write to us. Kind Regards, Aidan Lister Tim Admin [EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] Can I use your php manual on my site, I will translate it in to dutch because i am from Belgium. If I have permission from you, I wil set a hyperlink to your site because then my visitors can also visit your site. It wil be in every topic and also there wil stand underneed the text: with cooporation from the php.net staff. Please mail me back with an answer on this mail and if you give me permission, wil je set it in your mail Thank you for reading this mail! Tim De Smedt ([EMAIL PROTECTED]) http://www.webscriptz.be
[PHP-DOC] Re: Fw: your php tutorial on my own site
easy ;) He wants to set up a copy of the PHP manual on his own site, and asks if he is allowed to. He even says he'll put a link to your site (php.net) if you allow him. I don't think he knows that it's allowed yet ;) - Tul [Dutch Dude] Aidan Lister wrote: I'm not quite sure what he's asking, I don't suppose any of the Dutch translators would like to speak to him? Thanks, - Original Message - From: [EMAIL PROTECTED] To: Aidan Lister [EMAIL PROTECTED] Sent: Friday, July 16, 2004 4:33 AM Subject: Re: your php tutorial on my own site Not really, I want to set the manual on my site, and if you give me permission then I post the dutch manual on my site and underneath it, I set a link to your site. Can I do that? I hope now it is beter to uderstand now. Tim - Original Message - From: Aidan Lister [EMAIL PROTECTED] To: [EMAIL PROTECTED] Sent: Thursday, July 15, 2004 1:58 PM Subject: Re: your php tutorial on my own site Hi Tim, I'm not quite sure what you're asking. If you'd like to view the manual in Dutch, check out: http://www.php.net/manual/nl/ If you'd like to help with the translation, apply for a CVS account. If you'd like to link to php.net, you're most welcome, you don't need to ask permission! I hope that answers your question, thanks for taking the time to write to us. Kind Regards, Aidan Lister Tim Admin [EMAIL PROTECTED] wrote in message news:[EMAIL PROTECTED] Can I use your php manual on my site, I will translate it in to dutch because i am from Belgium. If I have permission from you, I wil set a hyperlink to your site because then my visitors can also visit your site. It wil be in every topic and also there wil stand underneed the text: with cooporation from the php.net staff. Please mail me back with an answer on this mail and if you give me permission, wil je set it in your mail Thank you for reading this mail! Tim De Smedt ([EMAIL PROTECTED]) http://www.webscriptz.be
[PHP-DOC] #27583 [Opn]: Not enough info on Apache 2 issues
ID: 27583 Updated by: [EMAIL PROTECTED] Reported By: stewart dot james at vu dot edu dot au Status: Open Bug Type: Documentation problem Operating System: Any PHP Version: Irrelevant Assigned To: philip New Comment: It is already linked from the new installation chapter. Previous Comments: [2004-07-16 00:33:33] [EMAIL PROTECTED] This needs to be in the faq and linked to from the apache2 installation docs. [2004-07-16 00:19:51] glm at cyborgspiders dot com Some extensions are not stable, anyone care to comment on which extensions are stable. Greg Magnusson Cyborg Spiders Web Development [2004-06-16 14:59:22] [EMAIL PROTECTED] This bug has been fixed in the documentation's XML sources. Since the online and downloadable versions of the documentation need some time to get updated, we would like to ask you to be a bit patient. Thank you for the report, and for helping us make our documentation better. [2004-05-05 18:19:21] okapi at yahoo dot com Can we have adjusted the information on the PHP apache 2 manual page http://www.php.net/manual/en/install.apache2.php) from: *Warning* Do not use Apache 2.0 and PHP in a production environment neither on Unix nor on Windows. To something more clear. This line has been the death to many to try Apache 2. The statement should be more along the lines of Some PHP modules are not fully tested for running in the default multithreaded environment of Apache 2. Core functions should be safe for this environment. To be extra careful, it is recommended to run Apache 2 in prefork mode which should avoid problems as it runs similar to Apache 1.3.x in this mode. Something along the lines of this and then for there to be a list of modules tested / check and not tested which could have problems. A comment was made: The PHP core is perfectly stable on Apache 2 -- It's just a few extensions that cause trouble... We should probably be saying that instead of just rejecting Apache 2 entirely. This single ambigous line of Do not use... is not productive. [2004-04-27 15:09:46] jlx at surfeu dot de unable to get apache2.0.49 work with php4.3.6 and use php as a static library, only the dso version works :-( The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/27583 -- Edit this bug report at http://bugs.php.net/?id=27583edit=1
Re: [PHP-DOC] cvs: phpdoc /en/appendices migration5.xml
I've been also merging the http://php.net/zend-engine-2.php into the docs as well. That file was merged into appendixes/migration5.xml. So, you may copy the text from there, as it already has the docbook formatting. Oh, we also need a new section to replace the final.xml, to include not just the final keyword, but also, self and this, IHMO. My orginaly thought was to put self and parent inside of the paamayim-nekudotayim.xml file, a new home would be nice for them. Oh, thats ok... I didn't know what you were thinking to put in :: The next step is exceptions... We must think where to put them! Nuno P.S.: I'm going on vacations today, so next week I won't be able to answer any e-mail
[PHP-DOC] cvs: phpdoc /en/reference/image/functions imagecreate.xml
tularis Fri Jul 16 08:41:51 2004 EDT Modified files: /phpdoc/en/reference/image/functionsimagecreate.xml Log: fixed small typo in example ( removed comments about it) http://cvs.php.net/diff.php/phpdoc/en/reference/image/functions/imagecreate.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/reference/image/functions/imagecreate.xml diff -u phpdoc/en/reference/image/functions/imagecreate.xml:1.7 phpdoc/en/reference/image/functions/imagecreate.xml:1.8 --- phpdoc/en/reference/image/functions/imagecreate.xml:1.7 Mon Dec 15 11:51:11 2003 +++ phpdoc/en/reference/image/functions/imagecreate.xml Fri Jul 16 08:41:51 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- !-- splitted from ./en/functions/image.xml, last change in rev 1.36 -- refentry id=function.imagecreate refnamediv @@ -30,7 +30,7 @@ ![CDATA[ ?php header(Content-type: image/png); -$im = @imagecreate(50, 100) +$im = @imagecreate(100, 50) or die(Cannot Initialize new GD image stream); $background_color = imagecolorallocate($im, 255, 255, 255); $text_color = imagecolorallocate($im, 233, 14, 91);
[PHP-DOC] #24604 [Com]: SAFE_MODE design issues
ID: 24604 Comment by: bramspam at pandora dot be Reported By: timo dot hummel at 4fb dot de Status: Open Bug Type: Documentation problem Operating System: SuSE Linux 8.2 Linux 2.4.19 PHP Version: Irrelevant New Comment: This is a pretty old bug, so has this been fixed yet? My webhost is running a pretty darned old PHP version, but I don't see the point in bugging them to upgrade of this bug isn't fixed yet .. Previous Comments: [2004-05-31 09:37:18] real763 at uni dot de uhm thats not great ftp doenst work , and CGI is not running, too :( Warning: ftp_connect() [function.ftp-connect]: php_network_getaddresses: getaddrinfo failed: Name or service not known in /home/www/htdocs/myhost.com/bla.php on line 382 @develop: plz upgrade SAFE_MODE : - ) [2004-03-01 02:31:19] timo dot hummel at 4fb dot de It makes no sense to let users create a dir and not let them write to it. Well, that's another thing. It's probably about the umask, however, most providers and/or distribution builders should take care of this, but aren't. [2004-03-01 02:24:04] soenke at regelt dot com safe_mode_gid should be a workaround for this. @Developers: Please let us know your plans about this issue. -- Soenke [2004-01-29 18:26:33] rlammers at angelfire dot com The simplest way to let users do anything on my website is by creating a subdir for them to separate their actions from others. Now my webhost has turned safe_mode on and the only work-around is to let the ftp-pasword lying around in a script file. Nice security that is!. Please fix this (imho major) bug. It makes no sense to let users create a dir and not let them write to it. [2004-01-21 05:52:41] thorsten at rinne dot info Hi, using PHP as CGI with suPHP (www.suphp.org) there are no problems: -rw-r--r--1 thorsten users 195 Jan 20 22:01 test.php Then running test.php... Result: drwxr-xr-x2 thorsten users 4096 Jan 20 22:03 test -rw-r--r--1 thorsten users 195 Jan 20 22:01 test.php It would be nice if this would work with mod_php! bye Thorsten The remainder of the comments for this report are too long. To view the rest of the comments, please view the bug report online at http://bugs.php.net/24604 -- Edit this bug report at http://bugs.php.net/?id=24604edit=1
[PHP-DOC] unsubscribe please............!!!!!!!!!!!!!!
wat the hell come on I have been writing this 5th or 6th time . I have been requesting that i want to unsubscribe from this group. Can't you people understand that. For god sake please unsubscribe okay . prasad. _ Reach out to millions of buyers. http://go.msnserver.com/IN/52047.asp With zero investment.
[PHP-DOC] cvs: phpdoc /en bookinfo.xml contributors.xml language-snippets.ent preface.xml
gobaFri Jul 16 11:45:02 2004 EDT Added files: /phpdoc/en contributors.xml Modified files: /phpdoc/en bookinfo.xml preface.xml language-snippets.ent Log: And here comes what noone expected to happen soon :) Shuffling with the authors and editors list. Stay tuned: - moving old editor list to contributors.xml and adding my name there as an editor (do you see me Steph?) - adding note maintainers list generated a few minutes ago with the notes_stats.php script (note that user 'irc' was not found in the current CVS user list, I assume he is the same as 'irchtml', plus Sebastian Picklum seems to have two CVS accounts (spic and sp), both of which he used to maintain notes. What comes now: - someone please dig up the script which generated a summary based on the phpdoc CVS logs / news server data, so we can get an idea of who to list as past author+editor, and who is currently to be put there (I don't know where that script is) - suggest yourself as a manual editor if you think you will be accepted by the community! - complain on the user note editor list, if you think that something is unfair in there (you are listed but you should not be, or the other way around) - complain if you think anything else is problematic :) BTW I have added myself as an editor to break the untouchable list and not to monopolize that place, so once again feel free to propose yourself if you see you fit there (or complain about myself being there :)). http://cvs.php.net/diff.php/phpdoc/en/bookinfo.xml?r1=1.38r2=1.39ty=u Index: phpdoc/en/bookinfo.xml diff -u phpdoc/en/bookinfo.xml:1.38 phpdoc/en/bookinfo.xml:1.39 --- phpdoc/en/bookinfo.xml:1.38 Wed Jun 9 05:54:47 2004 +++ phpdoc/en/bookinfo.xml Fri Jul 16 11:45:02 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.38 $ -- +!-- $Revision: 1.39 $ -- bookinfo id=bookinfo titlePHPManual;/title @@ -7,43 +7,50 @@ author firstnameStig/firstnamesurnameSaelig;ther Bakken/surname -!-- email: ssb%40php.net -- +!-- email: ssb -- /author author firstnameAlexander/firstnamesurnameAulbach/surname -!-- email: ssilk%40ssilk.de [no cvs user listed at master.php.net!] -- +!-- email: ssilk [at] ssilk.de [no cvs user listed at master.php.net!] -- /author author firstnameEgon/firstnamesurnameSchmid/surname -!-- email: eschmid%40php.net -- +!-- email: eschmid -- /author author firstnameJim/firstnamesurnameWinstead/surname -!-- email: jimw%40php.net -- +!-- email: jimw -- /author author firstnameLars Torben/firstnamesurnameWilson/surname -!-- email: torben%40php.net -- +!-- email: torben -- /author author firstnameRasmus/firstnamesurnameLerdorf/surname -!-- email: rasmus%40php.net -- +!-- email: rasmus -- /author author firstnameAndrei/firstnamesurnameZmievski/surname -!-- email: andrei%40php.net -- +!-- email: andrei -- /author author firstnameJouni/firstnamesurnameAhto/surname -!-- email: jah%40php.net -- +!-- email: jah -- /author + + !-- This is not too nice, but works -- + collab +collabname + link linkend=contributorsAnd several others/link +/collabname + /collab /authorgroup @@ -51,10 +58,7 @@ authorgroup id=editors editor -firstnameStig/firstnamesurnameSaelig;ther Bakken/surname - /editor - editor -firstnameEgon/firstnamesurnameSchmid/surname +firstnameGabor/firstnamesurnameHojtsy/surname /editor /authorgroup http://cvs.php.net/diff.php/phpdoc/en/preface.xml?r1=1.28r2=1.29ty=u Index: phpdoc/en/preface.xml diff -u phpdoc/en/preface.xml:1.28 phpdoc/en/preface.xml:1.29 --- phpdoc/en/preface.xml:1.28 Sun May 23 15:14:38 2004 +++ phpdoc/en/preface.xml Fri Jul 16 11:45:02 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.28 $ -- +!-- $Revision: 1.29 $ -- preface id=preface titlePreface/title @@ -33,6 +33,21 @@ interested in the link linkend=historyhistory of PHP/link, visit the relevant appendix. /para + + sect1 id=contributors + titleAuthors and Contributors/title + + para +Additionaly to the author and editor list on the frontpage, here +you can find the names of people who currently help maintain the +documentation and the user notes. We also keep historical credit +for those, who are not active contributors currently. These lists +are in alphabetical order. + /para + + contributors; + + /sect1 /preface http://cvs.php.net/diff.php/phpdoc/en/language-snippets.ent?r1=1.103r2=1.104ty=u Index: phpdoc/en/language-snippets.ent diff -u phpdoc/en/language-snippets.ent:1.103 phpdoc/en/language-snippets.ent:1.104 --- phpdoc/en/language-snippets.ent:1.103 Thu
Re: [PHP-DOC] unsubscribe please............!!!!!!!!!!!!!!
This is the [EMAIL PROTECTED] mailing list. It was your choice to subscribe. Please see http://php.net/unsub if you would like to unsubscribe. Regards, Gabor Hojtsy prasad vasudevan rta: wat the hell come on I have been writing this 5th or 6th time . I have been requesting that i want to unsubscribe from this group. Can't you people understand that. For god sake please unsubscribe okay . prasad. _ Reach out to millions of buyers. http://go.msnserver.com/IN/52047.asp With zero investment.
Re: [PHP-DOC] PHP Help Documentation
Hi Keith, Hi. I am finishing up the development on an editor that supports PHP. I would like to incorporate the documentation for each of the functions for PHP in the software to make the life of developers using my editor software easier. I would like to make the argument list and the full function description available within the program if possible. Please let me know if you would allow me to incorporate your PHP documentation into my software. Also, if this is a possibility, what you would require from me. You should include that the PHP function information is copyrighted by the PHP Documentation Group (see the complete copyright which you should include at http://php.net/manual/en/copyright.php) Goba
[PHP-DOC] cvs committers at phpdoc
Hi (especially Nuno!), I have found out that Nuno used to have a CVS committer summary script [1]. We need such a script to compile an initial list of inactive and active authors to put into the manual finally. There is an online version of another script [2] which is very much outdated. [1] http://marc.theaimsgroup.com/?l=phpdocm=107893997015788w=2 [2] http://libresoft.dat.escet.urjc.es/cvsanal/php-cvs/index.php?menu=Modulesmodule=phpdoc Goba
Re: [PHP-DOC] cvs: phpdoc /en bookinfo.xml contributors.xml language-snippets.ent preface.xml
And here comes what noone expected to happen soon :) Shuffling with the authors and editors list. Stay tuned: Oh yes, nobody was expecting... But I like surprises :) - someone please dig up the script which generated a summary based on the phpdoc CVS logs / news server data, so we can get an idea of who to list as past author+editor, and who is currently to be put there (I don't know where that script is) I have presented my script to display the number of changed lines a while ago. The script isn't good because it relies on bonsai server data, which has stopped making stats a couple of months ago. My script also doesn't count the lines added (because they are not supplied by CVS). You may access it here: http://testes.aborla.net/top.html - suggest yourself as a manual editor if you think you will be accepted by the community! BTW I have added myself as an editor to break the untouchable list and not to monopolize that place, so once again feel free to propose yourself if you see you fit there (or complain about myself being there :)). Whats the difference between editors and authors? + para +Additionaly to the author and editor list on the frontpage, here +you can find the names of people who currently help maintain the +documentation and the user notes. We also keep historical credit +for those, who are not active contributors currently. These lists +are in alphabetical order. + /para The lists aren't in alphabetical order :) Nuno
Re: [PHP-DOC] cvs committers at phpdoc
Hi (especially Nuno!), I have found out that Nuno used to have a CVS committer summary script [1]. We need such a script to compile an initial list of inactive and active authors to put into the manual finally. There is an online version of another script [2] which is very much outdated. [1] http://marc.theaimsgroup.com/?l=phpdocm=107893997015788w=2 [2] http://libresoft.dat.escet.urjc.es/cvsanal/php-cvs/index.php?menu=Modulesmodule=phpdoc Goba Oh,... I've included the answer in my previous e-mail... The output is here: http://testes.aborla.net/top.html The second script (that site is really outdated) is in perl, so I think we shouldn't use it :) The homepage of the script is down for now, but then we can download the script and use it, as it will have fresher information than mine, as it is based on CVS logs, while mine was using bonsai data. When I come back from vacations, I can modify my script if needed. Nuno
Re: [PHP-DOC] cvs: phpdoc /en bookinfo.xml contributors.xml language-snippets.ent preface.xml
- someone please dig up the script which generated a summary based on the phpdoc CVS logs / news server data, so we can get an idea of who to list as past author+editor, and who is currently to be put there (I don't know where that script is) I have presented my script to display the number of changed lines a while ago. The script isn't good because it relies on bonsai server data, which has stopped making stats a couple of months ago. My script also doesn't count the lines added (because they are not supplied by CVS). You may access it here: http://testes.aborla.net/top.html Aham... I have mailed systems a few minutes ago noting that bonsai is not up to date. We will see if something good comes out of this, or not... We might also contact the programmers at the cvs stat site: http://libresoft.dat.escet.urjc.es/cvsanal/php-cvs/index.php?menu=Modulesmodule=phpdoc It would be good stuff if it would be updated (and would be able to generate data for the last half year too). Hartmut should be the all time winner AFAIK, since he has done enourmous amounts of changes (mostly administrational). to monopolize that place, so once again feel free to propose yourself if you see you fit there (or complain about myself being there :)). Whats the difference between editors and authors? Editor: main job is to look around, warn people of their mistakes, fix mistakes when they occur, help people decide on architectural stuff, etc. Author: works on his own, main job is adding documentation, examples, etc. gets help from the editors in case of questions So the author creates the content, while the editor helps fitting it into the frame and correcting stuff when needed. There will probably be people who think they fit into both roles. It should be noted that IMHO we should use the same separation for active and inactive authors/editors as we do with the user note maintainers (active are those who were here the past half year, others are inactive). The lists aren't in alphabetical order :) I have done my best to have them in alphabetical order (by *family name* as it is supposed to be). If you spot errors, feel free to fix the order. Goba
Re: [PHP-DOC] cvs committers at phpdoc
Oh,... I've included the answer in my previous e-mail... The output is here: http://testes.aborla.net/top.html The second script (that site is really outdated) is in perl, so I think we shouldn't use it :) The homepage of the script is down for now, but then we can download the script and use it, as it will have fresher information than mine, as it is based on CVS logs, while mine was using bonsai data. When I come back from vacations, I can modify my script if needed. Great. We need as much information as possible (while still a digestable amount) about what cvs committers done what. Goba
Re: [PHP-DOC] cvs committers at phpdoc
The second script (that site is really outdated) is in perl, so I think we shouldn't use it :) I have checked out the code from their cvs server, which is used to generate that and will experiment with what it can do. It is python, not perl actually. Goba
Re: [PHP-DOC] cvs: phpdoc /en bookinfo.xml contributors.xml language-snippets.ent preface.xml
Aham... I have mailed systems a few minutes ago noting that bonsai is not up to date. We will see if something good comes out of this, or not... I think they can't update the info, as it was disabled when they changed the bonsai server and it lost some CVS logs (AFAIK bonsai receives the e-mails with the changes and then update the info). There is something commented out in CVSROOT (but I don't remeber where...) So, the best approach is to download the CVS logs directly (or from the news server..) to monopolize that place, so once again feel free to propose yourself if you see you fit there (or complain about myself being there :)). Thanks for the explanation :) Oh, maybe I can fit in the author section? But there are several others that should go in there, like Philip, Medhi, ... The lists aren't in alphabetical order :) I have done my best to have them in alphabetical order (by *family name* as it is supposed to be). If you spot errors, feel free to fix the order. Oh, the listed is sorted by surname... I thought it was sorted by name. Nuno
Re: [PHP-DOC] cvs committers at phpdoc
The second script (that site is really outdated) is in perl, so I think we shouldn't use it :) I have checked out the code from their cvs server, which is used to generate that and will experiment with what it can do. It is python, not perl actually. Goba Python? Even worst =) This is my last mail since the vacations, but when I come back I will help you in making this (or other) script working. Nuno
[PHP-DOC] cvs: phpdoc /en/appendices filters.xml
pollita Fri Jul 16 20:15:21 2004 EDT Modified files: /phpdoc/en/appendices filters.xml Log: Update availability of zlib.* compression filters http://cvs.php.net/diff.php/phpdoc/en/appendices/filters.xml?r1=1.7r2=1.8ty=u Index: phpdoc/en/appendices/filters.xml diff -u phpdoc/en/appendices/filters.xml:1.7 phpdoc/en/appendices/filters.xml:1.8 --- phpdoc/en/appendices/filters.xml:1.7Fri Apr 23 09:12:15 2004 +++ phpdoc/en/appendices/filters.xmlFri Jul 16 20:15:21 2004 @@ -1,5 +1,5 @@ ?xml version=1.0 encoding=iso-8859-1? -!-- $Revision: 1.7 $ -- +!-- $Revision: 1.8 $ -- appendix id=filters titleList of Available Filters/title para @@ -277,14 +277,13 @@ /simpara /note - note - simpara -The zlib.* filters are not currently built into the PHP core. To enable these filters -in literalPHP 5/literal, install the ulink url=url.pecl.package;zlib_filterzlib_filter/ulink + simpara +zlib.* compression filters are available with PHP as of version literal5.1.0/literal if +xref linkend=zlib/ support is enabled. They are also available as a backport in version +literal5.0.x/literal by installing the ulink url=url.pecl.package;zlib_filterzlib_filter/ulink package from ulink url=url.pecl;PECL/ulink. These filters are emphasisnot/emphasis available for literalPHP 4/literal. - /simpara - /note + /simpara example title
[PHP-DOC] cvs: phpdoc /en/language/oop5 cloning.xml
curtSat Jul 17 00:05:28 2004 EDT
Modified files:
/phpdoc/en/language/oop5cloning.xml
Log:
WS Fixes
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/cloning.xml?r1=1.1r2=1.2ty=u
Index: phpdoc/en/language/oop5/cloning.xml
diff -u phpdoc/en/language/oop5/cloning.xml:1.1 phpdoc/en/language/oop5/cloning.xml:1.2
--- phpdoc/en/language/oop5/cloning.xml:1.1 Sun Jul 11 08:33:25 2004
+++ phpdoc/en/language/oop5/cloning.xml Sat Jul 17 00:05:28 2004
@@ -1,18 +1,18 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
sect1 id=language.oop5.cloning
titleObject cloning/title
para
- Creating a copy of an object with fully replicated properties is not
- always the wanted behavior. A good example of the need for copy
- constructors, is if you have an object which represents a GTK window and the
- object holds the resource of this GTK window, when you create a duplicate
- you might want to create a new window with the same properties and have the
- new object hold the resource of the new window. Another example is if your
- object holds a reference to another object which it uses and when you
- replicate the parent object you want to create a new instance of this other
- object so that the replica has its own separate copy.
+ Creating a copy of an object with fully replicated properties is not
+ always the wanted behavior. A good example of the need for copy
+ constructors, is if you have an object which represents a GTK window and the
+ object holds the resource of this GTK window, when you create a duplicate
+ you might want to create a new window with the same properties and have the
+ new object hold the resource of the new window. Another example is if your
+ object holds a reference to another object which it uses and when you
+ replicate the parent object you want to create a new instance of this other
+ object so that the replica has its own separate copy.
/para
para
@@ -40,9 +40,9 @@
object, and only override properties that need to be changed.
/para
-example
- titleCloning an object/title
- programlisting role=php
+ example
+ titleCloning an object/title
+ programlisting role=php
![CDATA[
?php
class MyCloneable {
@@ -72,10 +72,8 @@
print $obj_cloned-address . \n;
?
]]
- /programlisting
-/example
-
-
+ /programlisting
+ /example
/sect1
[PHP-DOC] cvs: phpdoc /en/language/oop5 paamayim-nekudotayim.xml
curtSat Jul 17 00:51:28 2004 EDT
Modified files:
/phpdoc/en/language/oop5paamayim-nekudotayim.xml
Log:
paamayim nekudotayim documentation.
http://cvs.php.net/diff.php/phpdoc/en/language/oop5/paamayim-nekudotayim.xml?r1=1.1r2=1.2ty=u
Index: phpdoc/en/language/oop5/paamayim-nekudotayim.xml
diff -u phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.1
phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.2
--- phpdoc/en/language/oop5/paamayim-nekudotayim.xml:1.1Sun Jul 11 08:33:25
2004
+++ phpdoc/en/language/oop5/paamayim-nekudotayim.xmlSat Jul 17 00:51:27 2004
@@ -1,11 +1,98 @@
?xml version=1.0 encoding=iso-8859-1?
-!-- $Revision: 1.1 $ --
+!-- $Revision: 1.2 $ --
sect1 id=language.oop5.paamayim-nekudotayim
title::/title
+
+ para
+ The Paamayim Nekudotayim, or in simpler terms, the double colon.
+ This token provides a way to access link
+ linkend=language.oop5.staticstatic/link, link
+ linkend=language.oop5.constantsconstant/link or overridden members
+ or methods of a class.
+ /para
+
+ para
+ When referencing these items from outside the class definition, you use
+ name of the class.
+ /para
+
+ example
+ title:: from outside class definition/title
+ programlisting role=php
+![CDATA[
+?php
+class MyClass {
+ const CONST_VALUE = 'A constant value';
+}
+echo MyClass::CONST_VALUE;
+?
+]]
+ /programlisting
+ /example
+
+ para
+ Two special keywords varnameself/varname and varnameparent/varname
+ are used to access members or methods from inside the class definition.
+ /para
+
+ example
+ title:: from inside the class definition/title
+ programlisting role=php
+![CDATA[
+?php
+class OtherClass extends MyClass {
+ public static $my_static = 'static var';
+
+ public static function doubleColon() {
+ echo parent::CONST_VALUE . \n;
+ echo self::$my_static . \n;
+ }
+}
+
+OtherClass::doubleColon();
+?
+]]
+ /programlisting
+ /example
+
para
- .
+ When an extending class overrides the parents definition of a method,
+ php will not call the parent's method. It is up to the extending class
+ to call the parent method or not, this also applies to link
+ linkend=language.oop5.deconConstructors and Destructors/link, link
+ linkend=language.oop5.overloadingOverloading/link and link
+ linkend=language.oop5.magicMagic/link method defintions as well.
/para
+ example
+ titleCalling a parent's method/title
+ programlisting role=php
+![CDATA[
+?php
+class MyClass {
+
+ protected function myFunc() {
+echo MyClass::myFunc()\n;
+ }
+}
+
+class OtherClass extends MyClass {
+
+ /* Override parent's definition */
+ public function myFunc() {
+
+/* But still call the parent function */
+parent::myFunc();
+echo OtherClass::myFunc()\n;
+ }
+}
+
+$class = new OtherClass();
+$class-myFunc();
+?
+]]
+ /programlisting
+ /example
/sect1
@@ -29,3 +116,4 @@
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
--
+
[PHP-DOC] oop5 status
We need a nice intro. I've been avoiding it cause I'm not really sure what should go there, any thoughts on what should be said there? Any thing will be better than my 'Intro to oop 5' :) Perhaps one of the things on the first page is the basic concept on how to create a class and extending a class. Current sections that need content, limited to sections defined: - Object Constants - Object Interfaces - Overloading - Object Iteration - Magic Methods - Final keyword The only section that isn't listed in the current structure is Exceptions. If, however, the oop5 documentation is going to be more on the idea that they have no clue about php4 oop then we need: - class creation - extending classes One way to aproach this is to have a 'Intro to OOP with PHP', which will define the basics that are common between the both 4 and 5. Like class creation and extending a class. On second thought this might not be a good idea since member and method declartion are completely different. Consistancy issues: Right now we have the title's of stuff that vary a lot. Some are prefixed with 'Object' other's have the word 'Keyword' appended. I'm thinking we should get rid of those pre and post words and just do stuff like: Constants Abstraction ... The only two I don't see that fit that naming scheme are final and static, they don't make sense to me without some sort of text around them. What to do with the built in classes and implementations: Like implementing Iterator (and all that SPL stuff if applicable) extending the Exception class etc. The Title's for PHP4 vs PHP5: Although very low priority right now, on my browser the left navigation line breaks in between the words and looks horrible. This might be more of an issue of how the left nav vertical alignment is displayed. Well this was a little more complicated than I expected :) I hope I was clear enough. Curt -- First, let me assure you that this is not one of those shady pyramid schemes you've been hearing about. No, sir. Our model is the trapezoid!
