On Sep 8, 2009, at 2:00 AM, Lars Torben Wilson wrote:
Philip Olson wrote:
Comments, criticisms, and feedback greatly appreciated!
Sounds reasonable, and the more information the better :)
And while doing this, it's probably worth thinking about how to
ensure oop5 is a first class citizen. Meaning, a person reads about
OOP in terms of PHP 5 and those who care can find a section that's
specific to how PHP 4 differs. Maybe people have ideas for how best
to accomplish this.
Regards,
Philip
Hi Philip,
This makes me wonder how close we are to the time when the PHP 4
object reference can be relegated to the Appendices. I mean, even I
still have a couple of PHP 4 apps floating around out there so I of
course recognize that the ref is still needed, but I agree 100% that
the newer object model should have the more readily available
documentation.
The PHP 4 class/object ref probably also needs a look but honestly
at this point I'm not sure it's worth a whole lot of work anymore--
newcomers to PHP really shouldn't be using it.
Torben
Torben,
I don't share your desire to keep the PHP object reference around for
any reason. Appendix, perhaps, but certainly not in the main manual.
It was over a year ago that we dropped official PHP 4 support, and
over five years since PHP 5.0.0 was released. While I realize that a
good number of software packages still support PHP 4 (Wordpress and
Drupal, to name the big ones), we no longer do, and I think we only
encourage them to drag their feet by maintaining pseudo-support for
PHP 4.
I would therefore suggest the following:
* The drafting of a new section of the PHP 5 OOP manual, listing the
differences between PHP 4 and PHP 5 in brief.
* The relocation of the PHP 4 section to the appendix.
* The application of a large red warning box on each PHP 4 page,
stating that this version of the language is out of date and the
techniques listed on this particular page may break in future versions
of PHP.
Best,
Brandon