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

Gitter chat License Unix Status Windows status HHVM Status Scrutinizer Quality Score

Installing Behat

The easiest way to install Behat is by using Composer:

$> curl -sS | php
$> php composer.phar require behat/behat

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


Related Repositories



Laravel extension for Behat functional testing. ...



Launch Behat tests from your browser ...



To help developers to easily understand how to do feature tests with Behat, and to start writing feature tests for REST APIs. ...



Testing with Behat in your Laravel application. ...



Helps you debug Behat scenarios by stopping execution in between steps ...

Top Contributors

everzet stof wouterj james75 ciaranmcnulty muhqu headrevision davedevelopment benji07 sky-glenjamin rajeshtaneja robocoder stloyd freecastle veloce jakzal RichardBradley sherakama Herzult alistairstead docteurklein micheleorselli FGM Chriton estevejm polterix Slamdunk alfrekjv irfan jakob-erdmann


package version
php >=5.3.3
ext-mbstring *
behat/gherkin ^4.4.4
behat/transliterator ^1.2
symfony/console ~2.5||~3.0
symfony/config ~2.3||~3.0
symfony/dependency-injection ~2.1||~3.0
symfony/event-dispatcher ~2.1||~3.0
symfony/translation ~2.3||~3.0
symfony/yaml ~2.1||~3.0
symfony/class-loader ~2.1||~3.0
container-interop/container-interop ^1.1
dev symfony/process ~2.5|~3.0
phpunit/phpunit ~4.5
herrera-io/box ~1.6.1


-   v3.2.1 zip tar
-   v3.2.0 zip tar
-   v3.2.0rc2 zip tar
-   v3.2.0rc1 zip tar
-   v3.1.0 zip tar
-   v3.1.0rc2 zip tar
-   v3.1.0rc1 zip tar
-   v3.0.15 zip tar
-   v3.0.14 zip tar
-   v3.0.13 zip tar
-   v3.0.12 zip tar
-   v3.0.11 zip tar
-   v3.0.10 zip tar
-   v3.0.9 zip tar
-   v3.0.8 zip tar
-   v3.0.7 zip tar
-   v3.0.6 zip tar
-   v3.0.5 zip tar
-   v3.0.4 zip tar
-   v3.0.3 zip tar
-   v3.0.2 zip tar
-   v3.0.1 zip tar
-   v3.0.0 zip tar
-   v3.0.0rc3 zip tar
-   v3.0.0rc2 zip tar
-   v3.0.0rc1 zip tar
-   v3.0.0beta8 zip tar
-   v3.0.0beta7 zip tar
-   v3.0.0beta6 zip tar
-   v3.0.0beta5 zip tar