Skip to content
Full-stack testing PHP framework
PHP HTML Hack Other
Branch: 4.1
Clone or download

Latest commit

Latest commit 24f2345 May 24, 2020


Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Create FUNDING.yml Oct 13, 2019
ext Merge branch 'patch-2' of into … Feb 19, 2020
package Add all commands in a single place Nov 21, 2019
src/Codeception 4.1.5 May 24, 2020
tests Revert "Test custom reporter against all versions of PHPUnit" Mar 20, 2020
.dockerignore Docker image for Codeception 4 (#5917) May 24, 2020
.gitattributes Deleted links to /docs directory Nov 21, 2019
.gitignore Unified bootstrap loading (#5645) Aug 16, 2019
.travis.yml Support PHPUnit 9 Feb 7, 2020 [WIP] Clean up (#4720) Jan 7, 2018 [WIP] Clean up (#4720) Jan 7, 2018 [WIP] Clean up (#4720) Jan 7, 2018 Pre 2.3.9 (#4832) Feb 26, 2018 updated changelog, version bump Sep 24, 2018 version bump Apr 24, 2019 Updated changelog and version number for 3.0.3 Jul 18, 2019 Updated version number and changelog for 3.1.2 Oct 19, 2019 Prepared 4.0.3 release Jan 24, 2020 4.1.5 May 24, 2020 fix typo in Dec 4, 2019
Dockerfile Docker image for Codeception 4 (#5917) May 24, 2020 [WIP] Clean up (#4720) Jan 7, 2018
LICENSE Fixes #2207: added license file Jul 23, 2015
app.php fix cs issues Jan 23, 2020
appveyor.yml Declare module dependencies in require-dev (#5772) Dec 3, 2019
autoload.php Fixed --no-redirect option does not exist error Mar 4, 2020
codecept Moved require autoload.php to app.php Nov 21, 2019
codecept.bat Correct Windows entrypoint (codecept.bat) (#5265) Dec 4, 2018
codeception.yml Unified bootstrap loading (#5645) Aug 16, 2019
composer.json Support PHPUnit 9 Feb 7, 2020
nitpick.json Support for PHPUnit 6 Apr 25, 2017 Deleted links to /docs directory Nov 21, 2019
ruleset.xml PSR-2 compliance (#3105) May 16, 2016
shim.php Symfony 5: EventDispatcher\Event was moved to different namespace Nov 24, 2019


Latest Stable Total Downloads 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
Build Status Build status Build 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 test

$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.



php composer.phar require "codeception/codeception"

TODO: Document how to install the modules, e.g.

php composer.phar require "codeception/module-phpbrowser"


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.


View Documentation

The documentation source files can be found at



(c) Codeception Team 2011-2019

You can’t perform that action at this time.