Codeception 0,-6,-5,1,4,0,-4,3

Full-stack testing PHP framework


Latest Stable Total Downloads Daily Downloads Gitter PHP 7 ready Scrutinizer Code Quality

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. Powered by PHPUnit.

General Windows Webdriver Facebook HHVM
Build Status Build status Build Status Facebook Status for Codeception/Codeception wercker status


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.

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 acceptance test


$I = new FunctionalTester($scenario);
$I->wantTo('create wiki page');
$I->see('New Page');
$I->submitForm('form#new_page', array('title' => 'Tree of Life Movie Review','body' => "Next time don't let Hollywood create art-house!"));
$I->see('page created'); // notice generated
$I->see('Tree of Life Movie Review','h1'); // head of page of is our title
$I->seeInCurrentUrl('pages/tree-of-life-movie-review'); // slug is generated
$I->seeInDatabase('pages', array('title' => 'Tree of Life Movie Review')); // data is stored in database

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



php composer.phar require "codeception/codeception"


Download codecept.phar

Copy it into your project.

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


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 | QuickStart

Getting Started

After you successfully installed Codeception, run this command:

codecept bootstrap

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



Documentation is included within the project. Look for it in the ‘docs’ directory.



© Michael Bodnarchuk “Davert” 2011-2017

Related Repositories



Visual regression tests for Codeception ...



Laravel5 module for Codeception. ...



Integrates Codeception framework into WordPress and allows run tests using WP CLI command. ...



Test emails in your Codeception acceptance tests ...



Перевод руководства по Codeception ...

Top Contributors

DavertMik Naktibalda tiger-seo janhenkgerritsen sergeyklay samdark zbateson splinter89 raistlin sd-tm horechek eXorus Ragazzo piccagliani TrustNik korotovsky allmyitjason enumag FnTm dizzy7 TumTum brutuscat javigomez dynasource sjableka antoniofrignani niclopez antonioribeiro igorsantos07 elazar


-   v1.0.1 zip tar
-   2.2.5 zip tar
-   2.2.4 zip tar
-   2.2.3 zip tar
-   2.2.2 zip tar
-   2.2.1 zip tar
-   2.2.0 zip tar
-   2.2.0-beta zip tar
-   2.2.0-RC2 zip tar
-   2.2.0-RC zip tar
-   2.1.11 zip tar
-   2.1.10 zip tar
-   2.1.9 zip tar
-   2.1.8 zip tar
-   2.1.7 zip tar
-   2.1.6 zip tar
-   2.1.5 zip tar
-   2.1.4 zip tar
-   2.1.3 zip tar
-   2.1.2 zip tar
-   2.1.1 zip tar
-   2.1.0 zip tar
-   2.1.0-rc1 zip tar
-   2.1.0-beta zip tar
-   2.0.16 zip tar
-   2.0.15 zip tar
-   2.0.14 zip tar
-   2.0.13 zip tar
-   2.0.12 zip tar
-   2.0.11 zip tar