| didou@php.net 2006-12-28, 10:03 pm |
| ID: 39057
Updated by: didou@php.net
Reported By: nickj-phpbugs at nickj dot org
-Status: Open
+Status: Closed
Bug Type: Documentation problem
Operating System: Ubuntu Linux
PHP Version: 5CVS-2006-10-06 (snap)
New Comment:
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.
I removed the whole static part.
Thank you for your feedback
Previous Comments:
------------------------------------------------------------------------
[2006-12-07 01:18:59] nickj-phpbugs at nickj dot org
> The method _can_ be called statically, but it shouldn't.
Well in that case, there is definitely a documentation bug. Please tell
me, where does it say this in the documentation?
It should say "Calling this method statically is deprecated, and will
generate an error in E_STRICT error logging mode".
Instead it says this method can be called statically, period.
Calling a method in a way that the documentation says is valid, and
getting a error (even under the strictest error logging) is a bug -
reopening.
Please either fix the method to not generate an error, or fix the
documentation to say "you shouldn't do this".
> Most internal object methods cannot be called statically.
How is that relevant? This method's documentation explicitly says it
_can_ be called statically. To then generate an error that says
DOMDocument::load() is a "Non-static method" is at best misleading, and
at worst just plain wrong.
------------------------------------------------------------------------
[2006-12-02 07:57:48] bjori@php.net
The method _can_ be called statically, but it shouldn't.
Most internal object methods cannot be called statically.
------------------------------------------------------------------------
[2006-10-06 08:17:51] nickj-phpbugs at nickj dot org
Description:
------------
From http://php.net/manual/en/function.d...cument-load.php : "This
method may also be called statically to load and create a DOMDocument
object." There is also a code example. Running the static example code
with E_ALL | E_STRICT error_reporting generates a warning.
Reproduce code:
---------------
echo "<blah/>" > file.xml
php5.2-200610042230/sapi/cli/php -r 'error_reporting(E_ALL |
E_STRICT); $doc = DOMDocument::load("file.xml");'
Expected result:
----------------
No error.
Actual result:
--------------
PHP Strict Standards: Non-static method DOMDocument::load() should not
be called statically in Command line code on line 1
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=39057&edit=1
|