PHP :: Request #60698 :: Explicitly discouraging parethenses for arguments in some language constructs

Explicitly discouraging parethenses for arguments in some language constructs

Submitted:

2012-01-10 10:51 UTC

Modified:

2013-10-06 07:33 UTC

Votes:	1
Avg. Score:	5.0 ± 0.0
Reproduced:	1 of 1 (100.0%)
Same Version:	1 (100.0%)
Same OS:	1 (100.0%)

From:

phpmpan at mpan dot pl

Assigned:

Status:

Not a bug

Package:

Documentation problem

PHP Version:

Irrelevant

OS:

Private report:

CVE-ID:

None

View Developer Edit

Welcome! If you don't have a Git account, you can't do anything here.
If you reported this bug, you can edit this bug over here.

php.net Username: php.net Password:

Quick Fix:	(description)
	Block user comment
Status:		Assign to:
Package:
Bug Type:
Summary:
From:	phpmpan at mpan dot pl
New email:
PHP Version:		OS:

New/Additional Comment:

[2012-01-10 10:51 UTC] phpmpan at mpan dot pl

Description:
------------
Bug#60694 (and not only it) shows that users too often misinterpret parenthenses around arguments for the following language constructs:
 - echo
 - print
 - include
 - include_once
 - require
 - require_once
Documentation for those things should include warning about the issue (not necessarily the red warning box, a simple sentence should be enough).

Currently there is a notice that multiple arguments for `echo` should not be enclosed in parenthenses and. Also docs for `include` family warn about a case when the return value is used in an expression. However I believe this is insufficient and should be replaced with an explicit warning.

Bug#52722 is related.

Expected result:
----------------
Users should not misinterpret code

Actual result:
--------------
Users misinterpret code, because of parenthenses around arguments

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports

[2013-10-06 07:32 UTC] krakjoe@php.net

-Status: Open +Status: Not a bug

[2013-10-06 07:32 UTC] krakjoe@php.net

Using language constructs expressively is only supported by some language constructs,

[2013-10-06 07:33 UTC] krakjoe@php.net

sorry about the break in message ...

Those that do support it document sufficiently the use of parenthesis when using the construct expressively.

This is sufficient.

	php.net \| support \| documentation \| report a bug \| advanced search \| search howto \| statistics \| random bug \| login
go to bug id or search bugs for


Copyright © 2001-2025 The PHP Group All rights reserved.	Last updated: Wed Jul 09 01:01:35 2025 UTC