Sonar PHP Plugin

Features

The plugin enables analysis of PHP projects within Sonar. This plugin handles a few analysis tools for PHP projects : PHP Unit, PHP Depend, PHPMD and SQLI CodeSniffer.

And of course all built-in functionality of Sonar are available : dashboard, drilldown, clouds...

Installation

1. Install PHP
   1. PHP at least 5.2.6 is required for this procedure and the plugins to work smoothly
2. Install PEAR if not included in PHP distribution
   1. Make sure your PEAR version is strictly bigger than 1.8.0
   2. (tutorial for MacOS X Leopard)
3. Install PHP Unit
4. Install XDebug
   1. On Linux/Mac
      1. you must have phpize installed, normally found in php dev packages like rpm php5-devel, deb php5-dev, ...
      2. compile xdebug via a pecl install
      4. This will create an extension xdebug.so
   2. Windows users must instead use the binaries. Find the right one here
   3. You must add this line to your cli php.ini
5. Install PHP Depend
6. Install PHPMD
7. Install SQLI_CodeSniffer
   1. Follow the instructions here
8. Copy the sonar plugins (.jar file) to /extensions/plugins/ directory
9. Restart Sonar Web server

Known limitations

This is an alpha version so we expect it to have a lot of bugs/uncovered cases. Please report all bugs you find on Jira.

Metrics in this version are only collected by PHP_Depend, this implies that files containing unstructured code (not OO) will not be included in this kind of analysis.
It is known that copy/paste detection is wrongly extended to comments (see #218).
The actual CodeSniffer standard used by default is just a demo one.
You can include other standards with their configuration files the "SQLI_CodeSniffer way".
We suggest you to wait for the 1.3.0 release of PHP_CodeSniffer that will bring extended configuration capabilities and will be rapidly integrated with the plugins.

Changelog