To be able to run PHP analyses with Sonar, you will need 2 things:
- Sonar installed with its PHP plugin
- All the PHP environment (PHP and tools that are required by the plugin)
Install Sonar PHP Plugin
Sonar PHP Plugin is very straightforward: once you have installed sonar in "$SONAR_HOME" directory, just copy the sonar-php-plugin.jar file inside "$SONAR_HOME/extensions/plugins" directory.
Install PHP environnement
This installation section provides two ways for installing necessary tools to make the plugin work correctly. If you are familiar with the PHP environnement, you may just need to reed the "Short way" section, if you need more help, you can follow the more verbose installation guide.
Short way for PHP experts
- Install PHP runtime with the corresponding xdebug extensions. Version 5.2.6 or newer is required.
- Install PEAR. Version 1.8.0 or newer is required
- Install the following PEAR packages (check the version list to know which versions to install):
- Install PHPUnit
- Install phpcpd
- Install PHPDepend
- Install PHPMD
- Install PHP_CodeSniffer
Long way for PHP dummies
- Install PHP version 5.2.6 or newer. You can download PHP at this location and follow these installation instructions.
- Install PEAR version 1.8.0 or newer if not included in PHP distribution. To ensure pear version and to upgrade it type the following commands in command prompt:
If you, for some reason, need the latest PEAR and the commands above don't get it then download http://pear.php.net/go-pear.phar and execute it with php (don't use the old go-pear without the .phar extension, it will likely fail):
- Install PHPUnit from pear using the following command lines:
- Install XDebug to allow code instrumentation used for instance by phpunit to compute coverage.
- If you are running Linux or Mac you must install phpize (normally found in php dev packages like rpm php5-devel, deb php5-dev) and then compile xdebug via pecl install using the following command line
And then edit your $PHP_HOME/cli_php.ini file to add the following line:
- If you are running windows, you should download the binary version matching your PHP installation from this location. And then edit your $PHP_HOME/cli_php.ini file to add the following line:
- If you are running Linux or Mac you must install phpize (normally found in php dev packages like rpm php5-devel, deb php5-dev) and then compile xdebug via pecl install using the following command line
- Install PHP Depend
- Install PHPMD
- Install PHP_CodeSniffer
- Install phpcpd
You're done!
You are now ready to configure your projet for a first analysis. Go to "Analyse a PHP project" to know how to launch a Sonar analysis on your project.

