一、环境配置

1. 下载 http://codeception.com/codecept.phar

2. 将codecept.phar放到项目文件夹下，打开终端（我是mac机器）并cd到该文件夹执行 php codecept.phar bootstrap

3. 如果suit文件改变时，一般会相应的action会实时更新，否则执行 php codecept.phar build

二、编写/运行testcase（以acceptance tests为例）

1. 新建一个testcase

终端执行 php codecept.phar generate:cept acceptance Signin  

执行上述命令的结果是在tests/acceptance/下面，新建了一个testcase class：SigninCept.php。注意这里所有的testcase class后面都会有“Cept”，“Cept”的作用是告诉codeception这是一个有效的场景，可以执行。

2. 编辑testcase

打开刚才新建的文件（我用的是phpstorm），编辑

<?php 
$I = new AcceptanceTester($scenario);
$I->wantTo('perform actions and see result');
$I->amOnPage('/');
$I->click('Sign In');
$I->see('Home');

3. 编辑suite.yml文件

每种actor都对应一个suite.yml文件，打开 tests/acceptance.suite.yml，修改config中的url，如下所示

<strong>config:
        PhpBrowser:
         url : 'http://www.xxx.com'</strong>

4. 运行test case

终端执行 php codecept.phar run acceptanceSigninCept.php
执行结果：

Codeception PHP Testing Framework v2.0.7
Powered by PHPUnit 4.3.4 by Sebastian Bergmann.

Acceptance Tests (1) --------------------------------------------------------------------------------------------------------------------
Trying to perform actions and see result (SigninCept)                                                                      Ok
-----------------------------------------------------------------------------------------------------------------------------------------


Time: 6.54 seconds, Memory: 12.25Mb

OK (1 test, 1 assertion)

如果想运行整个suite 或者是所有的，codeception提供很多种testcase的运行方式将会在下面讲到。

三、生成报告

php codecept.phar run --steps --xml --html

将会生成.xml .html的报告在tests/_output/文件夹下

执行下面这句可以知道更多codeception的指令

php codecept.phar help run

四、将scenarios放到一个class里面

1.新建一个class：functional指定的时放到functional suits里面，TestDocumentUpload是class名称，class名称后面会自动带一个Cept

php codecept.phar generate:cest functional TestDocumentUpload

打开TestDocumentUploadCept.php，内容如下

<?php
use \FunctionalTester;

class TestDocumentUploadCest
{
    public function _before(FunctionalTester $I)
    {
    }

    public function _after(FunctionalTester $I)
    {
    }

    // tests
    public function tryToTest(FunctionalTester $I)
    {
    }
}

注意：除了以“_”开头的方法以外，每一个public的方法都会被当做test执行。也就是说如果你不想让你的方法被执行，就不要将你的方法设定为public

(2). 可以在class里面定义_failed方法。该方法将会执行如果case出错或者是失败

(3). @before @after @depends用于定义方法的执行顺序

(4). php codecept.phar bootstrap ~/projects/drupal/

5. PageObject

1.新建functional的page

php codecept.phar generate:pageobject functional UserLogin