https://github.com/lakshan-madushanka/docker-compose-laravel
Docker compose Laravel setup
https://github.com/lakshan-madushanka/docker-compose-laravel
docker docker-compose laravel mailhog mysql nginx php redis
Last synced: 8 months ago
JSON representation
Docker compose Laravel setup
- Host: GitHub
- URL: https://github.com/lakshan-madushanka/docker-compose-laravel
- Owner: Lakshan-Madushanka
- Created: 2022-02-24T17:30:11.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-02-26T12:33:48.000Z (over 3 years ago)
- Last Synced: 2025-02-10T19:04:51.521Z (8 months ago)
- Topics: docker, docker-compose, laravel, mailhog, mysql, nginx, php, redis
- Language: PHP
- Homepage:
- Size: 79.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# DOCKER COMPOSE SETUP FOR LARAVEL
This provides all the services and extensions to develop laravel applications.
## Services
Following services have been configured with respective ports.
- **php (7.4)** - `:9000`
- **nginx** - `:80`
- **mysql (8.0)** - `:3306`
- **redis (7.0)** - `:6379`
- **mailhog** - `:8025`
- **php** - `:9000`
- **xdebug**
## Usage
To get started, docker needs to be installed. To check it run the below command in a terminal.
```
docker -v
```
To install docker follow the instructions on the official site.
https://docs.docker.com/get-docker/
After docker is installed, put your laravel project in src folder (the test project has been configured you must remove it).
.env file must in the same directory docker-compose.yml exists.
clone the repository and run the below command in the terminal.
```
docker-compose build
```
After build finished services can be started using,
```
docker-compose up
```
*shorten command*
```
docker-compose up --build app
```
```
php artisan migrate
```
So stop all containers,
```
docker-compose down
```
# Testing
The test project has been configured to make sure everything work fine,
1). Run composer install command in src directory.
2). open a web browser, and enter the link http://localhost:821/docker-testyou will get the below results.
```
Mysql connection status : succeeded !
----------
MailHog connection status : succeeded !
----------
Redis connection status : succeeded !
```
- Alternatively, you can check health status using the below docker command.
```
docker ps
```
## configurations
Configurations can be found in the configs folder.
As an example if you need to override Nginx configurations you can edit laravel_nginx.config file in confgs/nginx/ folder.
## Data
Data like Nginx access.log error.log can be found in the data folder this will help to debug purposes.
## MySQL storage persistense
By default, all the data inside docker containers are destroyed after bringing down the containers. So each time fresh start a docker container you have to run the below commands to load the MySQL db.
```
php artisan migrate
php artisan db:seed
```
To avoid this dilemma docker MySQL service volume has been bound in the docker-compose.yml file.
```
volumes:
- ./data/mysql/lib_data:/var/lib/mysql
```
Remove this line if you need default behavior.
## Advanced usage
- **Xdebug**
Xdebug is installed and enabled by default and uses port 9000. You just need to configure your IDE.
For PHPStorm, all you need to do is:
- Install the Browser extension: [https://www.jetbrains.com/help/phpstorm/browser-debugging-extensions.html](https://www.jetbrains.com/help/phpstorm/browser-debugging-extensions.html)
- Start listening, from the Menu: Run > Start Listening for PHP Debug Connections.
In API development you need to send a query param with the request like below
https://new-api.local/api/login?XDEBUG_SESSION_START=filter_string`
for the PhpStorm, the filter string is PHPSTORM
In postman, this can be automated using Pre-request Script.
`