behat/behat

Scenario-oriented BDD framework for PHP

Fund package maintenance!
acoulton
stof
carlos-granados

Installs: 91 166 562

Dependents: 2 238

Suggesters: 19

Security: 0

Stars: 3 951

Watchers: 141

Forks: 614

Open Issues: 52

pkg:composer/behat/behat

v3.27.0 2025-11-23 12:12 UTC

README

Behat

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

Gitter chat License Build Status

Installing Behat

The easiest way to install Behat is by using Composer:

composer require --dev 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:

composer install

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

bin/behat

Contributing

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

Versioning

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 Symfony BC guide.

Useful Links

Contributors

Support the project

Behat is free software, maintained by volunteers as a gift for users. If you'd like to see the project continue to thrive, and particularly if you use it for work, we'd encourage you to contribute.

Contributions of time - whether code, documentation, or support reviewing PRs and triaging issues - are very welcome and valued by the maintainers and the wider Behat community.

But we also believe that financial sponsorship is an important part of a healthy Open Source ecosystem. Maintaining a project like Behat requires a significant commitment from the core team: your support will help us to keep making that time available over the long term. Even small contributions make a big difference.

You can support @acoulton, @carlos-granados and @stof on GitHub sponsors. If you'd like to discuss supporting us in a different way, please get in touch!

Technology Sponsors

Technology sponsors allow us to use their products and services for free as part of a contribution to the open source ecosystem and our work.

JetBrains