Please use the Apache issue tracking system for new NetBeans issues ( !!
Bug 196564 - Allow "@return this" to support method chaining in subclasses
Allow "@return this" to support method chaining in subclasses
Product: php
Classification: Unclassified
Component: Editor
All All
: P3 (vote)
: 8.0
Assigned To: Ondrej Brejla
Depends on:
  Show dependency treegraph
Reported: 2011-03-11 01:29 UTC by dharkness
Modified: 2013-01-30 03:42 UTC (History)
0 users

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description dharkness 2011-03-11 01:29:42 UTC
Currently you must specify the class as the return value for a chained-method (a method that returns $this). This breaks code completion when subclasses are involved.

class Parent {
     * @return Parent
    public function foo() {
        return $this;

class Child extends Parent {
     * @return Child
    public function bar() {
        return $this;

$c = new Child();
$c->           // CC shows foo() and bar(), correct
$c->foo()->    // CC shows only foo(), but I want bar() too

I would like to be able to set both @return attributes above to "this". NetBeans should be able to see that in the last line foo() returns $c which is a Child and display both methods in code completion.

I understand that this is not valid PHPDoc, but I see no reason to keep NB from extending it.
Comment 1 Tomas Mysik 2011-06-03 10:23:14 UTC
Batch reassigning.
Comment 2 Tomas Mysik 2011-06-03 10:32:35 UTC
Editor area.
Comment 3 BullfrogBlues 2012-02-09 10:02:52 UTC

*** This bug has been marked as a duplicate of bug 196565 ***
Comment 4 dharkness 2012-02-09 18:30:32 UTC
While this feature request is similar to 196565 in that it is asking for special handling of the @return doc comment, it's a different case. This one address fluent interfaces whereas the other is for static factory methods.
Comment 5 Ondrej Brejla 2013-01-15 10:19:09 UTC
reply to 1:
If foo() returns not just Parent, but sometimes Child too (if it's called on a Child type), then we should use "@return this" annotation instead of "@return Parent" (it's same as for @return static).

It doesn't work either by now, but I'll try to implement it.
Comment 6 Ondrej Brejla 2013-01-15 15:59:37 UTC
Fixed in web-main #f2368dd7777f
Comment 7 Quality Engineering 2013-01-30 03:42:04 UTC
Integrated into 'main-golden', will be available in build *201301300001* on (upload may still be in progress)
User: Ondrej Brejla <>
Log: #196564 and #196565 - Allow "self", "static" and "this" in a @return annotation (improved type inference)

By use of this website, you agree to the NetBeans Policies and Terms of Use. © 2014, Oracle Corporation and/or its affiliates. Sponsored by Oracle logo