PHPDoc: @return void necessary?

Question

Is it really necessary do something like this:

/**
 * ...
 * 
 * @return void
 */

I have quite a few methods that don\'t have a return valu

Answer 1

As of php 7.1, void is a valid return type and can be enforced on a function.

I would always add it on the docblock.

Another benefit of writing it, is to differentiate the void methods from the methods that may return anything but don't have a @return entry on the docblock by negligence.