Ubuntu Xenial LAMP Vagrant Box

The ArminVieweg/ubuntu-xenial64-lamp box is a lightweight (<800MB) Vagrant box for VirtualBox based on latest Ubuntu Xenial 64-bit, released under GPL-2.0+.

The following components are installed:

Apache 2 (with SSL available)
PHP 5.6, 7.0, 7.1, 7.2 (globally switchable, 7.2 enabled by default)
XDebug for all versions
MariaDB
ImageMagick
Composer
NodeJS & npm
Ruby
Mailcatcher

Installation

Just perform a vagrant init ArminVieweg/ubuntu-xenial64-lamp in your project to use this box. This will create a very basic Vagrantfile for you. You can also ship your own Vagrantfile with configured synced_folders, e.g.

You may use the Vagrantfile in this repository. Put the file to your project's root and perform a vagrant up.

Vagrant Plugins

This Vagrantfile requires the following plugins to be installed:

vagrant-bindfs
vagrant-hostmanager
vagrant-winnfsd (for Windows only)

Variables in Vagrantfile

There are some points in Vagrantfile you may adjust for your projects. To be able to run multiple instances on one host, you need to specify a unique static ip address. Also, the port forwarding for http must be unique for all booted boxes.

Default values:

staticIpAddress = "192.168.11.2"
httpPortForwardingHost = "8080"
config.vm.hostname = "xenial.local"

Provisioning scripts

Vagrantfile comes with two provisioning scripts.

update-ssl-certificate Updates Apache's SSL certificate, based on configured hostname. (once)
update-composer Updates Composer on each vagrant up. (always)

Basics

The default document root is /var/www/html
In MySQL/MariaDB use root/root to login
To open Mailcatcher use port 1080: http://xenial.local:1080
Use vagrant/vagrant to login with ssh (or vagrant ssh)
Supports vagrant share (with ngrok installed)

Configuration

In home directory of vagrant user are some php.ini files located, which are sym-linked in conf.d folders of php versions. The following files are existing:

php-5.6.ini Just used with PHP 5.6
php-7.0.ini Just used with PHP 7.0
php-7.1.ini Just used with PHP 7.1
php-7.2.ini Just used with PHP 7.2
php-all.ini Used with all versions (not CLI)
php-cli.ini Used for CLI usage (all versions)
php-xdebug.ini Settings for XDebug (remote debugging enabled by trigger, profiling prepared but disabled by default)

The paths /etc/apache2 and /etc/mysql have got write permissions for vagrant user. So you can edit configuration without need to perform sudo on CLI.

Switch between PHP versions

To switch PHP versions just execute:

$ sudo ~/enable-php/7.2.sh

Available versions:

5.6.sh
7.0.sh
7.1.sh
7.2.sh (enabled by default)

Apache is automatically restarted and also CLI PHP version is changed.

XDebug profiler dumps

XDebug Profiler is enabled by trigger. Dumps are stored in /vagrant and synced back to host.

Disk space

The virtual hard disk shipped with ArminVieweg/ubuntu-xenial64-lamp stores up to 500 GB by default.

New instances of this box require ~2GB of disk space.

a-r-m-i-n / ubuntu-xenial64-lamp