OpenCart Testing Suite

Supported OpenCart Versions

OpenCart version	opencart-test-suite version	build status
>=2.0	~2.0	no tested
~2.2.0	~2.2.0
~2.3.0	~2.3.0

Motivation

The intend of this project is to provide a simple approach for setting up a test suite for custom OpenCart development.

Getting started from scratch

• Create a new OpenCart instance (maybe follow this guide)
• Add opencart-test-suite as a dependency composer require beyondit/opencart-test-suite --dev
• Use composer require beyondit/opencart-test-suite:2.2.0 --dev for OpenCart version 2.2.0.0 respectively
• Create a tests folder and add respective tests (see examples below)
• Add a phpunit.xml which includes testsuites (e.g. admin and catalog) and set an env variable to the opencart root directory (see example phpunit.xml below)
• Now tests can be run via vendor/bin/phpunit --testsuite catalog-tests command

Our OpenCart project template might simplify setup for you.

Example of a phpunit.xml

<?xml version="1.0" encoding="UTF-8"?>
<phpunit bootstrap="vendor/autoload.php">
    <testsuites>
        <testsuite name="catalog-tests">
            <file>./tests/SampleTest.php</file>
        </testsuite>        
    </testsuites>
    <php>
        <env name="OC_ROOT" value="/../opencart/root-folder" />
    </php>
</phpunit>

Test Examples

Testing a Model

class ModelCatalogManufacturerTest extends OpenCartTest
{	
	public function testASpecificManufacturer()
	{
		
		// load the manufacturer model
		$model = $this->loadModel("catalog/manufacturer");
		$manufacturer = $model->getManufacturer(5);		
		
		// test a specific assertion
		$this->assertEquals('HTC', $manufacturer['name']);
		
	}	
}

Testing a Controller

class ControllerCheckoutCartTest extends OpenCartTest
{	
	public function testAddingASpecificProductToTheCart()
	{
			
		$response = $this->dispatchAction('checkout/cart/add','POST',['product_id' => 28]);
        $output = json_decode($response->getOutput(),true);
        
        $this->assertTrue(isset($output['success']) && isset($output['total']));
        $this->assertRegExp('/HTC Touch HD/', $output['success']);
        
	}	
}

Testing with logged in Customers

class ControllerAccountEditTest extends OpenCartTest {  
    public function testEditAccountWithLoggedInCustomer() {

        $this->login('[email protected]','password');
        
        $response = $this->dispatchAction('account/edit');
        $this->assertRegExp('/Your Personal Details/',$response->getOutput());
        
        $this->logout();
        
    }   
}

Testing with logged in Users inside Admin

In order to test classes inside the admin folder just call your test class ending with AdminTest e.g. ModelCatalogCategoryAdminTest

class ControllerCommonDashboardAdminTest extends OpenCartTest {  
    public function testShowDashboardWithLoggedInUser() {

        $this->login('admin','admin');
        
        $response = $this->dispatchAction('common/dashboard');
        $this->assertRegExp('/Total Sales/', $response->getOutput());
        
        $this->logout();
        
    }   
}