From: kahennig at gmail dot com
Operating system: Irrelevant
PHP version: Irrelevant
PHP Bug Type: Documentation problem
Bug description: include('foo') or include 'foo' -> documentation inconsistency
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 bug report at http://bugs.php.net/?id=38247&edit=1
--
Try a CVS snapshot (PHP 4.4):
http://bugs.php.net/fix.php?id=38247&r=trysnapshot44
Try a CVS snapshot (PHP 5.2):
http://bugs.php.net/fix.php?id=38247&r=trysnapshot52
Try a CVS snapshot (PHP 6.0):
http://bugs.php.net/fix.php?id=38247&r=trysnapshot60
Fixed in CVS: http://bugs.php.net/fix.php?id=38247&r=fixedcvs
Fixed in release:
http://bugs.php.net/fix.php?id=38247&r=alreadyfixed
Need backtrace: http://bugs.php.net/fix.php?id=38247&r=needtrace
Need Reproduce Script: http://bugs.php.net/fix.php?id=38247&r=needscript
Try newer version: http://bugs.php.net/fix.php?id=38247&r=oldversion
Not developer issue: http://bugs.php.net/fix.php?id=38247&r=support
Expected behavior: http://bugs.php.net/fix.php?id=38247&r=notwrong
Not enough info:
http://bugs.php.net/fix.php?id=38247&r=notenoughinfo
Submitted twice:
http://bugs.php.net/fix.php?id=38247&r=submittedtwice
register_globals: http://bugs.php.net/fix.php?id=38247&r=globals
PHP 3 support discontinued: http://bugs.php.net/fix.php?id=38247&r=php3
Daylight Savings: http://bugs.php.net/fix.php?id=38247&r=dst
IIS Stability: http://bugs.php.net/fix.php?id=38247&r=isapi
Install GNU Sed: http://bugs.php.net/fix.php?id=38247&r=gnused
Floating point limitations: http://bugs.php.net/fix.php?id=38247&r=float
No Zend Extensions: http://bugs.php.net/fix.php?id=38247&r=nozend
MySQL Configuration Error: http://bugs.php.net/fix.php?id=38247&r=mysqlcfg
