Codeception

Full-stack testing PHP framework

3 years after

Codeception Latest Stable Total Downloads

Modern PHP Testing for everyone

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

release branch status
Stable 1.8 Build Status Dependencies Status
Current 2.0 Build Status
Edge master Build Status Dependencies Status

Contributions

Bugfixes should be sent to to current stable branch, which is the same as major version number. Breaking features and major improvements should be sent into master. When you send PRs to master, they will be added to release cycle only when the next stable branch is started.

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

<?php

$I = new FunctionalTester($scenario);
$I->wantTo('create wiki page');
$I->amOnPage('/');
$I->click('Pages');
$I->click('New');
$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.

Documentation

Documentation on Github

Documentation is currently included within the project. Look for it in the 'docs' directory.

Installation

Phar

Download codecept.phar

Copy it into your project.

Run CLI utility:

php codecept.phar

Composer

php composer.phar require "codeception/codeception:*"

Read Also Installation | QuickStart

Getting Started

If you successfully installed Codeception, run this command:

codecept bootstrap

this will create a default directory structure and default test suites

See Documentation for more information.

License

MIT

(c) Michael Bodnarchuk "Davert" 2011-2014

Related Repositories

codeception-module-visualception

codeception-module-visualception

Visual regression tests for Codeception ...

wp-codeception

wp-codeception

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

yii2-codeception

yii2-codeception

Yii 2 Codeception extension. ...

Codeception.docs.ja_JP

Codeception.docs.ja_JP

Codeception docs ja_JP translation ...

Codeception-Mailtrap

Codeception-Mailtrap

Codeception module to test email using Mailtrap.io ...


Top Contributors

DavertMik tiger-seo horechek Ragazzo korotovsky allmyitjason piccagliani brutuscat TrustNik FnTm enumag cujo kenden phpcodemonkey igorsantos07 srosato elazar artyfarty mohangk Tro95 gchaincl vinu qiangxue jonphipps kop pfaocle Fuhrmann ZloeSabo tommyd3mdi csavio

Releases

-   v1.0.1 zip tar
-   2.0.1 zip tar
-   2.0.0 zip tar
-   2.0.0-beta zip tar
-   2.0.0-alpha zip tar
-   2.0.0-RC2 zip tar
-   2.0.0-RC zip tar
-   1.8.6 zip tar
-   1.8.5 zip tar
-   1.8.4 zip tar
-   1.8.3 zip tar
-   1.8.2 zip tar
-   1.8.1 zip tar
-   1.8.0.1 zip tar
-   1.8.0 zip tar
-   1.7.4 zip tar
-   1.7.3 zip tar
-   1.7.2 zip tar
-   1.7.1 zip tar
-   1.7.0.2 zip tar
-   1.7.0.1 zip tar
-   1.7.0 zip tar
-   1.6.12 zip tar
-   1.6.11 zip tar
-   1.6.8.1 zip tar
-   1.6.8 zip tar
-   1.6.7 zip tar
-   1.6.6 zip tar
-   1.6.5 zip tar
-   1.6.4.2 zip tar