Skip to content
BDD framework for PHP 5.3+
PHP Cucumber


Behat is a BDD framework for PHP to help you test business expectations.

Gitter chat License Build Status HHVM Status Scrutinizer Quality Score Total Downloads

Installing Behat

The easiest way to install Behat is by using Composer:

$> curl -sS | php
$> php composer.phar require behat/behat='~3.0.6'

After that you'll be able to run Behat via:

$> vendor/bin/behat

Installing Development Version

Clone the repository and install dependencies via Composer:

$> curl -sS | php
$> php composer.phar install

After that you will be able to run development version of Behat via:

$> bin/behat


Before contributing to Behat, please take a look at the document.


Starting from v3.0.0, Behat is following Semantic Versioning v2.0.0. This basically means that if all you do is implement interfaces (like this one) and use service constants (like this one), you would not have any backwards compatibility issues with Behat up until v4.0.0 (or later major) is released. Exception could be an extremely rare case where BC break is introduced as a measure to fix a serious issue.

You can read detailed guidance on what BC means in Symfony2 BC guide.

Useful Links


Something went wrong with that request. Please try again.