Developer Documentation

Warning: This version of Altis is no longer supported

Local Chassis

Chassis is the bundled local development environment.

Setup

Chassis requires Vagrant and VirtualBox to be installed on your system.

To set up Chassis for Altis, run the following inside your project's directory:

composer chassis init

This will add Chassis to your development dependencies and prepare it to be run.

You can then use the other composer chassis commands to manage your machine.

Available Commands

A number of convenience commands are available:

  • composer chassis init - Initialises your local Chassis setup and starts the virtual machine.
  • composer chassis start - Starts the virtual machine.
  • composer chassis stop - Stops the virtual machine.
  • composer chassis status - Displays the status of the virtual machine.

Under the hood, the Local Chassis environment is powered by Chassis and Vagrant.

You can use the low-level Vagrant commands inside the chassis directory after you have run composer chassis init for the first time.

Extensions

Chassis has a number of extensions available which can be used to add additional functionality to your development environment. By default, your Local Chassis install is set up to mirror the HM Cloud infrastructure, but you may wish to enable other tools for local development.

We recommend the following common development tools:

  • SequelPro - Adds a vagrant sequel command to instantly connect to your development MySQL server in Sequel Pro
  • XDebug - Installs XDebug for interactive debugging in your editor
  • phpdbg - Installs phpdbg for interactive command-line debugging
  • Mailhog - Captures outbound email from Altis and provides a fake inbox

Consult the Chassis documentation for information about installing additional extensions.