• Latest Release:

Fork purpose and disclaimer

This fork of the EcomDev original repository was created by Barbazul with the intent of doing some maintenance work necessary for the sole purpose of keeping the tool up to date with current Magento 1 stack for legacy projects. No new features will be worked on or merged from pull requests. Pull Requests fixing issues with the tool will likely be merged.

The tool is provided "as is" without any warranty of it actually working and no support will be given. At all. You are still free to open issues as someone in the community might join the discussion and answer them if I don't do it myself, but in the most likely case I will not be answering any issues.

---

Magento PHPUnit Integration

Magento is a quite complex platform without built in unit test suite, so the code is not oriented on running tests over it.

This extension was created especially for resolving this problem and promoting test driven development practices in Magento developers community. It doesn't change core files or brake your Magento instalment database, because all the system objects are replaced during the run-time with the test ones and a separate database connection is used for tests.

System Requirements

• PHP 5.3 or higher
• PHPUnit 3.7.x
• Magento CE1.4.x-1.7.x/PE1.9.x-PE1.10.x/EE1.9.x-1.12.x

Build Status

• Latest Release:
• Development Branch:

Documentation

• EcomDev_PHPUnit version 0.2.0

Also you may follow our related blogposts.

Installation

1. There are two ways of obtaining the extension:

   • Use Module Manager

   modman clone git://github.com/EcomDev/EcomDev_PHPUnit.git 

   • Add extension as dependency in your composer.json to install it from Magento Composer Repository

     {
           "require": {
              "ecomdev/ecomdev_phpunit": "*"
           }
     }

2. Open your terminal and navigate to your magento directory for performing the following command, they are required to configure system for running the test suite

   # Shell scripts needs to be run from this directory
   cd $YOUR_MAGENTO_DIRECTORY/shell 
   # Specify your test database name and base url for controller tests
   php ecomdev-phpunit.php -a magento-config --db-name $DB_NAME --base-url http://your.magento.url/

   If you receive a warning on PHPUnit checks for optional packages, run the following command

   php ecomdev-phpunit.php -a fix-autoloader

3. Run the unit tests first time for installing test database. It will take about 3 minutes.

    $ phpunit 
   

4. If it shows that there was no tests found, it means that extension was successfully installed. If it shows some errors, then it means, that your customizations has install scripts that relay on your current database data and you should fix them. Or use your dev database as a base for the tests, but prior first time running the suite.

Issue Tracker

We use github issue tracker only for contributions management. If you want to post an issue please use our Issue Tracker

Contributions

If you want to take a part in improving our extension please create branches based on dev one.

###Create your contribution branch:

$ git checkout -b [your-name]/[feature] dev

Then submit them for pull request.