Boost PHP Code Quality: Essential Tools and Automated Testing Setup

Improving PHP code quality can be challenging, but by following this guide you can set up a basic quality‑testing environment for your project without focusing on any specific tool.

Prerequisites

You should be familiar with PHP 7.1 syntax, use Composer with PSR‑4 autoloading, and follow PSR‑1 & PSR‑2 coding standards. In the examples the vendor binaries are installed to the ./bin directory.

1. Build Tool (PHING)

Install PHING, which works like Apache Ant, using a single Composer command:

<code>$ php composer.phar require --dev phing/phing</code>

Create a minimal build.xml in the project root:

<code><?xml version="1.0" encoding="UTF-8"?>
<project name="MyProject" default="run">
</project>
</code>

Additional targets will be added in the following sections.

2. Static Code Analysis

PHING can run various testing tools with a single script. After installing the required tools, add a target to build.xml that executes them.

3. Code Style (PHP_CodeSniffer)

Install the code‑sniffing tool:

<code>$ php composer.phar require --dev squizlabs/php_codesniffer</code>

Add a phpcs target to build.xml :

<code><project name="MyProject" default="run">
  <target name="phpcs" description="Check code style with PHP_CodeSniffer">
    <exec executable="bin/phpcs" passthru="true" checkreturn="true">
      <arg line="--standard=PSR1,PSR2 -extensions=php src"/>
    </exec>
  </target>
  <target name="run" depends="phpcs"/>
</project>
</code>

Running ./bin/phing will now automatically report any PSR‑1/PSR‑2 violations.

4. Duplicate Code Detection (PHPCPD)

Install the copy‑paste detector:

<code>$ php composer.phar require --dev sebastian/phpcpd</code>

Add a phpcpd target:

<code><target name="phpcpd" description="Generate pmd-cpd.xml using PHPCPD">
  <exec executable="bin/phpcpd" passthru="true">
    <arg line="src"/>
  </exec>
</target>
<target name="run" depends="phpcs,phpcpd"/>
</code>

Sample output shows the number of duplicated code blocks found.

5. Deep Code Analysis (Phan)

Install Phan, a powerful static analyzer:

<code>$ php composer.phar require --dev phan/phan</code>

Create .phan/config.php :

<code><?php
return [
    'target_php_version' => '7.1',
    'directory_list' => ['src', 'vendor/symfony/console'],
    'exclude_analysis_directory_list' => ['vendor/'],
];
</code>

Add a Phan target to build.xml :

<code><target name="phan" description="Check code with Phan">
  <exec executable="bin/phan" passthru="true" checkreturn="true"/>
</target>
<target name="run" depends="phpcs,phpcpd,phan"/>
</code>

Running the target will produce detailed type‑mismatch and undefined‑method warnings.

Summary

With these three fully automated tools—PHP_CodeSniffer, PHPCPD, and Phan—your project can enforce coding standards, detect duplicated code, and catch deeper static analysis issues. Run ./bin/phing manually or integrate it into a git‑hook or CI pipeline to ensure consistent code quality and reduce manual review effort.