This is a fast and simple Docker setup for all your PHP development. Quick but not dirty.
- Drupal 7 and Drupal 8
We won't force you to download our own images. Eveything is done using the official images of PHP, Nginx ... etc.
In this branch: Nginx + PHP + friends
All using on official images. Check the other branch of this repo for Apache + PHP.
Official containers only
We won't force you to download our own images. All of this is based on officials containers, so you won't download any specific containers to use this project.
All you have all the options available as soon as they are released on Docker Hub by PHP, Nginx, Apache ... etc.
PHP 7.0? PHP 7.1? or PHP 5.6?
You can switch between the latest release of PHP 7 or the latest of PHP 5, by changing the first line of the file "docker/php/Dockerfile". For the latest version of PHP 5:
Extra PHP librairies? Check the same file: docker/php/Dockerfile You can add your own librairies.
Everytime you change a dockerfile (example "docker/php/Dockerfile"), you need to rebuild your containers with the docker compose command "build --no-cache --force" and run again "composer up -d".
More PHP versions?
This project uses the official images from PHP, see all available options on: PHP's official Docker Hub page.
- Install the prerequisites.
- Create the docker containers.
- Place your files in web.
Install the prerequisites
You can use the official documentation on installing Docker: https://docs.docker.com/install/
We recommend you to use "Dinghy" for faster development using Docker on MacOS. Follow the steps: https://github.com/codekitchen/dinghy#install
Then install docker-compose using brew:
brew install docker docker-machine
It seems that Docker is supported only by Windows 10 pro edition. The official documentation on installing Docker
Create the docker containers
- Download this project and rename the folder according to your project. A good practice is to create a folder called "docker" in your home directory, this is where you will keep all your docker projects. In command line, this would be:
$ cd ~ $ mkdir docker $ git clone https://github.com/expresso-php/expresso-php.git myproject
- Create the Expresso PHP containers for your project:
$ docker-compose up -d
This is only for the first time, to create the containers. Next time you can just start them with:
$ docker start
3. Check which port is Nginx using with:
$ docker ps
Look for a line with the port number. For example: "myproject_nginx_1 nginx -g daemon off; Up 0.0.0.0:32770->80/tcp", in this case "32770" is my port number.
Place your files in web.
Expresso PHP will be looking for PHP files placed into the folder web. You can delete the existing web folder, and replace it by your project.
If your project is on git, a good practice is to do a symlink to your project. According to the previous step in this README, here is how to do in command line:
$ cd docker $ cd myproject $ rm -rf web
Git clone or download your project, example:
git clone https://github.com/myproject/myproject.git myproject
Create a symlink with your project's php files and web, example:
$ ln -s myproject/docroot web
To start Expresso PHP:
$ docker-compose start
To stop Expresso PHP:
$ docker-compose stop
To SSH the containers
$ docker-compose exec php_nginx /bin/bash
Drush (command line tool for Drupal)
$ docker-compose exec php_nginx drush help
Import database with Drupal and Drush
$ docker-compose run --rm php_nginx bash -c '$(drush sql-connect)' < my_database.sql
This is for development !!
- User: expresso-php
- Password: expresso-php
- Database: expresso-php
MySQL and PhpMyAdmin credentials
To access PhpMyAdmin, run
docker ps to get its dynamic port.
- Username: root
- Password: root
To enable SOLR, uncomment corresponding lines from docker-compose.yml file. SOLR can be accessed in [local-domain]:8983/solr/#/ ( e.g. http://192.168.99.100:8983/solr/#/ )