mvriel/Docblox — comment on commit 589ebad154ba881b6998425d81eaf677023a5b3c
File: docs/PSR.md line 514
By ashnazg:

My take on the void vs null thing is that the docs utilize the return tag in order to know how to display the overall method signature. In this context, I think "void foo ($para1, $para2)" is more proper than "null foo ($para1, $para2)".

The only use case where I'd see myself using "return null" is if I'm trying to convey to the reader that he should look for an explicit "null" to be returned, and that knowing that the null was returned really does communicate something useful from the method to its caller.

I think the far more general case is of a method that is meant to not return anything, and therefore I'd want my API doc to tell the reader that the method is of the "return void" variety.