PHPackages                             codeception/codeception - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Testing & Quality](/categories/testing)
4. /
5. codeception/codeception

ActiveLibrary[Testing & Quality](/categories/testing)

codeception/codeception
=======================

All-in-one PHP Testing Framework

5.3.5(3mo ago)4.9k86.2M—2%1.3k[151 issues](https://github.com/Codeception/Codeception/issues)[23 PRs](https://github.com/Codeception/Codeception/pulls)20MITPHPPHP ^8.2CI passing

Since May 28Pushed 2mo ago143 watchersCompare

[ Source](https://github.com/Codeception/Codeception)[ Packagist](https://packagist.org/packages/codeception/codeception)[ Docs](https://codeception.com/)[ Fund](https://opencollective.com/codeception)[ RSS](/packages/codeception-codeception/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (34)Versions (222)Used By (20)Security (1)

[![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct.svg)](https://stand-with-ukraine.pp.ua)

Codeception
===========

[](#codeception)

[![Latest Stable Version](https://camo.githubusercontent.com/01c414864bbe4312f9b04f024b1c7939a16614c78b6c552c1e7ce964f7f95ca5/68747470733a2f2f706f7365722e707567782e6f72672f636f646563657074696f6e2f636f646563657074696f6e2f76)](https://packagist.org/packages/codeception/codeception)[![Total Downloads](https://camo.githubusercontent.com/4c92e0985278d2a311c2f41992aaa7b66840165fbad3e1387fcd80666c053aaa/68747470733a2f2f706f7365722e707567782e6f72672f636f646563657074696f6e2f636f646563657074696f6e2f646f776e6c6f616473)](https://packagist.org/packages/codeception/codeception)[![Monthly Downloads](https://camo.githubusercontent.com/032c35211a9f73ee700d5ddf937e54496dbc199c23b5c2b778f57d5873a6c7f9/68747470733a2f2f706f7365722e707567782e6f72672f636f646563657074696f6e2f636f646563657074696f6e2f642f6d6f6e74686c79)](https://packagist.org/packages/codeception/codeception)[![Daily Downloads](https://camo.githubusercontent.com/adea37bea090a68ba12d81bc7a6386fcbc9a4b54f71391ec1f925d422f0a027b/68747470733a2f2f706f7365722e707567782e6f72672f636f646563657074696f6e2f636f646563657074696f6e2f642f6461696c79)](https://packagist.org/packages/codeception/codeception)[![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)[![Build status](https://github.com/Codeception/Codeception/workflows/build/badge.svg)](https://github.com/Codeception/Codeception/actions?query=workflow%3Abuild)

**Modern PHP Testing for everyone**

Codeception is a modern full-stack testing framework for PHP. Inspired by BDD, it provides an absolutely new way of writing acceptance, functional and even unit tests.

#### Contributions

[](#contributions)

At Codeception we are glad to receive contributions from the community. If you want to send additions or fixes to the code or the documentation please check the [Contributing guide](https://github.com/Codeception/Codeception/blob/5.0.0/CONTRIBUTING.md).

### At a Glance

[](#at-a-glance)

Describe what you test and how you test it. Use PHP to write descriptions faster.

Run tests and see what actions were taken and what results were seen.

#### Sample test

[](#sample-test)

```
$I->amOnPage('/');
$I->click('Pages');
$I->click('New');
$I->see('New Page');
$I->submitForm('form#new_page', ['title' => 'Movie Review']);
$I->see('page created'); // notice generated
$I->see('Movie Review','h1'); // head of page of is our title
$I->seeInCurrentUrl('pages/movie-review'); // slug is generated
$I->seeInDatabase('pages', ['title' => 'Movie Review']); // data is stored in database
```

For unit testing you can stay on classic PHPUnit tests, as Codeception can run them too.

Installation
------------

[](#installation)

### Composer

[](#composer)

```
composer require "codeception/codeception" --dev
```

### Phar

[](#phar)

Download [codecept.phar](https://codeception.com/codecept.phar)

Copy it into your project.

You can also make Codeception an executable and it put it into your `$PATH`, for instance:

```
wget https://codeception.com/codecept.phar

chmod +x codecept.phar

sudo mv codecept.phar /usr/local/bin/codecept

```

You can then run Codecept in the command line using: `codecept bootstrap`, `codecept run`, etc

Run CLI utility:

```
php codecept.phar

```

See also [Installation](https://codeception.com/install) | **[QuickStart](https://codeception.com/quickstart)**

Getting Started
---------------

[](#getting-started)

After you successfully installed Codeception, run this command:

```
codecept bootstrap

```

This will create a default directory structure and default test suites.

Documentation
-------------

[](#documentation)

[View Documentation](https://codeception.com/docs/Introduction)

The documentation source files can be found at .

License
-------

[](#license)

[MIT](https://github.com/Codeception/Codeception/blob/master/LICENSE)

###  Health Score

85

—

ExcellentBetter than 100% of packages

Maintenance84

Actively maintained with recent releases

Popularity83

Widely adopted with strong download metrics

Community70

Healthy contributor diversity

Maturity95

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 53% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~23 days

Recently: every ~70 days

Total

216

Last Release

90d ago

Major Versions

4.1.30 → 5.0.0-alpha32022-03-11

4.1.31 → 5.0.0-RC12022-03-13

4.2.1 → 5.0.0-RC42022-06-22

4.2.2 → 5.0.12022-08-13

4.2.3-beta4 → 5.0.32022-09-30

PHP version history (10 changes)1.0.9PHP >=5.3.2

1.5.0PHP >=5.3.3

2.0.0-alphaPHP >=5.4.0

1.8.4PHP >=5.3.19

2.1.7PHP >=5.4.0 <8.0

2.4.2PHP >=5.6.0 <8.0

4.1.9PHP >=5.6.0 <9.0

5.0.0-alpha1PHP ^8.0

5.2.0PHP ^8.1

5.3.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/395992?v=4)[Gintautas Miselis](/maintainers/Naktibalda)[@Naktibalda](https://github.com/Naktibalda)

![](https://avatars.githubusercontent.com/u/97648?v=4)[davert](/maintainers/davert)[@davert](https://github.com/davert)

![](https://www.gravatar.com/avatar/18b13c534e3812b66a72645fe215301b54fc4d288f6396fee9385b681e27da18?d=identicon)[SamMousa](/maintainers/SamMousa)

![](https://www.gravatar.com/avatar/c51faf2ab1bce1a51578471f61a881b3de1b7d834b17a1f2de163bb5bcb7efe0?d=identicon)[TavoNiievez](/maintainers/TavoNiievez)

---

Top Contributors

[![DavertMik](https://avatars.githubusercontent.com/u/220264?v=4)](https://github.com/DavertMik "DavertMik (2914 commits)")[![Naktibalda](https://avatars.githubusercontent.com/u/395992?v=4)](https://github.com/Naktibalda "Naktibalda (1547 commits)")[![janhenkgerritsen](https://avatars.githubusercontent.com/u/1123080?v=4)](https://github.com/janhenkgerritsen "janhenkgerritsen (202 commits)")[![tiger-seo](https://avatars.githubusercontent.com/u/398720?v=4)](https://github.com/tiger-seo "tiger-seo (188 commits)")[![sergeyklay](https://avatars.githubusercontent.com/u/1256298?v=4)](https://github.com/sergeyklay "sergeyklay (77 commits)")[![samdark](https://avatars.githubusercontent.com/u/47294?v=4)](https://github.com/samdark "samdark (66 commits)")[![zbateson](https://avatars.githubusercontent.com/u/8356974?v=4)](https://github.com/zbateson "zbateson (61 commits)")[![TavoNiievez](https://avatars.githubusercontent.com/u/64917965?v=4)](https://github.com/TavoNiievez "TavoNiievez (61 commits)")[![ThomasLandauer](https://avatars.githubusercontent.com/u/1054469?v=4)](https://github.com/ThomasLandauer "ThomasLandauer (51 commits)")[![SamMousa](https://avatars.githubusercontent.com/u/547021?v=4)](https://github.com/SamMousa "SamMousa (34 commits)")[![W0rma](https://avatars.githubusercontent.com/u/20659830?v=4)](https://github.com/W0rma "W0rma (32 commits)")[![raistlin](https://avatars.githubusercontent.com/u/76889?v=4)](https://github.com/raistlin "raistlin (29 commits)")[![eXorus](https://avatars.githubusercontent.com/u/1255561?v=4)](https://github.com/eXorus "eXorus (27 commits)")[![gimler](https://avatars.githubusercontent.com/u/200904?v=4)](https://github.com/gimler "gimler (20 commits)")[![akovardin](https://avatars.githubusercontent.com/u/365223?v=4)](https://github.com/akovardin "akovardin (16 commits)")[![Arhell](https://avatars.githubusercontent.com/u/26163841?v=4)](https://github.com/Arhell "Arhell (16 commits)")[![Ragazzo](https://avatars.githubusercontent.com/u/1748844?v=4)](https://github.com/Ragazzo "Ragazzo (13 commits)")[![piccagliani](https://avatars.githubusercontent.com/u/3021304?v=4)](https://github.com/piccagliani "piccagliani (13 commits)")[![enumag](https://avatars.githubusercontent.com/u/539462?v=4)](https://github.com/enumag "enumag (13 commits)")[![korotovsky](https://avatars.githubusercontent.com/u/104727?v=4)](https://github.com/korotovsky "korotovsky (12 commits)")

---

Tags

acceptance-testingbddcodeceptionend-to-endhacktoberfestintegration-testingphpphpunittestingunit-testingunit testingfunctional-testingacceptance-testingBDDTDD

### Embed Badge

![Health badge](/badges/codeception-codeception/health.svg)

```
[![Health](https://phpackages.com/badges/codeception-codeception/health.svg)](https://phpackages.com/packages/codeception-codeception)
```

###  Alternatives

[behat/behat

Scenario-oriented BDD framework for PHP

4.0k96.8M2.0k](/packages/behat-behat)[brianium/paratest

Parallel testing for PHP

2.5k118.8M754](/packages/brianium-paratest)[orchestra/testbench

Laravel Testing Helper for Packages Development

2.2k39.1M32.1k](/packages/orchestra-testbench)[phpspec/phpspec

Specification-oriented BDD framework for PHP 7.1+

1.9k36.7M3.1k](/packages/phpspec-phpspec)[infection/infection

Infection is a Mutation Testing framework for PHP. The mutation adequacy score can be used to measure the effectiveness of a test set in terms of its ability to detect faults.

2.2k26.2M1.8k](/packages/infection-infection)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)