Compare commits

...

58 Commits

Author SHA1 Message Date
405067d4af Separate the PHP versions to multiple dockerfiles
Because there's some difference in installing some libraries
between PHP 5 and PHP 7. There must be multiple php dockerfiles.
For that I created 3 docker files each of a different version,
this will make it easy for the users to switch between the PHP
version by just editing the docker-compose file and not touching
the dockerfiles.
2016-05-14 04:50:47 +03:00
7f4e411d3d link containers to PHP 2016-05-14 04:20:20 +03:00
e946573d75 general updates to the readme file 2016-05-13 02:00:25 +03:00
470873acd2 add Memcached support to the readme file 2016-05-12 15:23:42 +03:00
88d5dd7806 Merge pull request #44 from mattythebatty/memcached-support
Memcached support
2016-05-12 15:12:46 +03:00
295a0974da install php memcached 2016-05-12 02:28:44 +01:00
cf89670671 add memcached support 2016-05-12 02:17:39 +01:00
40899bc40f remove the duplicated volumes from DBs dockerfiles 2016-05-09 15:53:16 +03:00
64bf3222af set php work directory to laravel's directory 2016-05-09 15:45:54 +03:00
79009cc97e Merge branch 'benmag-master'
* benmag-master:
  Install pdo_pgsql extension
2016-05-09 14:59:13 +03:00
571bf64eb2 Install pdo_pgsql extension 2016-05-09 13:08:08 +10:00
75b1705820 Merge remote-tracking branch 'LaraDock/master' 2016-05-09 12:09:57 +10:00
12587bc712 Support Beanstalkd and Beanstalkd Console
Closes feature #38
2016-05-09 05:02:15 +03:00
81f2602464 Support MariaDB
closes feature #21
2016-05-09 04:23:03 +03:00
ecefee4d65 update postgres volume path 2016-05-09 04:20:03 +03:00
de8cbb0605 simple updates to docker compose and readme 2016-05-08 15:21:59 +03:00
5190da831a remove containers names from docker-compose
to void conflict while scalling using the scale command
2016-05-08 13:39:43 +03:00
fdaa983e77 update readme, put requirements in table 2016-05-08 11:25:43 +03:00
e52f8f5613 update readme file, add more details on linux 2016-05-08 10:54:10 +03:00
f9c13090c6 general updates to the readme file 2016-05-07 19:59:59 +03:00
bfa0d54b5a add features list to the readme file 2016-05-07 19:51:45 +03:00
7f80888fc1 add more info to the readme file 2016-05-07 18:48:27 +03:00
aa338d534e Merge remote-tracking branch 'LaraDock/master' 2016-05-07 14:53:55 +10:00
31793a3cc9 general updates to the readme file 2016-05-07 05:58:20 +03:00
5d84c6481f revers the dependancies between php and the db
to prevent running all the db engines when php is running
2016-05-07 05:29:48 +03:00
26229e150d Merge pull request #35 from benmag/master
link postgres service to php service
2016-05-07 05:14:01 +03:00
ab7f3d8fd9 Merge remote-tracking branch 'LaraDock/master' 2016-05-07 12:12:43 +10:00
2b98b0b82e update the readme, include supported containers 2016-05-07 05:10:57 +03:00
457c5d4b1b update the readme file
Support selecting your own containers in the docker compose command.
2016-05-07 05:03:07 +03:00
cd97ac0aa6 link postgres service to php service 2016-05-07 11:55:00 +10:00
22f11e03ee Merge pull request #34 from benmag/master
Add support for postgres
2016-05-07 04:34:27 +03:00
5d62ec1e67 Add support for postgres 2016-05-07 11:16:06 +10:00
daa5ed981f Merge pull request #32 from LaraDock/develop
Major Updates
2016-05-06 18:55:57 +03:00
9ac7541dc9 upgrade the readme.md to reflect the last changes 2016-05-06 18:33:09 +03:00
05a83d383f Major updates.
- upgrade docker compose to v2
- build images locally instead of pulling them from the registry
- separate php container form nginx container
- support all the php versions including php 7.0
- remove beanstalked container to be optionally added later by the user
2016-05-06 17:04:02 +03:00
12051834a3 include screencast tutorial link 2016-04-28 23:40:30 +03:00
e2593ab522 make submodule add optional in the docs 2016-04-22 17:35:11 +03:00
4f9271d565 Merge pull request #29 from chungth/master
use git submodule instead of git clone when install
2016-04-18 14:10:16 +03:00
c447eb86e4 use git submodule instead of git clone 2016-04-18 19:48:29 +09:00
530ffe7433 remove redis restart always from the docker compose file 2016-04-18 12:08:57 +03:00
c8718e3746 update the logos image 2016-04-12 23:30:01 +03:00
feaff6fa72 update the documenation 2016-04-12 16:47:45 +03:00
d98cf4754b simplify the usage steps and create installation steps 2016-04-11 07:50:33 +03:00
b335364591 fix the documentation 2016-04-08 11:47:35 +03:00
105fce8965 simlify and reduce the usage steps 2016-04-08 11:33:33 +03:00
0973aaf166 update the documenation - make redis optional 2016-04-08 00:48:32 +03:00
b5be47fb5e fix a typo in the doc 2016-04-06 08:47:31 +03:00
03e7eb622e update the readme file 2016-04-04 10:19:49 +03:00
d9f10f367c upgrade the readme file
adding the different PHP versions to the docs in addition to general
updates
2016-04-04 10:03:11 +03:00
dac12296c6 upgrade to php 5.6 by default
adding `phpnginx` or `php55nginx` will pull PHP 5.5 while `php56nginx`
will pull PHP 5.6
2016-04-04 10:02:21 +03:00
62ec36d9dd replace the images versions from the latest to the latest stable version (tag).
to avoid any errors while experimenting on the master branch
2016-04-04 05:33:18 +03:00
5bc35214e6 update the readme file≈ 2016-03-11 11:06:31 +02:00
d179226247 update the readme file 2016-03-11 10:11:24 +02:00
97ad0cdcfe update the readme file 2016-03-11 09:40:59 +02:00
bd88b95bb5 Merge pull request #13 from vitr/patch-1
Update README.md (a typo)
2016-03-10 05:32:21 +02:00
8e5aa26b99 Update README.md 2016-03-10 09:35:11 +10:00
45cc9908ad update the documentation design 2016-03-06 07:29:15 +02:00
84e26f046b update the readme file 2016-02-26 13:24:55 +02:00
20 changed files with 827 additions and 163 deletions

