Similar to JUnit for Java, PHPunit2 is a sophisticated testing tool for PHP. In this article I would like to introduce how to run PHPUnit2 for Zend Framework
1 Install Zend Framework
Zend Framework is available at http://framework.zend.com/download , from where you can get .zip or .tar.gz file. Unzip(or Untar) the file you just downloaded to directory ZendFramework-x.x.x. Then copy the Zend subfolder and Zend.php which are in ZendFramework-x.x.x\library to the directory indicated by “include_path” of the php.ini file. At this time, you can use require_once “xxx.php” to use the classes in Zend Framework.
2 Install PEAR (on Windows)
PEAR is short for "PHP Extension and Application Repository. As PHPUnit2 is recommended to be installed via PEAR installer, we should install PEAR first. There is an easy way to install PEAR, request http://go-pear.org/ in your browser and save the output to a local file go-pear.php. Then You can then run php go-pear.php in a Windows Command Prompt to start the installation or PEAR update process.
Here is a trick. When run php go-pear.php, PEAR will be downloaded and updated online. Sometimes we can’t connected to the server, if this happens set the proxy to http://xxx.com:80 instead of http://xxx.com since PEAR is not clever enough to consider http://xxx.com to be http://xxx.com:80.
Install PHPUnit2: (on Windows)
PHPUnit2 is available from the http://pear.php.net/, which is a framework and distribution system for reusable PHP components. It can be installed using the PEAR Installer, as shown in the following example: pear install PHPUnit2.
If this fails, you can copy the PHPUnit2-x.x.x.tgz file that you downloaded to the folder where you want it to be installed. Now issue the following command: pear install PHPUnit2-x.x.x.tgz.. After installation you should be able to find the PHPUnit2's source files inside your PEAR local directory.
Do remember to install the two packages that PHPUnit2 depends on: Benchmark and Console_Getopt before installing PHPUnit2.
3 Run PHPUnit2 for Zend Framework.
After the 3 steps, we can start running test cases for Zend Framework now. There are some unit tests that comes with Zend Framework in the subfolder ZendFramework_Dir\tests. Let's use ZendTest?.php for our example. You can also write your own cases for your code.
Copy ZendTest?.php to the directory which is indicated by “include_path” in php.ini. Then you can run "phpunit ZendTest?"
The following is the result:
PHPUnit 2.3.6 by Sebastian Bergmann.
EF.E.EF....
Time: 0.021509 There were 3 errors: 1) testLoadClassValid(ZendTest?) File "D:\www\Zend\_files\_testDir1\Class1.php" was not found. D:\www\Zend.php:87 D:\www\ZendTest.php:34 2) testLoadClassSearchDirs(ZendTest?) File "D:\www\Zend\_files\_testDir2\Class1.php" was not found. D:\www\Zend.php:87 D:\www\ZendTest.php:78 3) testLoadInterfaceValid(ZendTest?) File "D:\www\Zend\_files\_testDir1\Interface1.php" was not found. D:\www\Zend.php:131 D:\www\ZendTest.php:103 There were 2 failures: 1) testLoadClassNonexistent(ZendTest?) "File "D:\www\Zend\_files\_testDir1\ClassNonexistent.php" was not found." does n ot match pattern "/file(.*)loaded but class(.*)not found/i" D:\www\ZendTest.php:48 2) testLoadInterfaceNonexistent(ZendTest?) "File "D:\www\Zend\_files\_testDir1\ClassNonexistent.php" was not found." does n ot match pattern "/file(.*)loaded but interface(.*)not found/i" D:\www\ZendTest.php:117
FAILURES!!! Tests run: 11, Failures: 2, Errors: 3, Incomplete Tests: 0.
1 Install Zend Framework
Zend Framework is available at http://framework.zend.com/download , from where you can get .zip or .tar.gz file. Unzip(or Untar) the file you just downloaded to directory ZendFramework-x.x.x. Then copy the Zend subfolder and Zend.php which are in ZendFramework-x.x.x\library to the directory indicated by “include_path” of the php.ini file. At this time, you can use require_once “xxx.php” to use the classes in Zend Framework.
2 Install PEAR (on Windows)
PEAR is short for "PHP Extension and Application Repository. As PHPUnit2 is recommended to be installed via PEAR installer, we should install PEAR first. There is an easy way to install PEAR, request http://go-pear.org/ in your browser and save the output to a local file go-pear.php. Then You can then run php go-pear.php in a Windows Command Prompt to start the installation or PEAR update process.
Here is a trick. When run php go-pear.php, PEAR will be downloaded and updated online. Sometimes we can’t connected to the server, if this happens set the proxy to http://xxx.com:80 instead of http://xxx.com since PEAR is not clever enough to consider http://xxx.com to be http://xxx.com:80.
Install PHPUnit2: (on Windows)
PHPUnit2 is available from the http://pear.php.net/, which is a framework and distribution system for reusable PHP components. It can be installed using the PEAR Installer, as shown in the following example: pear install PHPUnit2.
If this fails, you can copy the PHPUnit2-x.x.x.tgz file that you downloaded to the folder where you want it to be installed. Now issue the following command: pear install PHPUnit2-x.x.x.tgz.. After installation you should be able to find the PHPUnit2's source files inside your PEAR local directory.
Do remember to install the two packages that PHPUnit2 depends on: Benchmark and Console_Getopt before installing PHPUnit2.
3 Run PHPUnit2 for Zend Framework.
After the 3 steps, we can start running test cases for Zend Framework now. There are some unit tests that comes with Zend Framework in the subfolder ZendFramework_Dir\tests. Let's use ZendTest?.php for our example. You can also write your own cases for your code.
Copy ZendTest?.php to the directory which is indicated by “include_path” in php.ini. Then you can run "phpunit ZendTest?"
The following is the result:
PHPUnit 2.3.6 by Sebastian Bergmann.
EF.E.EF....
Time: 0.021509 There were 3 errors: 1) testLoadClassValid(ZendTest?) File "D:\www\Zend\_files\_testDir1\Class1.php" was not found. D:\www\Zend.php:87 D:\www\ZendTest.php:34 2) testLoadClassSearchDirs(ZendTest?) File "D:\www\Zend\_files\_testDir2\Class1.php" was not found. D:\www\Zend.php:87 D:\www\ZendTest.php:78 3) testLoadInterfaceValid(ZendTest?) File "D:\www\Zend\_files\_testDir1\Interface1.php" was not found. D:\www\Zend.php:131 D:\www\ZendTest.php:103 There were 2 failures: 1) testLoadClassNonexistent(ZendTest?) "File "D:\www\Zend\_files\_testDir1\ClassNonexistent.php" was not found." does n ot match pattern "/file(.*)loaded but class(.*)not found/i" D:\www\ZendTest.php:48 2) testLoadInterfaceNonexistent(ZendTest?) "File "D:\www\Zend\_files\_testDir1\ClassNonexistent.php" was not found." does n ot match pattern "/file(.*)loaded but interface(.*)not found/i" D:\www\ZendTest.php:117
FAILURES!!! Tests run: 11, Failures: 2, Errors: 3, Incomplete Tests: 0.