Bug->Doc #55696 [Opn->Csd]: __CLASS__ includes the namespace definition

From: Date: Thu, 15 Sep 2011 15:26:54 +0000
Subject: Bug->Doc #55696 [Opn->Csd]: __CLASS__ includes the namespace definition
References: 1  Groups: php.doc.bugs 
Request: Send a blank email to doc-bugs+get-7194@lists.php.net to get a copy of this message
Edit report at https://bugs.php.net/bug.php?id=55696&edit=1 ID: 55696 Updated by: nikic@php.net Reported by: dohpaz dot php at dohpaz dot com Summary: __CLASS__ includes the namespace definition -Status: Open +Status: Closed -Type: Bug +Type: Documentation Problem -Package: Unknown/Other Function +Package: Documentation problem PHP Version: 5.3.8 -Assigned To: +Assigned To: nikic Block user comment: N Private report: N New Comment: This bug has been fixed in SVN. Snapshots of the sources are packaged every three hours; this change will be in the next snapshot. You can grab the snapshot at http://snaps.php.net/. For Windows: http://windows.php.net/snapshots/ Thank you for the report, and for helping us make PHP better. === I updated the predefined constants documentation to make this more clear :) Previous Comments: ------------------------------------------------------------------------ [2011-09-15 15:24:34] nikic@php.net Automatic comment from SVN on behalf of nikic Revision: http://svn.php.net/viewvc/?view=revision&amp;revision=316819 Log: Make value of __CLASS__ more clear. Refs Bug #55696 ------------------------------------------------------------------------ [2011-09-15 15:15:16] nikic@php.net As I see it "Foo\Bar" is the expected result. __CLASS__ returns the class name. And the class name is "Foo\Bar", not "Bar". An easy way to see this, is writing the following: $class = __CLASS__; $obj = new $class; This typical example (which would obviously be better written as just "$obj = new self;") would break if only "Bar" would be returned. ------------------------------------------------------------------------ [2011-09-14 20:48:27] dohpaz dot php at dohpaz dot com Description: ------------ With the introduction of namespaces, the __CLASS__ magic constant has changed (without being documented) to include the current namespace as part of the class name. I submit that since there is a __NAMESPACE__ magic constant that the __CLASS__ constant should be reverted to its previous behavior. It seems more natural to concatenate __NAMESPACE__ and __CLASS__ to get a qualified name, rather than using basename() to get just the class name. At the very least, the documentation for namespaces (http://php.net/namespace), Magic Constants (http://us.php.net/manual/en/language.constants.predefined.php), and Backwards Incompatible Changes (http://us.php.net/manual/en/migration53.incompatible.php) should be updated to reflect this change. Test script: --------------- <?php namespace Foo; class Bar { public function __construct() { echo __CLASS__ . PHP_EOL; } } $bar = new Bar; // echo's Foo\Bar ?> Expected result: ---------------- I expect the above test script to return just the class name (i.e., Bar). Actual result: -------------- The test script above returns the qualified class name (i.e., Foo\Bar). ------------------------------------------------------------------------ -- Edit this bug report at https://bugs.php.net/bug.php?id=55696&edit=1

« previous php.doc.bugs (#7194) next »