https://github.com/ssx/docker-simple-php
A simple way to run your PHP application within the latest PHP-FPM version, with MariaDB, Mailhog, Redis, Beanstalk and Nginx out the box.
https://github.com/ssx/docker-simple-php
beanstalk beanstalkd developer-tools development docker docker-compose docker-php docker-phpdev mailhog mariadb nginx php php-7 php-fpm
Last synced: 3 months ago
JSON representation
A simple way to run your PHP application within the latest PHP-FPM version, with MariaDB, Mailhog, Redis, Beanstalk and Nginx out the box.
- Host: GitHub
- URL: https://github.com/ssx/docker-simple-php
- Owner: ssx
- License: apache-2.0
- Created: 2017-05-01T13:06:41.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-05-17T17:14:51.000Z (over 8 years ago)
- Last Synced: 2025-06-03T02:07:54.959Z (4 months ago)
- Topics: beanstalk, beanstalkd, developer-tools, development, docker, docker-compose, docker-php, docker-phpdev, mailhog, mariadb, nginx, php, php-7, php-fpm
- Language: Nginx
- Size: 30.3 KB
- Stars: 6
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Simple PHP for Docker
This project will drop in to an existing project and run it within Docker. It
comes with the latest version of PHP-FPM, Nginx, MariaDB, Beanstalk, Redis and
Mailhog for when you're using it in local development.
### Getting Started in 1 seconds
Clone this repository and run `docker-compose up` then point your browser at
`http://localhost:8080` and you should see a beautiful PHP info page.
### Getting Started in 5 seconds
Clone this repository to your local machine. Copy the `docker-compose.yml`
file and `.docker` directory into your project directory. Then run
`docker-compose up` and you'll be off and running.
### Getting started in 30 seconds
Clone this repository, sit around for 26 seconds then do the step above.
### MariaDB/MySQL Password
The default root password is `vagrant` and the default database name is `vagrant`,
both of these should be changed to suit your project. The data will be persisted
across containers being created/destroyed in the `.docker/volumes/mysql`
directory on your local machine (or server you deploy to).
### nginx
You can overwrite the Nginx website config by editing the file that is located at
`.docker/config/nginx.conf` which will be picked up on starting the container.
### PHP
The included version of PHP-FPM includes GD, Intl and BZ2 extensions as well as
Composer being installed as well.
### Accessible URLs
You can access the services Nginx, MariaDB, Mailhog and Beanstalkd Console at:
- Nginx - http://localhost:8080
- mailhog - http://localhost:8081
- Beanstalkd Console - http://localhost:8082
- MariaDB - tcp://localhost:3306 (Use Sequel Pro on a Mac)
### Hosts
When configuring your environment to connect to each service, you can use the
following hostnames and ports:
- `mariadb` - 3306
- `beanstalkd` - 11300
- `redis` - 6739
- `mailhog` - 1025
### Accessing PHP within the stack
If you're running something like Laravel and need to run `php artisan migrate`, you can
do this by running:
`docker-compose exec php bash`
within the project directory, this will give you a bash prompt that you can then `cd /www`
and run `php artisan migrate` and it'll run the migrations.
### .gitignore
It'll be wise to add the following into your `.gitignore` file to stop the
MariaDB databases being added to your repo:
.docker/volumes/mysql/*
!.docker/volumes/mysql/.gitkeep
### License
This project is licensed under an Apache 2.0 license which you can find within
this repository in the [LICENSE file](https://github.com/ssx/docker-simple-php/blob/master/LICENSE).
### Feedback
If you have any feedback, comments or suggestions, please feel free to open an
issue within the repository on [Github](https://github.com/ssx/docker-simple-php).