ID: 38247
Updated by: [EMAIL PROTECTED]
Reported By: kahennig at gmail dot com
-Status: Open
+Status: Bogus
Bug Type: Documentation problem
Operating System: Irrelevant
PHP Version: Irrelevant
New Comment:
There are lots of language constructs that parse like functions
(optionally have parentheses).
include, require, die, echo are all good examples.
There's no necessarily "correct" way to do it, the parser takes care of
them and it makes no difference to the end user. PHP's nature is to
avoid strictness.
As for your request to note this in the documentation, this is already
stated on the include page (to which the require page refers).
S
Previous Comments:
------------------------------------------------------------------------
[2006-07-28 21:13:50] kahennig at gmail dot com
Description:
------------
In the Code Samples found in the documentation, pages for "include",
"require", "include_once" and "require_once" these statements are
sometimes used with parentheses
e.g: include_once("a.php");
and sometimes without them
e.g: require 'prepend.php';
It seems to me that if both are valid, this should be noted in the doc
for each of these statements.
Else, if the PEAR Coding Standards are right (see
http://pear.php.net/manual/en/standards.including.php) and parentheses
should not be used, then it might make sense to fix the examples and
add a Note informing of the "correct" way to use these statements.
I am well aware, that both ways work, but what is the "right" or
"prefered" way? Is one deprecated in favor of the other? It might also
be a good idea to include the answeres to these questions in the doc.
Also, in the doc these statements are refered to as "include()",
"require()", etc. Where they always have the parentheses after them.
This seems quite confusing, if they really are not Functions but
Statemens (as the Doc. says: "The include() STATEMENT includes and
evaluates the specified file." -emphasis mine) It might also be worth
eliminating the parentheses in the statement name from the
Documentation.
------------------------------------------------------------------------
--
Edit this bug report at http://bugs.php.net/?id=38247&edit=1
