Docblocks may become as evil as comments when they’re not treated as first-class citizens (see: Meaningless docblocks).
PHPADD can analyze a directory with PHP source code and detect (for each file, for each class, for each method) if the parameters in the function declaration are compatible with the parameters found in the docblock, reporting the outdated ones.
This can be easily integrated in your build script and the result can be published in build result. Using Hudson, you just need HTML Publisher plugin.
With PEAR it is very simple. On Linux, you may need to prefix each command with
pear channel-discover pear.webmatters.it pear install webmatters/phpadd
Once installed it responds to
phpadd from your console.
phpadd --publish-html /tmp/output.html directory/to/analyze
This command will produce an output like this.
Please note, phpadd has to be improved. For example, it needs to ignore warning on files/classes/methods matching a given regular expression (controller classes, for example).
Or the difference between docblock params and function params: it is not so smart.
If you want to help, fork it on GitHub!