How to test Pull Requests

Tests determine the quality of a software. This process involves evaluating information that is related to a shop.

To make testing easier, we provide a Vagrant configuration designed for testing branches and pull requests.

What is installed

  • Debian 10 Buster
  • Git
  • Apache 2.4
  • Multiple PHP versions (7.1, 7.2, 7.3, 7.4)
  • MariaDB 10
  • NodeJS

Requires

First of all you need two tools to run this project:

If you’re using Windows, we recommend you to download Git bash and execute all commands under this shell.

Why Vagrant

We use Vagrant because of its flexibility and portability. With it, you can control every aspect of the machine, and help us by having a similar environment to reproduce issues.

Getting started

The process is pretty simple.

First, you must clone the repository https://github.com/PrestaShop/vagrant.

Second, execute the script run.sh (or run.bat if you’re under Windows) and follow instructions.

Most of the time, there is a prompt asking for a network interface, remember it’s the communication between the virtual machine and the network card.

Running the run.sh script

The first installation will take a while, because it needs to download the vagrant box, installs all needed packages and configures the system to make it compatible with PrestaShop.

Script running successfuly

Then, visit http://192.168.42.42/prestashop.

phpMyAdmin is also available at http://192.168.42.42/phpmyadmin.

Environments

Available PHP versions

  • 7.1
  • 7.2
  • 7.3
  • 7.4
Be aware that some PrestaShop versions are not compatible with all the above environments. See System requirements to find out which version is compatible with which PHP version.

PrestaShop

  • Username: demo@prestashop.com
  • Password: prestashop_demo

MySQL

phpMyAdmin is available at http://192.168.42.42/phpmyadmin.

  • MySQL Host: 127.0.0.1
  • Database name: prestashop
  • Username: prestashop
  • Password: prestashop
  • Port: 3306

SSH

You can login into the virtual machine with vagrant ssh

Troubleshooting

If something went wrong during the installation, the error is displayed explaining which command is failing.

  • Invalid branch name:

    Invalid git branch name

  • Invalid PHP version:

    Invalid PHP version