1
.gitignore vendored Normal file
View File

@ -0,0 +1 @@
/logs

10
LICENSE
View File

@ -1,6 +1,6 @@
The MIT License (MIT) The MIT License (MIT)
Copyright (c) 2015 Mahmoud Zalt Copyright 2016 <Mahmoud Zalt>
Permission is hereby granted, free of charge, to any person obtaining a copy Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal of this software and associated documentation files (the "Software"), to deal
@ -9,13 +9,13 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions: furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all The above copyright notice and this permission notice shall be included in
copies or substantial portions of the Software. all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
SOFTWARE. THE SOFTWARE.

515
README.md
View File

@ -1,151 +1,252 @@
# LaraDock # LaraDock
[![forthebadge](http://forthebadge.com/images/badges/built-by-developers.svg)](http://zalt.me)
[![forthebadge](http://forthebadge.com/images/badges/built-with-love.svg)](http://www.zalt.me)
LaraDock helps you run your **Laravel** App on **Docker** real quick.
<br>
It's like Laravel Homestead but for Docker instead of Vagrant.
![](http://s18.postimg.org/fhykchl09/new_laradock_cover.png)
<br>
## Contents ## Contents
- [Intro](#Intro) - [Intro](#Intro)
- [Features](#features)
- [What is Docker](#what-is-docker)
- [What is Laravel](#what-is-laravel)
- [Why Docker not Vagrant](#why-docker-not-vagrant)
- [LaraDock VS Homestead](#laradock-vs-homestead)
- [Supported Containers](#Supported-Containers)
- [Requirements](#Requirements) - [Requirements](#Requirements)
- [Installation](#Installation)
- [Usage](#Usage) - [Usage](#Usage)
- [Documentation](#Documentation) - [Documentation](#Documentation)
- [Supported Images](#Supports) - [List current running Containers](#List-current-running-Containers)
- [Close all running Containers](#Close-all-running-Containers)
- [Delete all existing Containers](#Delete-all-existing-Containers)
- [Build/Re-build Containers](#Build-Re-build-Containers)
- [Change the PHP Version](#Change-the-PHP-Version)
- [Add/Remove a Docker Container](#AddRemove-a-Docker-Container)
- [Add more Software's (Docker Images)](#Add-Docker-Images)
- [Edit default container configuration](#Edit-Container)
- [Use custom Domain](Use-custom-Domain)
- [View the Log files](#View-the-Log-files)
- [Use Redis](#Use-Redis)
- [Enter a Container (SSH into a running Container)](#Enter-Container)
- [Edit a Docker Image](#Edit-a-Docker-Image)
- [Run a Docker Virtual Host](#Run-Docker-Virtual-Host)
- [Find your Docker IP Address](#Find-Docker-IP-Address)
![](http://s11.postimg.org/uqpl3efab/laradock.jpg)
<a name="Intro"></a> <a name="Intro"></a>
### What is LaraDock? ## Intro
**LaraDock** helps you run your **Laravel** App on **Docker** in seconds.
LaraDock strives to make the development experience easier. LaraDock strives to make the development experience easier.
It contains pre-packaged Docker Images that provides you a wonderful development environment without requiring you to install PHP, NGINX, MySQL, REDIS, and any other software on your local machine. It contains pre-packaged Docker Images that provides you a wonderful development environment without requiring you to install PHP, NGINX, MySQL, REDIS, and any other software on your local machine.
**Usage Overview:** Run `NGINX`, `MySQL` and `Redis`.
```shell
docker-compose up -d nginx mysql redis
```
<a name="features"></a>
### Features
- Easy switch between PHP versions: 7.0 - 5.6 - 5.5 ...
- Choose your favorite database engine: MySQL - Postgres - Redis ...
- Run your own combination of software's: Memcached - MariaDB ...
- Every software runs on a separate container: PHP - NGINX ...
- Easy to customize any container, with simple edit to the `dockerfile`.
- All Images extends from an official base Image. (Trusted base Images).
- Pre-configured Nginx for Laravel.
- Data container, to keep Data safe and accessible.
- Easy to apply configurations inside containers.
- Clean and well structured Dockerfiles (`dockerfile`).
- Latest version of the Docker Compose file (`docker-compose`).
- Everything is visible and editable.
<a name="Supported-Containers"></a>
## Supported Containers
- PHP (7.0 - 5.6 - 5.5)
- NGINX
- MySQL
- PostgreSQL
- MariaDB
- Redis
- Memcached
- Beanstalkd
- Beanstalkd Console
- Data Volume
>Cannot find your container! we would love to have it as well. Consider contributing your container and adding it to this list.
<a name="what-is-docker"></a>
### What is Docker? ### What is Docker?
[Docker](https://www.docker.com) is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of [operating-system-level virtualization](https://en.wikipedia.org/wiki/Operating-system-level_virtualization) on Linux, Mac OS and Windows. [Docker](https://www.docker.com) is an open-source project that automates the deployment of applications inside software containers, by providing an additional layer of abstraction and automation of [operating-system-level virtualization](https://en.wikipedia.org/wiki/Operating-system-level_virtualization) on Linux, Mac OS and Windows.
<a name="what-is-laravel"></a>
### What is Laravel? ### What is Laravel?
Seriously!!! Seriously!!!
<a name="why-docker-not-vagrant"></a>
### Why Docker not Vagrant!? ### Why Docker not Vagrant!?
[Vagrant](https://www.vagrantup.com) gives you Virtual Machines in minutes while Docker gives you Virtual Containers in seconds.
[Vagrant](https://www.vagrantup.com) creates Virtual Machines in minutes while Docker creates Virtual Containers in seconds.
Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you **lightweight** Virtual Containers, that share the same kernel and allow to safely execute independent processes. Instead of providing a full Virtual Machines, like you get with Vagrant, Docker provides you **lightweight** Virtual Containers, that share the same kernel and allow to safely execute independent processes.
In addition to the speed, Docker gives tens of features that cannot be achieved with Vagrant.
### Questions? Most importantly Docker can run on Development and on Production (same environment everywhere). While Vagrant is designed for Development only, (so you have to re-provision your server on Production every time).
[![Join the chat at https://gitter.im/LaraDock/laradock](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/LaraDock/laradock?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
<a name="laradock-vs-homestead"></a>
### LaraDock VS Homestead
LaraDock and [Homestead](https://laravel.com/docs/master/homestead) both gives you a complete virtual development environments. (Without the need to install and configure every single software on your own Operating System).
- Homestead is a tool that controls Vagrant for you (using Homestead special commands). And Vagrant manages your Virtual Machine.
- LaraDock is a tool that controls Docker for you (using Docker Compose official commands). And Docker manages you Virtual Containers.
Running a virtual Container is much faster than running a full virtual Machine.
<br>Thus **LaraDock is much faster than Homestead**.
<a name="Requirements"></a> <a name="Requirements"></a>
## Requirements ## Requirements
- Laravel ([Download](https://laravel.com/docs/master/installation))
- Docker Toolbox ([Download](https://www.docker.com/toolbox))
- Git ([Download](https://git-scm.com/downloads))
- Composer ([Download](https://getcomposer.org/download/))
*Note: Git & Composer can be installed on Docker Containers if you don't want to install them on your machine. (But you have to do this yourself for now).* | Linux | Windows & MAC |
|-----------------------------------------------------------------------------------------|---------------------------------------------------------|
| [Laravel](https://laravel.com/docs/master/installation) | [Laravel](https://laravel.com/docs/master/installation) |
| [Git](https://git-scm.com/downloads) | [Git](https://git-scm.com/downloads) |
| [Docker Engine](https://docs.docker.com/engine/installation/linux/ubuntulinux/#install) | [Docker Toolbox](https://www.docker.com/toolbox) |
| [Docker Compose](https://docs.docker.com/compose/install) | |
<a name="Installation"></a>
## Installation
1 - Clone the `LaraDock` repository, in any of your `Laravel` projects:
```bash
git clone https://github.com/LaraDock/laradock.git docker
```
You can use `git submodule add` instead of `git clone` if you are already using Git for your Laravel project *(Recommended)*:
```bash
git submodule add https://github.com/LaraDock/laradock.git docker
```
>These commands should create a `docker` folder, on the root directory of your Laravel project.
<a name="Usage"></a> <a name="Usage"></a>
## Usage ## Usage
1 - First install any version of Laravel, or use any of your existing Laravel projects. 0 - For **Windows & MAC** users only: make sure you have a running Docker Virtual Host on your machine.
(**Linux** users don't need a Virtual Host, so skip this step).
<br>
[How to run a Docker Virtual Host?](#Run-Docker-Virtual-Host)
2 - Open your terminal and go to your Laravel project directory.
3 - Create a new folder on the root directory of your Laravel project and name it `docker` then go into it. <br>
1 - Open your Laravel's `.env` file and set the `DB_HOST` to your `{Docker-IP}`:
```bash
mkdir docker && cd $_
```
3 - Clone the LaraDock repository inside that `docker` folder.
```bash
git clone https://github.com/LaraDock/laradock.git .
```
4 - Find your Docker IP address.
- If you are on Linux OS: your IP Address is `127.0.0.1` because the containers run directly on your localhost.
- If you are on MAC or Windows OS and using the **docker-machine**: start your docker machine then type `docker-machine ip {vm-name-here}`. *(The default IP is 192.168.99.100)*
- If you are on MAC or Windows OS and using **boot2docker**: type `boot2docker ip` when boot2docker is up.
5 - Open your hosts file `/etc/hosts`.
```bash
sudo nano /etc/hosts
```
6 - Map your `Docker IP` to the `laravel.dev` domain, by adding the following to the `hosts` file.
```bash
xxx.xxx.xxx.xxx laravel.dev
```
Don't forget to replace the `xxx.xxx.xxx.xxx` with your Docker IP Address.
7 - Open `docker-compose.yml` file and replace the `xxx.xxx.xxx.xxx` with your Docker IP Adress as well.
8 - Open your Laravel's `.env` file and set the `DB_HOST` and the `REDIS_HOST` to `laravel.dev` instead of the default `127.0.0.1`.
```env ```env
DB_HOST=laravel.dev DB_HOST=xxx.xxx.xxx.xxx
REDIS_HOST=laravel.dev
``` ```
[How to find my Docker IP Address?](#Find-Docker-IP-Address)
If you want to use Redis for Caching and/or for Sessions Management, set `CACHE_DRIVER` and `SESSION_DRIVER` to `redis` instead of the default `file`. <br>
2 - Run the Containers, (you can select the software's (containers) that you wish to run)
<br>
*Make sure you are in the `docker` folder before running the `docker-compose` command.*
```env > Running PHP, NGINX, MySQL and Redis:
CACHE_DRIVER=redis
SESSION_DRIVER=redis
```
9 - Finally run the containers. Make sure you are in the `docker` folder before running this command.
```bash ```bash
docker-compose up -d docker-compose up -d php nginx mysql redis
``` ```
*"Note: Only the first time you run this command, it will take up to 7 minutes (depend on your connection speed) to download the images to your local machine.* Note: you can choose your own combination of software's (containers), another example:
10 - Open your browser and visit `http://laravel.dev` > Running PHP, NGINX, Postgres and Memcached:
```bash
> Debugging: in case you faced an error here, it might be that you forget to provide some permissions for Laravel, so try running the following command on the Laravel rood directory: docker-compose up -d php nginx postgres memcached
`sudo chmod -R 777 storage && sudo chmod -R 777 bootstrap/cache` ```
Supported Containers: `nginx`, `mysql`, `redis`, `postgres`, `mariadb`, `memcached`, `beanstalkd`, `beanstalkd-console`, `data`, `php`.
<br>
3 - Open your browser and visit your `{Docker-IP}` address (`http://xxx.xxx.xxx.xxx`).
<br>
**Debugging**: in case you faced an error here, run this command from the Laravel root directory:
```bash
sudo chmod -R 777 storage && sudo chmod -R 777 bootstrap/cache
```
<br>
[Follow @Mahmoud_Zalt](https://twitter.com/Mahmoud_Zalt)
<br>
<a name="Documentation"></a> <a name="Documentation"></a>
## Documentation ## Documentation
#### See current running Containers <a name="List-current-running-Containers"></a>
#### List current running Containers
```bash ```bash
docker ps docker ps
``` ```
<br>
<a name="Close-all-running-Containers"></a>
#### Close all running Containers #### Close all running Containers
```bash ```bash
docker-compose stop docker-compose stop
``` ```
To stop single container do:
```bash
docker-compose stop {container-name}
```
<br>
<a name="Delete-all-existing-Containers"></a>
#### Delete all existing Containers #### Delete all existing Containers
```bash ```bash
docker-compose rm -f docker-compose rm -f
@ -153,64 +254,283 @@ docker-compose rm -f
*Note: Careful with this command as it will delete your Data Volume Container as well. (if you want to keep your Database data than you should stop each container by itself as follow):* *Note: Careful with this command as it will delete your Data Volume Container as well. (if you want to keep your Database data than you should stop each container by itself as follow):*
`docker stop {container-name}`
<br>
<a name="Build-Re-build-Containers"></a>
#### Build/Re-build Containers
If you do any change to any `dockerfile` make sure you run this command, for the changes to take effect:
```bash
docker-compose build
```
Optionally you can specify which container to rebuild (instead of rebuilding all the containers):
```bash
docker-compose build {container-name}
```
#### Remove Container <br>
To prevent a container (software) from running, open the `docker-compose.yml` file, and comment out the container section or remove it entirely. <a name="Change-the-PHP-Version"></a>
#### Change the PHP Version
By default **PHP 7.0** is running.
<br>
To change the default PHP version:
1 - Open the `docker-compose.yml`.
2 - Search for `Dockerfile-php-70` in the PHP container section.
3 - Change the version number.
<br>
Example to select version 5.6 instead of 7.0 you have to replace `Dockerfile-php-70` with `Dockerfile-php-56`.
Sample:
```txt
php:
build:
context: ./php
dockerfile: Dockerfile-php-70
```
Supported Versions:
- For (PHP 7.0.*) use `Dockerfile-php-70`
- For (PHP 5.6.*) use `Dockerfile-php-56`
- For (PHP 5.5.*) use `Dockerfile-php-55`
#### Add an Image (add a software to run with other Containers) 4 - Finally rebuild the container
To add an image (software), just edit the `laradock/docker/docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/yml/).
```bash
docker-compose build php
```
For more details visit the [official PHP docker images](https://hub.docker.com/_/php/).
#### Edit a Container (change Ports or Volumes) <br>
To modify a container you can simply open the `laradock/docker/docker-compose.yml` and change everything you want. <a name="Add-Docker-Images"></a>
#### Add more Software's (Docker Images)
Example: if you want to set the MySQL port to 3333, just replace the default port with yours: To add an image (software), just edit the `docker-compose.yml` and add your container details, to do so you need to be familiar with the [docker compose file syntax](https://docs.docker.com/compose/compose-file/).
<br>
<a name="Edit-Container"></a>
#### Edit default container configuration
Open the `docker-compose.yml` and change anything you want.
Examples:
Change MySQL Database Name:
```yml
environment:
MYSQL_DATABASE: laradock
```
Change Redis defaut port to 1111:
```yml ```yml
ports: ports:
- "3333:3306" - "1111:6379"
``` ```
#### Edit an existing Image (change some configuration in the image)
To edit an image, and take full control of it:
1. clone the LaraDock `docker-images` repository [https://github.com/LaraDock/docker-images](https://github.com/LaraDock/images)
2. modify whichever `Dockfile` you want
3. from the modified image directory run `docker build -t {your-image-name} .`
All the images are open source and hosted on the [Docker Hub](https://hub.docker.com/u/laradock/). <br>
<a name="Use-custom-Domain"></a>
#### Use custom Domain (instead of the Docker IP)
*If you find any bug or you have and suggestion that can improve the performance of any image, please consider contributing. Thanks in advance.* Assuming your custom domain is `laravel.dev` and your current `Docker-IP` is `xxx.xxx.xxx.xxx`.
1 - Open your `/etc/hosts` file and map your `Docker IP` to the `laravel.dev` domain, by adding the following:
```bash
xxx.xxx.xxx.xxx laravel.dev
```
2 - Open your Laravel's `.env` file and replace the `127.0.0.1` default values with your `{Docker-IP}`.
<br>
Example:
```env
DB_HOST=xxx.xxx.xxx.xxx
```
3 - Open your browser and visit `{http://laravel.dev}`
Optionally you can define the server name in the nginx config file, like this:
```
server_name laravel.dev;
```
<br>
<a name="View-the-Log-files"></a>
#### View the Log files #### View the Log files
The Log files are stored in the `docker/logs` directory. The Log files are stored in the `docker/logs` directory.
<a name="Supports"></a>
## Highlights
__Currently Supported Docker Images:__
- [NGINX+PHP](https://hub.docker.com/r/laradock/phpnginx/) <br>
- [MySQL](https://hub.docker.com/r/laradock/mysql/) <a name="Use-Redis"></a>
- [Redis](https://hub.docker.com/r/laradock/redis/) #### Use Redis
- [Beanstalked](https://hub.docker.com/r/laradock/beanstalkd/)
- [Data Volume](https://hub.docker.com/r/laradock/data/) (for MySQL & Redis) 1 - First make sure you run the Redis Container with the `docker-compose` command.
2 - Open your Laravel's `.env` file and set the `REDIS_HOST` to your `Docker-IP` instead of the default `127.0.0.1` IP.
```env
REDIS_HOST=xxx.xxx.xxx.xxx
```
If you don't find the `REDIS_HOST` variable in your `.env` file. Go to the database config file `config/database.php` and replace the default `127.0.0.1` IP with your `Docker-IP` for Redis like this:
```php
'redis' => [
'cluster' => false,
'default' => [
'host' => 'xxx.xxx.xxx.xxx',
'port' => 6379,
'database' => 0,
],
],
```
3 - To enable Redis Caching and/or for Sessions Management. Also from the `.env` file set `CACHE_DRIVER` and `SESSION_DRIVER` to `redis` instead of the default `file`.
```env
CACHE_DRIVER=redis
SESSION_DRIVER=redis
```
4 - Finally make sure you have the `predis/predis` package `(~1.0)` installed via Composer first.
```bash
composer require predis/predis:^1.0
```
5 - You can manually test it from Laravel with this code:
```php
\Cache::store('redis')->put('LaraDock', 'Awesome', 10);
```
<br>
<a name="Enter-Container"></a>
#### Enter a Container (SSH into a running Container)
1 - first list the current running containers with `docker ps`
2 - enter any container using:
```bash
docker exec -it {container-name-or-id} bash
```
3 - to exit a container, type `exit`.
<br>
<a name="AddRemove-a-Docker-Container"></a>
#### Add/Remove a Docker Container
To prevent a container (software) from running, open the `docker-compose.yml` file, and comment out the container section or remove it entirely.
<br>
<a name="Edit-a-Docker-Image"></a>
#### Edit a Docker Image
1 - Find the `dockerfile` of the image you want to edit,
<br>
example for `php` it will be `docker/php/dockerfile`.
2 - Edit the file the way you want.
3 - Re-build the container:
```bash
docker-compose build
```
*If you find any bug or you have and suggestion that can improve the performance of any image, please consider contributing. Thanks in advance.*
<br>
<a name="Run-Docker-Virtual-Host"></a>
#### Run a Docker Virtual Host
These steps are only for **Windows & MAC** users *(Linux users don't need a virtual host)*:
1 - Run the default Host:
```bash
docker-machine start default
```
* If the host "default" does not exist, create one using the command below, else skip it:
* ```bash
docker-machine create -d virtualbox default
```
2 - Run this command to configure your shell:
```bash
eval $(docker-machine env)
```
<br>
<a name="Find-Docker-IP-Address"></a>
#### Find your Docker IP Address
**On Windows & MAC:**
```bash
docker-machine ip default
```
*(The default IP is 192.168.99.100)*
**On Linux:**
Your IP Address is `127.0.0.1`
> **boot2docker** users: run `boot2docker ip` *(when boot2docker is up)*.
<br>
## Contributing ## Contributing
This little project was built by one man who has a full time job and many responsibilities, so if you like this project and you find that it needs a bug fix or support for new software or upgrade for the current containers, or anything else.. Do not hesitate to contribute, you are more than welcome :) This little project was built by one man who has a full time job and many responsibilities, so if you like this project and you find that it needs a bug fix or support for new software or upgrade for the current containers, or anything else.. Do not hesitate to contribute, you are more than welcome :)
All Docker Images can be found at [https://github.com/LaraDock](https://github.com/LaraDock)
## Support ## Support
@ -218,6 +538,10 @@ This little project was built by one man who has a full time job and many respon
### Questions?
If you have any question, send me a direct message on LaraChat, my username is `mahmoud_zalt`.
## Credits ## Credits
[![Mahmoud Zalt](https://img.shields.io/badge/Author-Mahmoud%20Zalt-orange.svg)](http://www.zalt.me) [![Mahmoud Zalt](https://img.shields.io/badge/Author-Mahmoud%20Zalt-orange.svg)](http://www.zalt.me)
@ -227,3 +551,4 @@ This little project was built by one man who has a full time job and many respon
## License ## License
[MIT License (MIT)](https://github.com/laradock/laradock/blob/master/LICENSE) [MIT License (MIT)](https://github.com/laradock/laradock/blob/master/LICENSE)
[]([]())

View File

@ -0,0 +1,15 @@
FROM php:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
RUN apt-get update && apt-get install -y curl
RUN curl -sL https://github.com/ptrofimov/beanstalk_console/archive/master.tar.gz | tar xvz -C /tmp
RUN mv /tmp/beanstalk_console-master /source
RUN apt-get remove --purge -y curl && apt-get autoclean && apt-get clean
RUN rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
EXPOSE 2080
CMD bash -c 'BEANSTALK_SERVERS=$BEANSTALKD_PORT_11300_TCP_ADDR:11300 php -S 0.0.0.0:2080 -t /source/public'

16
beanstalkd/Dockerfile Normal file
View File

@ -0,0 +1,16 @@
FROM phusion/baseimage:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
ENV DEBIAN_FRONTEND noninteractive
ENV PATH /usr/local/rvm/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
RUN apt-get update
RUN apt-get install -y beanstalkd
RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
VOLUME /var/lib/beanstalkd/data
EXPOSE 11300
CMD ["/usr/bin/beanstalkd"]

5
data/Dockerfile Normal file
View File

@ -0,0 +1,5 @@
FROM debian:jessie
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
CMD ["true"]

View File

@ -1,65 +1,129 @@
########################################################### version: '2'
# MAINTAINER: Mahmoud Zalt <mahmoud@zalt.me> #
###########################################################
# PHP + NGINX Container #---------------------------------- services:
php-nginx:
image: laradock/phpnginx:latest ### Nginx Server Container ##################################
container_name: php-nginx
nginx:
build: ./nginx
volumes_from:
- php
volumes:
- ./logs/nginx/:/var/log/nginx
ports: ports:
- "80:80" - "80:80"
volumes:
- ./settings/nginx:/etc/nginx/sites-available
- ../:/var/www
- ./logs/nginx:/var/log/nginx
links: links:
- mysql - php
- redis
privileged: true
extra_hosts:
- "laravel.dev:xxx.xxx.xxx.xxx"
# MySQL Container #---------------------------------------- ### PHP Container ###########################################
mysql:
image: laradock/mysql:latest php:
container_name: mysql build:
ports: context: ./php
- "3306:3306" dockerfile: Dockerfile-php-70
volumes:
- ../:/var/www/laravel
- ./logs/php/:/usr/local/var/log
expose:
- "9000"
### DATA Container ##########################################
data:
build: ./data
volumes:
- /var/lib/mysql
- /var/lib/postgres
- /var/lib/mariadb
- /var/lib/redis
- /var/lib/memcached
### MySQL Container #########################################
mysql:
build: ./mysql
volumes_from: volumes_from:
- data - data
ports:
- "3306:3306"
environment: environment:
MYSQL_DATABASE: homestead MYSQL_DATABASE: homestead
MYSQL_USER: homestead MYSQL_USER: homestead
MYSQL_PASSWORD: secret MYSQL_PASSWORD: secret
privileged: true MYSQL_ROOT_PASSWORD: root
links:
- php
# Redis Container #---------------------------------------- ### PostgreSQL Container ####################################
redis:
image: laradock/redis:latest postgres:
container_name: redis build: ./postgres
ports:
- "6379:6379"
volumes_from: volumes_from:
- data - data
volumes: ports:
- ./logs/redis:/var/log/redis - "5432:5432"
restart: always environment:
POSTGRES_DB: homestead
POSTGRES_USER: homestead
POSTGRES_PASSWORD: secret
links:
- php
### MariaDB Container #######################################
mariadb:
build: ./mariadb
volumes_from:
- data
ports:
- "3306:3306"
environment:
MYSQL_DATABASE: homestead
MYSQL_USER: homestead
MYSQL_PASSWORD: secret
MYSQL_ROOT_PASSWORD: root
links:
- php
### Redis Container #########################################
redis:
build: ./redis
volumes_from:
- data
ports:
- "6379:6379"
links:
- php
### Memcached Container #####################################
memcached:
build: ./memcached
volumes_from:
- data
ports:
- "11211:11211"
links:
- php
### Beanstalkd Container ####################################
beanstalkd:
build: ./beanstalkd
ports:
- "11300:11300"
privileged: true privileged: true
links:
- php
# Data Volume Container #---------------------------------- ### Beanstalkd-Console Container ############################
data:
image: laradock/data:latest
container_name: data
volumes:
- /var/lib/mysql
- /var/lib/redis
# Beanstalkd Container #----------------------------------- beanstalkd-console:
# beanstalkd: build: ./beanstalkd-console
# image: laradock/beanstalkd:latest ports:
# container_name: beanstalkd - "2080:2080"
# ports: links:
# - "11300:11300" - beanstalkd
# privileged: true
#---------------------------------------------------------- ### Add more Containers below ###############################

7
mariadb/Dockerfile Normal file
View File

@ -0,0 +1,7 @@
FROM mariadb:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
CMD ["mysqld"]
EXPOSE 3306

7
memcached/Dockerfile Normal file
View File

@ -0,0 +1,7 @@
FROM memcached:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
CMD ["memcached"]
EXPOSE 11211

7
mysql/Dockerfile Normal file
View File

@ -0,0 +1,7 @@
FROM mysql:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
CMD ["mysqld"]
EXPOSE 3306

14
nginx/Dockerfile Normal file
View File

@ -0,0 +1,14 @@
FROM nginx:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
ADD nginx.conf /etc/nginx/
ADD laravel.conf /etc/nginx/sites-available/
RUN echo "upstream php-upstream { server php:9000; }" > /etc/nginx/conf.d/upstream.conf
RUN usermod -u 1000 www-data
CMD ["nginx"]
EXPOSE 80 443

View File

@ -2,18 +2,16 @@ server {
listen 80 default_server; listen 80 default_server;
listen [::]:80 default_server ipv6only=on; listen [::]:80 default_server ipv6only=on;
root /var/www/public; root /var/www/laravel/public;
index index.php index.html index.htm; index index.php index.html index.htm;
server_name laravel.dev;
location / { location / {
try_files $uri $uri/ /index.php$is_args$args; try_files $uri $uri/ /index.php$is_args$args;
} }
location ~ \.php$ { location ~ \.php$ {
try_files $uri /index.php =404; try_files $uri /index.php =404;
fastcgi_pass unix:/var/run/php5-fpm.sock; fastcgi_pass php-upstream;
fastcgi_index index.php; fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params; include fastcgi_params;
@ -23,3 +21,6 @@ server {
deny all; deny all;
} }
} }

29
nginx/nginx.conf Normal file
View File

@ -0,0 +1,29 @@
user www-data;
worker_processes 4;
pid /run/nginx.pid;
events {
worker_connections 2048;
multi_accept on;
use epoll;
}
http {
server_tokens off;
sendfile on;
tcp_nopush on;
tcp_nodelay on;
keepalive_timeout 15;
types_hash_max_size 2048;
include /etc/nginx/mime.types;
default_type application/octet-stream;
access_log off;
error_log off;
gzip on;
gzip_disable "msie6";
include /etc/nginx/conf.d/*.conf;
include /etc/nginx/sites-available/*;
open_file_cache max=100;
}
daemon off;

23
php/Dockerfile-php-55 Normal file
View File

@ -0,0 +1,23 @@
FROM php:5.5-fpm
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
ADD ./laravel.ini /usr/local/etc/php/conf.d
ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
RUN apt-get update && apt-get install \
libpq-dev -y \
curl
# Install extensions using the helper script provided by the base image
RUN docker-php-ext-install \
pdo_mysql \
pdo_pgsql
RUN usermod -u 1000 www-data
WORKDIR /var/www/laravel
CMD ["php-fpm"]
EXPOSE 9000

23
php/Dockerfile-php-56 Normal file
View File

@ -0,0 +1,23 @@
FROM php:5.6-fpm
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
ADD ./laravel.ini /usr/local/etc/php/conf.d
ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
RUN apt-get update && apt-get install \
libpq-dev -y \
curl
# Install extensions using the helper script provided by the base image
RUN docker-php-ext-install \
pdo_mysql \
pdo_pgsql
RUN usermod -u 1000 www-data
WORKDIR /var/www/laravel
CMD ["php-fpm"]
EXPOSE 9000

32
php/Dockerfile-php-70 Normal file
View File

@ -0,0 +1,32 @@
FROM php:7.0-fpm
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
ADD ./laravel.ini /usr/local/etc/php/conf.d
ADD ./laravel.pool.conf /usr/local/etc/php-fpm.d/
RUN apt-get update && apt-get install \
libpq-dev -y \
curl \
libmemcached-dev
# Install extensions using the helper script provided by the base image
RUN docker-php-ext-install \
pdo_mysql \
pdo_pgsql
# Install Memcached for php 7
RUN curl -L -o /tmp/memcached.tar.gz "https://github.com/php-memcached-dev/php-memcached/archive/php7.tar.gz" \
&& mkdir -p /usr/src/php/ext/memcached \
&& tar -C /usr/src/php/ext/memcached -zxvf /tmp/memcached.tar.gz --strip 1 \
&& docker-php-ext-configure memcached \
&& docker-php-ext-install memcached \
&& rm /tmp/memcached.tar.gz
RUN usermod -u 1000 www-data
WORKDIR /var/www/laravel
CMD ["php-fpm"]
EXPOSE 9000

3
php/laravel.ini Normal file
View File

@ -0,0 +1,3 @@
date.timezone = UTC
display_errors = Off
log_errors = On

76
php/laravel.pool.conf Normal file
View File

@ -0,0 +1,76 @@
; Unix user/group of processes
; Note: The user is mandatory. If the group is not set, the default user's group
; will be used.
user = www-data
group = www-data
; The address on which to accept FastCGI requests.
; Valid syntaxes are:
; 'ip.add.re.ss:port' - to listen on a TCP socket to a specific address on
; a specific port;
; 'port' - to listen on a TCP socket to all addresses on a
; specific port;
; '/path/to/unix/socket' - to listen on a unix socket.
; Note: This value is mandatory.
listen = 0.0.0.0:9000
; Choose how the process manager will control the number of child processes.
; Possible Values:
; static - a fixed number (pm.max_children) of child processes;
; dynamic - the number of child processes are set dynamically based on the
; following directives. With this process management, there will be
; always at least 1 children.
; pm.max_children - the maximum number of children that can
; be alive at the same time.
; pm.start_servers - the number of children created on startup.
; pm.min_spare_servers - the minimum number of children in 'idle'
; state (waiting to process). If the number
; of 'idle' processes is less than this
; number then some children will be created.
; pm.max_spare_servers - the maximum number of children in 'idle'
; state (waiting to process). If the number
; of 'idle' processes is greater than this
; number then some children will be killed.
; ondemand - no children are created at startup. Children will be forked when
; new requests will connect. The following parameter are used:
; pm.max_children - the maximum number of children that
; can be alive at the same time.
; pm.process_idle_timeout - The number of seconds after which
; an idle process will be killed.
; Note: This value is mandatory.
pm = dynamic
; The number of child processes to be created when pm is set to 'static' and the
; maximum number of child processes when pm is set to 'dynamic' or 'ondemand'.
; This value sets the limit on the number of simultaneous requests that will be
; served. Equivalent to the ApacheMaxClients directive with mpm_prefork.
; Equivalent to the PHP_FCGI_CHILDREN environment variable in the original PHP
; CGI. The below defaults are based on a server without much resources. Don't
; forget to tweak pm.* to fit your needs.
; Note: Used when pm is set to 'static', 'dynamic' or 'ondemand'
; Note: This value is mandatory.
pm.max_children = 20
; The number of child processes created on startup.
; Note: Used only when pm is set to 'dynamic'
; Default Value: min_spare_servers + (max_spare_servers - min_spare_servers) / 2
pm.start_servers = 2
; The desired minimum number of idle server processes.
; Note: Used only when pm is set to 'dynamic'
; Note: Mandatory when pm is set to 'dynamic'
pm.min_spare_servers = 1
; The desired maximum number of idle server processes.
; Note: Used only when pm is set to 'dynamic'
; Note: Mandatory when pm is set to 'dynamic'
pm.max_spare_servers = 3
;---------------------
; Make specific Docker environment variables available to PHP
env[DB_1_ENV_MYSQL_DATABASE] = $DB_1_ENV_MYSQL_DATABASE
env[DB_1_ENV_MYSQL_USER] = $DB_1_ENV_MYSQL_USER
env[DB_1_ENV_MYSQL_PASSWORD] = $DB_1_ENV_MYSQL_PASSWORD
catch_workers_output = yes

7
postgres/Dockerfile Normal file
View File

@ -0,0 +1,7 @@
FROM postgres:latest
MAINTAINER Ben M <git@bmagg.com>
CMD ["postgres"]
EXPOSE 5432

9
redis/Dockerfile Normal file
View File

@ -0,0 +1,9 @@
FROM redis:latest
MAINTAINER Mahmoud Zalt <mahmoud@zalt.me>
#COPY redis.conf /usr/local/etc/redis/redis.conf
CMD [ "redis-server" ]
EXPOSE 6379