GET STARTED WITH DOCKER :

More Infos :

Docker Documentation

-----------------------------------------------------

Prerequisites

Install Docker on your system.

Install instructions for Mac OS X
Install instructions for Ubuntu
Install instructions for Windows (prefer "Docker For Windows" than deprecated "Docker Toolbox")

Note that using "Docker Toolbox" on Windows OS can occur unexpected issues ...

Install Docker Compose on your system.

Install instructions for all supported systems

Check that you can use docker commands without sudo ! [LINUX USER ONLY]

To run docker command without sudo, you need to add your user (who has root privileges) to docker group & restart your sessions.
```
  $ sudo usermod -aG docker <user_name>
```

-----------------------------------------------------

Installation:

A Makefile is used to provide some useful shortcuts for manipulating docker & docker-compose commands

1- Create .env file :

First, you need to create a copy of .env.example and call it .env
```
  # Assume you are in project root, on Unix system
  $ cp .env.example .env
```
This files contains sensible data that not be committed on GIT, you can modify it to you own needs !
1- Set the .env file :

Update variables in .env file to fit your config
```
  # Assume you are in project root, on Unix system
  $ vi .env
```
Because we use grumphp, we need to configure git inside the container to be able to commit properly
2- Make the ☕ :

Run following command :
```
  $ make init
```
This command will create & build Docker images, also start & configures required Containers, and run provisioning script. A lot of stuff is downloaded from Internet, so it can take a lot of time, depending on your Internet speed.
3- Your done !

You can now access to following services on your host machine:

Symfony app http://localhost
Mailhog http://localhost:1080
PhpMyAdmin http://localhost:8080

When you reboot your computer :

Just simply run following command to start your Containers (docker Images already created):
```
  $ make start
```

-----------------------------------------------------

Makefile "tasks" :

You can read Makefile located at project root, it contain some comments on what "recipes" do. Feel free to add more extra recipes depending on your needs.

# List available make commands:
$ make help

Recipes	Utility
start	Start containers (Also builds & pull images, if there not exists)
stop	Stop containers & remove docker networks
list	List current running containers
ssh	Start new bash terminal inside the Symfony Container
init	Execute "start" tasks and run provisioning scripts
tests	Execute the entire Unitary & Functional PhpUnit tests suit
code-coverage	Run the entire tests with code coverage
logs	Display current running containers logs (Press "Ctrl + c" to exit)
clean-sf-cache	Clean symfony cache & logs files
clean-container	Remove stopped useless containers
help	Display available make commands

-----------------------------------------------------

Dev Tools :

You can use make ssh to connect inside the symfony container.

What is inside ?

PHP 7.1-fpm with xdebug (dev) or OpCache & APCu (prod)
Nodejs (6.x)
Yarn
Phpmetrics
Php-cs-fixer
Grumphp
Git (with user config)
Tig

Other service

Mailhog for email testing during development
PhpMyAdmin a simply mysql administrator

-----------------------------------------------------

Deploy in Production :

If you want to use in production, you need to :

Get SSL certificates, Let's Encrypt provide them for free

You also need to generate a dhparam.pem keys to enforce SSL encryption

  # To generate your dhparam.pem file, run in the terminal
  openssl dhparam -out dhparam.pem 4096

Copy your fullchain.pem & privkey.pem & dhparam.pem to .data/web directory
Update .env file and set ENV to "prod"
Update nginx prod conf and set server_name at line 4 & line 39
Run make start
The first time, you need to build app yourself (like installing vendor & set parameter.yml ...)

Test your app, http redirect to https. ssl labs analysis give you a A+ baby !

Thibaut-gauvin/symfony3_docker

ErrorLooks like something went wrong!

About

Topics

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages