Skip to content
Switch branches/tags
This branch is up to date with develop.

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Build Status

This module provides a patched version of Mage_Core enabling you to inject testing dependencies at run time. Due to the functionality of the Varien_Autoloader the local code pool is prioritised over the core. Meaning that any code duplicated from the Mage vendor namespace into the local code pool will be used over the core.

This allows you to build and run functional controller tests in the same way you would with a standard Zend Framework Application using Zend Test. This mocks the Request and Response objects to that you can query the Response within a suite of tests.


  • PHPUnit 3.5+
  • PHP 5.3+


Install using composer

The simplest way to install Mage-Test is to use magento-composer-installer. First, add Mage-Test to the list of dependencies inside your store's composer.json, or create this file if it doesn't exist. You will also need to add some setup for magento-composer-installer, if you are not using it already. By convention this guide assumes this file exists at the root of your store's directory structure.

Inside your project's composer.json ensure your have at least the following contents.

    "require-dev": {
        "MageTest/Mage-Test": "*"
    "repositories": [
	        "type": "composer",
	        "url": ""
        "magento-root-dir": "./"
    "config": {
        "bin-dir": "shell"
    "autoload": {
        "psr-0": {
            "": [
    "minimum-stability": "dev"

Now to install everything, simply let composer do its job.

$ composer install --dev

Afterwards your magento project's directory structure should look something like the following.

├── LICENSE.html
├── LICENSE.txt
├── api.php
├── app
├── composer.json
├── composer.lock
├── cron.php
├── dev
├── downloader
├── errors
├── favicon.ico
├── get.php
├── includes
├── index.php
├── index.php.sample
├── install.php
├── js
├── lib
├── mage
├── media
├── php.ini.sample
├── pkginfo
├── shell
├── skin
├── tests
├── var
└── vendor

You can verify the installation by running Mage-Test's own bundled test suite.

$ phpunit -c vendor/MageTest/Mage-Test/tests/phpunit.xml.dist

You can read more about Composer on its official webpage. To find out more about Magento Composer Installer see its Github project page, or take a look at Vinai Kopp's MageBase Composer with Magento article.

Install using Modman

Mage-Test comes bundled with a modman mapping file. To install with Modman, if you haven't already, run modman init followed by modman clone

Modman maintains a detailed wiki with a Modman tutorial and further information on its use.


Feature Requests

If you have an idea of how to make this a better project or add functionality that would be of use the community then please submit a feature request. Create a new ticket and add the label of 'Feature'.


Developer IRC channel for MageTest is #magetest on Freenode.

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Add tests for your new feature or bug fix.
  4. Add your Feature or Fix to satisfy the tests.
  5. Commit your changes (git commit -am 'Added some feature')
  6. Push to the branch (git push origin my-new-feature)
  7. Create a new Pull Request


Patched Mage_Core and extended Zend_Test classes to enable functional testing of Magento







No packages published