PEAR2 Coding Standards RFC
| From: | Gregory Beaver | Date: | Tue, 04 Sep 2007 00:21:50 +0000 |
| Subject: | PEAR2 Coding Standards RFC | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-47916@lists.php.net to get a copy of this message | ||
Hi all,
I have made the requested changes to the PEAR2 Coding Standards RFC at
http://wiki.pear.php.net/index.php/PEAR2_Standards.
* controversial items split out
* adjustments based on mailing list conversations
I have moved controversial things to
http://wiki.pear.php.net/index.php/Controversial_Changes
Also, I eliminated allfiles.php. Instead, PEAR2/Autoload.php can be
used to set up include_path if necessary, and declare __autoload() if
necessary, and takes care of all problems
1) beginners need only include '/full/path/to/PEAR2/Autoload.php'; and
then start using classes
2) if a class/file is not found, an exception is thrown that contains
include_path information and exactly what went wrong, so users will be
able to report the same information they do now with "fatal error:
require_once blah.php not found (include_path=".:/blah")"
3) advanced users still get the benefit of performance flexibility.
It should be noted that early assertions by Alan about the lack of
performance benefit from removing require_once have been disputed by
Gopal, who has found up to 10% performance improvement in his work at
Yahoo!. The performance benefit of removing require_once for advanced
users can be significant. Most users, however, will not see more than
2% improvement.
Please review the docs, find any minor mistakes, browse the proposal,
and let us know what you think
Greg