Boost PHP Code Quality with Behat: End‑to‑End Testing Made Simple

Improving PHP code quality is a major challenge; this series teaches you practical ways to raise it, and the final part focuses on establishing an end‑to‑end/integration testing environment.

Installing Behat

Use Composer to add the development dependency:

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

Add a Behat target to build.xml :

<code><target name="behat">
  <exec executable="bin/behat" passthru="true" checkreturn="true"/>
</target>
…
<target name="run" depends="phpcs,phpcpd,phan,phpspec,behat"/>
</code>

Writing a Feature

Create features/price.feature with a readable scenario:

<code>Feature: Price Comparison
  In order to compare prices
  As a customer
  I need to break the currency barrier

  Scenario: Compare EUR and PLN
    Given I use nbp.pl comparator
    When I compare "100EUR" and "100PLN"
    Then it should return some result
</code>

Generate step definitions with:

<code>$ bin/behat-init</code>

The generated FeatureContext.php contains skeleton methods for each step, which you fill with PHP logic to interact with your domain objects.

Running the Tests

Execute the suite with:

<code>$ bin/behat --dry-run --append-snippets</code>

Behat will create methods for each step, and you can implement the actual checks, such as verifying that the comparison result is an integer.

Test Structure Overview

Each scenario consists of:

Preparation steps in the Given section

Actions in the When section

Assertions in the Then section

Multiple steps can be chained with the And keyword.

Contexts

Behat supports multiple contexts, allowing you to separate web‑level tests from domain‑level logic, making it easier to test business rules independently from the full application stack.

Summary of Tools Used in the Series

PHing – build automation

PHPCS – coding standards checking

PHPCPD – duplicate code detection

Phan – advanced static analysis

PHPSpec – unit testing

Behat – end‑to‑end and integration testing

Integrate these tools into your CI pipeline and commit hooks to ensure every change is validated, dramatically raising the overall quality of your PHP projects.