Using Vagrant for development¶
Roadiz comes with a dedicated
Vagrantfile which is configured to run the official
roadiz/standard-edition box with a LEMP stack
(Nginx + PHP7.0-FPM + MariaDB), a phpMyAdmin, a Mailcatcher and an Apache Solr server. This will be useful
to develop your website on your local computer.
Once you’ve created your Roadiz project, Composer should has copied
samples/Vagrantfile.sample file as
Vagrantfile at your project root.
Then do a
vagrant up in Roadiz’ folder. Then Vagrant will run your code in
and you will be able to completely use
bin/roadiz commands without bloating your computer with lots of binaries.
Once vagrant VM has provisioned you will be able to use:
http://192.168.33.10/install.phpto proceed to install.
http://192.168.33.10:8983/solrto use Apache Solr admin.
http://192.168.33.10/phpmyadminfor your MySQL db admin.
http://192.168.33.10:1080for your Mailcatcher tool.
Do not hesitate to add an entry in your
/etc/hosts file to use a local domain name
instead of using the private IP address (eg. http://site1.dev). And for each Vagrant website, do not forget to increment your private IP.
# /etc/hosts # Vagrant hosts 192.168.33.10 site1.dev 192.168.33.11 site2.dev # …
Be careful, Windows users, this
Vagrantfile is configured to use a NFS fileshare.
Disable it if you did not setup a NFS emulator. For OS X and Linux user
this is built-in your system, so have fun!
web/dev.php entry points are IP restricted to localhost. To be able to use them
with a Vagrant setup, you’ll need to add your host machine IP to the
$allowedIp array. We already
set two IP for you that should work for forwarded and private requests. Just uncomment the following lines
in these files and edit them if necessary.
$allowedIp = [ '10.0.2.2', // vagrant host (forwarded) '192.168.33.1', // vagrant host (private) '127.0.0.1', 'fe80::1', '::1' // localhost ];