Reasons for ZFTestManager

• Ability to isolate unit test suites and unit test tests.
• Ability to auto-generate Module's Directory and stock AllTests.php file with stock functionality for autolocating and loading tests.
• Simplify unit test writing by reducing the learning curve and by adding Zend Framework conventions.
• Standardized suite/test configuration.. uses native parse_ini_file().
• Ability to add functionality to the test runner later to better report on test failure. (to be implemented later).

Installing PHPUnit on your box

• Zend Framework unit tests are written for PHPUnit.
  • New install:
    $ pear channel-discover pear.phpunit.de $ pear config-set preferred_state alpha $ pear install phpunit/PHPUnit
  • Upgrading:
    $ pear upgrade phpunit/PHPUnit
  • Upgrading from PEAR/PHPUnit2:
    $ pear uninstall PHPUnit2 $ pear channel-discover pear.phpunit.de $ pear config-set preferred_state alpha $ pear install phpunit/PHPUnit

When you're having trouble installing the newest PHPUnit Version 3 and after upgrading your PEAR say that the newest PHPUnit Version 2.3.6 is already installed the following instuctions will help you

Look per browser at http://pear.phpunit.de/get/ and see what's the latest release...
Today for example the latest release version is http://pear.phpunit.de/get/PHPUnit-3.0.0alpha18.tar.
Now do the following

and you will have the latest PHPUnit Version installed.

Check your version by changing your working directory to PHP and run phpunit on command line.
The actual version and help should show up.

Getting the new unit tests (only until this is in production)

•  pull down from subversion repository
• http://www.ralphschindler.com/subversion/Zend_UnitTests/

Using ZFTestManager.php / ZFTestManager

• Help
  $ php ZFTestManager.php --help Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. Usage: ZFTestManager [PLAY:options] - if installed in a bin with path to php. php ZFTestManager.php [PLAY:options] - from unit test directory. * With no options, ZFTestManager will run all found tests. Options: --list-suites Prints a hierarchical list of suites for testing. --new-suite <name> Create a new suite at the <name> location. --suite-filter <filter> Where filter is: Zend_Suite - run this suite and its sub-suites. @Zend_Suite - run only this suite. Zend_Suite::MyTestCase - run only this TestCase in this suite. --test-filter <filter> Where filter is a regex of the test cases you wish to run. --help Prints this usage information. --version Prints the version and exits. -d key[PLAY:=value] Sets a php.ini value.

• Adding a new Suite
  $ php ZFTestManager.php --new-suite Zend_View Zend Framework - Unit Testrunner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. Attempting to create a suite shell named: Zend_View Creating directory Zend/View in suite.. Writing AllTests.php file.. Complete.

• Listing Suites
  $ php ZFTestManager.php --list-suites Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. Zend Zend_Cache Zend_Db_Adapter_Pdo Zend_Feed Zend_Config Zend_Controller Zend_Http Zend_Mime Zend_Uri Zend_View Zend_Mail Zend_Filter Zend_Json

• Running All Suites
  $ php ZFTestManager.php Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. ......................................... ......................................... ......................................... ......................................... ......................................... ........... Time: 00:00 OK (216 tests)

• Running Isolated Suite
  • Running suite and all branches.
    $ php ZFTestManager.php --suite-filter Zend_View Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. ............ Time: 00:00 OK (12 tests)
  • Running Single Suite Node, no branches
    $ php ZFTestManager.php --suite-filter @Zend Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. ........... Time: 00:00 OK (11 tests)
  • Running Single Suite Node, Single TestCase
    $ php ZFTestManager.php --suite-filter Zend_Cache#CoreTest Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. ..................................... Time: 00:00 OK (37 tests)
  • Running Single Suite Node, Single TestCase, Single Test
    $ php ZFTestManager.php --suite-filter Zend_Cache#CoreTest --test-filter testConstructorBadOption Zend Framework - Unit Test Runner and Manager Script built on PHPUnit 3.0.0alpha19 by Sebastian Bergmann. . Time: 00:00 OK (1 test)

Writing Tests

• See also: Testing Standards
• see notes inside generated AllTests.php file inside your Suite directory.

ZFTestManager Configuration / TestConfiguration.ini

Global Options