Releases & version support

Behat follows Semantic Versioning - breaking changes will only be made in a major release.

Supported versions

Major

Released

Bugfix EOL

Security EOL

v3.x

April 2014

See below

See below

Changelog

As a minimum, a major version series will receive:

  • Bugfixes for 12 months after the release of the next major.

  • Security fixes for 24 months after the release of the next major.

Each time a new major version is released, the Behat maintainers will set End-of-Life dates for the previous version series. This will be based on the scale of the breaking changes, the complexity of supporting the older version, and the likely effort required for users and third-party extensions to upgrade.

Bugfixes will usually only be applied to the most recent minor of each supported major version, unless they are particularly severe or have security implications. This will impact support for End-of-Life PHP & Symfony versions.

Release timescales

There is no fixed schedule for releasing new major versions - but we will try to keep them to a frequency that is manageable for users.

Minor versions

Minor & patch versions will be released whenever there is something to release. These releases do not come with any specific support timescale, and we expect that users will upgrade to the next minor when it becomes available.

Please bear in mind that this is free software, maintained by volunteers as a gift to users, and the license specifically explains that it is provided without warranty of any kind.

Support for PHP and dependency versions

Behat only supports current versions of PHP and third-party dependency packages (e.g. Symfony components).

By “current”, we mean:

Once a PHP or Symfony version reaches End of Life we will remove it from our composer.json and CI flows.

Note

When we drop support for a PHP / dependency version we will highlight this in the CHANGELOG, but we will treat it as a minor release. Composer will automatically protect users from upgrading to a version that does not support their environment. Users running Behat as a .phar should review the release notes before downloading a new version.

We will not ship bugfix releases for unsupported PHP / dependency versions, unless:

  • It fixes a security vulnerability within the security support period for a Behat major version.

  • An external contributor wishes to take on the work of backporting, including any changes required to get a green build in CI.

End-of-Life versions

These behat series are no longer maintained and will not receive any further releases. We strongly recommend that users upgrade to a supported version as soon as possible.

Major

Released

Bugfix EOL

Security EOL

v2.x

July 2011

June 2015

June 2015

Changelog

Previous chapter
Creating a Behat extension to provide custom configuration for Contexts
Next chapter
Useful Resources