Skip to content
Full-stack testing PHP framework
Branch: 3.0
Clone or download
Naktibalda Merge pull request #5415 from bbatsche/fix-ftp-directory
[FTP] Make sure _directory() will return its directory
Latest commit 3df7fc7 Jun 20, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
docs Ability to use a custom cookie domain for code coverage (#5539) Jun 19, 2019
ext Adding timestamp information in recordings (#5463) Apr 23, 2019
package Snapshots (#5165) Sep 20, 2018
src/Codeception Merge pull request #5415 from bbatsche/fix-ftp-directory Jun 20, 2019
tests Merge pull request #5553 from Codeception/issue/5547 Jun 19, 2019
.gitattributes Ignore files when exporting package (#5527) Jun 2, 2019
.gitignore PHPUnit 7 support (#4799) Feb 17, 2018
.travis.yml stiblilizing Laravel tests Apr 22, 2019 [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 preparing 3.0.1 release May 20, 2019 Updated (#3751) Nov 17, 2016
Dockerfile Fixing autoloader generation for 3.0 docker images (#5514) May 20, 2019 [WIP] Clean up (#4720) Jan 7, 2018
LICENSE Fixes #2207: added license file Jul 23, 2015
PruneTest.php Removed ZF1 module (#5445) Mar 24, 2019 Documented release process, reverted last change to Robofile Feb 3, 2019
RoboFile.php preparing 3.0.1 release May 20, 2019
appveyor.yml Correct Windows entrypoint (codecept.bat) (#5265) Dec 4, 2018
autoload.php Implement --no-redirect for disabling the redirect to a Composer-inst… May 20, 2019
codecept Snapshots (#5165) Sep 20, 2018
codecept.bat Correct Windows entrypoint (codecept.bat) (#5265) Dec 4, 2018
codeception.yml Removed ZF1 module (#5445) Mar 24, 2019
composer.json Console (#5450) Mar 26, 2019
nitpick.json Support for PHPUnit 6 Apr 25, 2017 updated readme Apr 24, 2019
ruleset.xml PSR-2 compliance (#3105) May 16, 2016
shim.php Update shim.php (#5013) Jun 20, 2018


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"


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.



(c) Codeception Team 2011-2019

You can’t perform that action at this time.