README

Overview

PHPCheckstyle is an open-source tool that helps PHP programmers adhere to certain coding conventions. The tools checks the input PHP source code and reports any deviations from the coding convention.

The tool uses the PEAR Coding Standards as the default coding convention. But it allows you to configure it to suit your coding standards.

Please visit https://github.com/PHPCheckstyle/phpcheckstyle/wiki for more information and documentation

Requirements

• PHP 5.0 or newer.
• Web browser to view the checkstyle report (only for html view)
• That's all.

Installation

Installation with Composer

composer require phpcheckstyle/phpcheckstyle

or Add phpcheckstyle/phpcheckstyle as a requirement to composer.json:

{
    "require": {
        "phpcheckstyle/phpcheckstyle": "dev-master"
    }
}

Update your packages with composer update or if installing from fresh, with composer install.

Manual Installation

Just download https://github.com/PHPCheckstyle/phpcheckstyle/archive/master.zip and unzip the distribution.

$> unzip PhpCheckstyle.zip

This will create a directory called phpcheckstyle and expand all files in it.

Testing with Vagrant

• install VirtualBox

• install Vagrant

• launch vagrant up in the project root directory to start the VM

• In case of problem with the "guest additions", launch :

vagrant plugin install vagrant-vbguest

• to run PHPCheckstyle on itself, type vagrant provision --provision-with run_phpcheckstyle
• to run PHPUnit, type vagrant provision --provision-with run_phpunit
• to log inside the VM, type vagrant ssh

Usage

• Change directory to the PHPCheckstyle installation directory.

  $> cd phpcheckstyle

• Execute the run.php script providing the --src option.

  $> php run.php --src <php source directory/file>

• Use the --help option to see more options

  $> php run.php --help

License

See LICENSE