phpdoc for inherited method

Question

I have class A with some method that returns bool value. I made phpdoc for that method.

I made another class B which extends class A and overrides method. New method returns string. (I understand that in common case change the return type is not a good idea, but in my case it's a good way.)

I want to make phpdoc for new method. I could use {@inheritDoc}, but it takes full phpdoc from old method. I want to take from old phpdoc general method description and specification of arguments, but change description of return value.

How could I do it?

Have a look at {@see}

Mark Baker
– Mark Baker

2014-06-05 16:12:25 +00:00
Commented Jun 5, 2014 at 16:12 — Mark Baker
– Mark Baker, Commented Jun 5, 2014 at 16:12
Yes, I will use @see. Thank you )

Victor Mezrin
– Victor Mezrin

2014-06-05 16:36:25 +00:00
Commented Jun 5, 2014 at 16:36 — Victor Mezrin
– Victor Mezrin, Commented Jun 5, 2014 at 16:36

Kirill Fuchs · Accepted Answer · 2014-06-05 16:36:42Z

9

Based on the phpDocumentor manual for inheritance methods will inherit without the need for an inline {@inheritDoc} tag and you can override tags as you see fit.

Inheritance for methods functions similar to classes and interfaces. When a superclass of the current class contains a method with the same name (hence, this method is re-defined) then the following information is inherited from that overridden method:

Summary

Description

The following tags:

author

copyright

version

param

return

throws

As with classes, each of the above will only be inherited if the redefined method’s DocBlock does not have the element that is to be inherited. So, for example, if the DocBlock of the redefined method has a summary then it will not receive the overridden method’s summary.

However from experience IDE's handle parsing this data in their own way and hence results may vary. For example, in IntelliJ/PHPStorm the parent method docs will be inherited but you can either override everything or nothing.

edited Jun 5, 2014 at 16:36

answered Jun 5, 2014 at 16:30

Kirill Fuchs

13.7k4 gold badges44 silver badges73 bronze badges

Sign up to request clarification or add additional context in comments.

1 Comment

Victor Mezrin Over a year ago

Oh, now I understand. I read manual, but {@inheritDoc} didn't worked. That's because I use phpstorm... )) Thank you

Collectives™ on Stack Overflow

phpdoc for inherited method

1 Answer 1

1 Comment

Your Answer

Hot Network Questions

Collectives™ on Stack Overflow

1 Answer 1

1 Comment

Your Answer

Sign up or log in

Post as a guest

Related