Vanilla Docker environment
Only supports Mac OSX at the moment but everything can be easily adapted to work on other platforms. Assume that you are using PhpStorm as your IDE.
This repository contains a ready-for-development environment to develop against Vanilla.
The containers
database
SQL database.
- Accessible from the container with the hosts "database".
- Accessible from the docker host machine with the hosts "database", "localhost", "127.0.0.1'
- The user is "root" and there is no password.
httpd
Apache 2 web server.
- Accessible with the port 9080 and 9443
- Serve https://dev.vanilla.localhost:9443
nginx
nginx web server
- Serve:
- https://dev.vanilla.localhost (main forum)
- https://vanilla.localhost/dev (directory-based main forum, see the docs)
- https://sso.vanilla.localhost (stub-sso-providers)
- https://embed.vanilla.localhost (stub-embed-providers)
- https://advanced-embed.vanilla.localhost (stub-embed-providers)
- http://vanilla.test:8080 (unit tests address)
php-fpm
php-fpm with PHP 7.4 and rsyslogd.
The php-fpm container comes in two flavours, standard and xdebug.
The nginx container takes care of routing the request to the appropriate php-fpm flavour based on if your request needs debugging or not.
When XDebug is running things are much slower. As a result it recommended not pass an XDebug cookie (normally through a browser extension) unless you are actively debugging.
Setup
https://success.vanillaforums.com/kb/articles/155-local-setup-quickstart
Xdebug
See Make Xdebug work with PhpStorm.
Unit tests
See Make unit tests work within PhpStorm.
F.A.Q
Q. Why is everything so slow?
A. You are probably running on the APFS file system that became the standard with macOS High Sierra and which has pretty bad performance with Docker for Mac. Having the database on your host instead of inside docker might help a lot. See #10.