MageTestStand

This tool is used to build a minimal Magento environment that allows to run PHPUnit tests for a Magento module on Travis CI.

It uses following tools:

• n98-magerun (to install a vanilla Magento instance for a given version number)
• modman (to link your module to the Magento instance)
• EcomDev_PHPUnit (actually, the AOE fork,... for some helpers that make unit testing in Magento much easier)
• PHPUnit
• Composer
• aoepeople/composer-installers (minimal composer installer for Magento modules which acts as a replacement for 'magento-hackathon/magento-composer-installer')

Requirements

• database 'mageteststand' (user 'root', blank password) This is the database Magento uses
• database 'mageteststand_test' (user 'root', blank password) This is the dummy database EcomDev_PHPUnit will use. Although you can configure this to use the original database, some tests (including fixtures) will behave differently...
• You can override the default database credentials using following environment variables:
  • MAGENTO_DB_HOST
  • MAGENTO_DB_PORT
  • MAGENTO_DB_USER
  • MAGENTO_DB_PASS
  • MAGENTO_DB_NAME
• Environment variable MAGENTO_VERSION with valid Magento version for n98-magerun's install command

General usage

• Set the environment variable MAGENTO_VERSION to the desired version, e.g. magento-ce-1.9.0.1
• Set the environment variable WORKSPACE to the directory of the magento module
• checkout your magento module
• run curl -sSL https://raw.githubusercontent.com/AOEpeople/MageTestStand/master/setup.sh | bash as the build step, this will do everything automatically in a temporary directory
• you can use the script contents as a build step for sure, but this way it's easier ;)

Travis CI configuration

Example .travis.yaml file (in the Magento module you want to test):

language: php
php:
  - 5.3
  - 5.4
  - 5.5
  - 5.6
  - hhvm
matrix:
  allow_failures:
  - php: 5.6
  - php: hhvm
env:
  - MAGENTO_VERSION=magento-ce-1.9.0.1
  - MAGENTO_VERSION=magento-ce-1.8.1.0
  - MAGENTO_VERSION=magento-ce-1.8.0.0
  - MAGENTO_VERSION=magento-ce-1.7.0.2
script:
  - curl -sSL https://raw.githubusercontent.com/AOEpeople/MageTestStand/master/setup.sh | bash
notifications:
  email:
    recipients:
      - [email protected]
    on_success: always
    on_failure: always

Jenkins configuration

• create a new multiconfiguration project and check out your Magento Module.
• create a new axis on the configuration matrix, named "MAGENTO_VERSION" and add the following values

magento-ce-1.9.0.1
magento-ce-1.8.1.0
magento-ce-1.8.0.0
magento-ce-1.7.0.2

• Make sure that the configurations are build sequentiell, otherwise you might run into database issues!
• use the following script as a shell build step curl -sSL https://raw.githubusercontent.com/AOEpeople/MageTestStand/master/setup.sh | bash

Unittest your Module directly from bash/zsh/shell

• set up your environment

export WORKSPACE=/full/path/to/your/module
export MAGENTO_VERSION=magento-ce-1.9.0.1

# if necessary
export MAGENTO_DB_HOST=somewhere
export MAGENTO_DB_PORT=somenum
export MAGENTO_DB_USER=someone
export MAGENTO_DB_PASS=something
export MAGENTO_DB_NAME=somename

• run curl -sSL https://raw.githubusercontent.com/AOEpeople/MageTestStand/master/setup.sh | bash