If you search a fork project, check it out: https://github.com/Celc/CIUnit
If you use CodeIgniter 3.0, I recommend to check my new testing tool: https://github.com/kenjis/ci-phpunit-test
- 2020/03/14: Because Bitbucket shut down Mercurial repos, I moved this repo to GitHub.
- 2015/05/10: I'm building a new testing tool for CodeIgniter 3.0 with PHPUnit, check it out: https://github.com/kenjis/ci-phpunit-test
- 2014/06/11: If you search a fork with recent activity, check it out: https://github.com/Celc/CIUnit
- 2014/06/08: I am not using and maintaining this CIUnit. Sorry.
Originally created by: Clemens "rafsoaken" Gruenberger
Modified and Updated by:
- Mario "Kuroir" Ricalde
- Grzegorz "Grisha" Godlewski
- Tatsuya Fukata
- Kenji "kenjis" Suzuki
- "default" branch is for CodeIgniter 2.1.0.
- To CodeIgniter 2.0.3 users, please use "CI 2.0.3" branch. You can get the latest code from https://bitbucket.org/kenjis/my-ciunit/get/CI%202.0.3.zip
- Known Issues: See https://bitbucket.org/kenjis/my-ciunit/wiki/Home
- CIUnit was updated to work completely with CodeIgniter 2.0.3.
- CIUnit is completely separated from the CodeIgniter Core Files.
- CIUnit has it's own modified core files and will load them only when needed (by using the console for instance).
- CIUnit won't use the system index.php anymore, instead it'll use application/third_party/CIUnit/bootstrap_phpunit.php
- This is to prevent CIUnit/Foostack to cause any extra load on production.
- application/third_party/CIUnit/bootstrap_phpunit.php (Application and System Folder)
- tests/phpunit.xml (Optional: only edit if you want to move bootstrap_phpunit.php)
$ cd ciunit
$ tools/install.sh CI2_Project_Path [DB_Name [DB_User [DB_Passwd [DB_host]]]]
$ cp -R ciunit/application CI2_Project_Path/
$ cp -R ciunit/tests CI2_Project_Path/
create application/config/testing/database.php for database testing. Database name must end with "_test".
If you use MY_Loader, MY_Output, MY_Session, please change the parent classes below:
- application/third_party/CIUnit/core/CIU_*.php
- application/third_party/CIUnit/libraries/CIU_*.php
All Tests:
$ cd [CI2 Project Path]/tests
$ phpunit
Some Tests:
$ cd [CI2 Project Path]/tests
$ phpunit models
Single Test:
$ cd [CI2 Project Path]/tests
$ phpunit models/PhoneCarrierModelTest.php
Limitation:
- You must execute all tests in index() function of testing controllers.
Example:
function index()
{
$this->test_no_additional_headers();
$this->test_x_forwarded_for();
$this->test_client_ip();
$this->test_x_forwarded_for_and_client_ip();
echo $this->unit->report();
}
See tests/controllers/CI_Unit_Test_class_Test.php. In test_CI_Unit_Test_Class() function, set the folder where testing controllers are in.
$test_path = APPPATH . 'controllers';
$test_folder = 'tests';
It runs all *.php files in "application/controllers/tests" folder.
PHPUnit shows all test file names and failed test names. If more than one test fails, PHPUnit reports 1 failure, even if 100 fails occurres.
If you are not familiar with PHPUnit/CIUnit, tutorial below may help you.
- How to use PHPUnit (CIUnit) with CodeIgniter 2.1.0 https://kenji-s.hatenadiary.org/entry/20120117/1326763908
- Database Testing of CodeIgniter Application with PHPUnit (CIUnit) https://kenji-s.hatenadiary.org/entry/20120118/1326848578