http://www.doctrine-project.org/jira This file is an XML representation of an issue en-us 5.2.7 850 21-02-2013 http://www.doctrine-project.org/jira/browse/DDC-1025 Doctrine 2 - ORM <p>It will help us use the namespace and code autocomplete in some IDE.</p> DDC-1025

Please repalce 'Doctrine\XXX\YYY' with '\Doctrine\XXX\YYY' in code and document

Improvement Major Open Unresolved All Benjamin Eberlei ben yan Wed, 9 Feb 2011 21:33:28 +0000 Tue, 13 Dec 2011 20:41:16 +0000 2.0.1 Documentation DQL Mapping Drivers ORM Tools 7 6 <p>Hi, do you have any more information about this ?</p> <p>I'm confused because the php documentation uses the Doctrine\XXX way, and everywhere I've seen, it is used like that.</p> <p>Thanks</p> <p>The issue is simple and logical. <img class="emoticon" src="http://www.doctrine-project.org/jira/images/icons/emoticons/smile.gif" height="20" width="20" align="absmiddle" alt="" border="0"/></p> <p>When an IDE (I am using PhpStorm and it does it like this) sees a namespace in a file, upon seeing namespaces afterwards, it sees them as absolute if they have a leading backslash, or relative when it does not. This affects the resolution of classes for type navigation, code inspection, ... The same rules as for actual PHP code should be used within comments.</p> <p>Here is an example:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">namespace Foo; class Bar { /** * @<span class="code-keyword">var</span> Baz */ <span class="code-keyword">protected</span> $baz; /** * @<span class="code-keyword">var</span> \Quux */ <span class="code-keyword">protected</span> $quux; } </pre> </div></div> <p>The IDE will think $baz is \Foo\Baz and $quux will be seen as being \Quux. Now if you have some reference to Doctrine here, and it was relative, the IDE would assume it's \Foo\Doctrine\...</p> <p>Well yes, but since all our code examples have no leading namespace argument this means the code is in the default namespace, making Doctrine\XXX\YY a relative namespace that is actually valid.</p> <p>Yes, but the source code docblocks are what is meant here as far as I am concerned.</p> <p>Example (Entitymanager.php):</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">namespace Doctrine\ORM; </pre> </div></div> <p>and</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">/** * The used Configuration. * * @<span class="code-keyword">var</span> Doctrine\ORM\Configuration */ <span class="code-keyword">private</span> $config; </pre> </div></div> <p>Result:<br/> <b>Doctrine\ORM\Doctrine\ORM\Configuration</b></p> <p>Should be:</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">/** * The used Configuration. * * @<span class="code-keyword">var</span> Configuration */ <span class="code-keyword">private</span> $config; </pre> </div></div> <p>Or</p> <div class="code panel" style="border-width: 1px;"><div class="codeContent panelContent"> <pre class="code-java">/** * The used Configuration. * * @<span class="code-keyword">var</span> \Doctrine\ORM\Configuration */ <span class="code-keyword">private</span> $config; </pre> </div></div> <p>Why don't you take this to the PhpStorm tracker as it surely is a bug in IDE?</p> <p>Miha, what makes you think it's an IDE bug? In a class in namespace Foo another class named Bar is \Foo\Bar, but \Bar is \Bar. Why is it a bug if the IDE follows the namespace resolution rules?</p> <p>The issue is that PHPStorm and NetBeans have different class resolution rules. I also use PHPStorm and most of Doctrine does not resolve auto-completion correctly because of this issue.</p> <p>I'd be willing to work on this if it would be accepted.</p> <p>I've been evaluating PhpStorm and also came across this issue; I believe the problem is due to Doctrine rather than being a bug with the IDE although it would be nice if PhpStorm would assume namespaces are absolute if they're not resolved upon an initial lookup.</p> <p>I created a quick c# app to append the beginning forward slash to any @var or @return attributes within Doctrine's source. It's working for me with Doctrine 2.1.2 and PhpStorm (IntelliJ): <a href="http://pastebin.com/4HxiWvJA" class="external-link">http://pastebin.com/4HxiWvJA</a> - hopefully this will be of use for anyone else using these IDEs;. Note: the application doesn't detect multiple line annotations although the only one I'm aware of is the getAST method in Doctrine\ORM\Query.php.</p> <p>This issue is referenced in Github Pull-Request GH-215<br/> <a href="https://github.com/doctrine/doctrine2/pull/215" class="external-link">https://github.com/doctrine/doctrine2/pull/215</a></p> <p>This issue is referenced in Github Pull-Request GH-216<br/> <a href="https://github.com/doctrine/doctrine2/pull/216" class="external-link">https://github.com/doctrine/doctrine2/pull/216</a></p>