A Complete Docker based development environment for Laravel & PHP

Ariful Haque — Sun, 16 May 2021 08:08:55 +0000

Laravel Docker App is a complete Laravel, PHP Development environment that is very similar to production environment. This has separate nginx, app, MySQL, Redis, queue and scheduler services to make the development environment most similar to a production environment.

arifulhb / laravel-docker-app

A complete Laravel, PHP Docker based development environment with individual Nginx, Web app, Queue, Scheduler, Redis containers.

Laravel-Docker-App

Laravel, PHP7.3, Nginx, MySQL 5.7, Redis Docker Container

A complete Laravel, PHP Development environment that is very similar to production environment.

Docker Compose based Laravel development environment with individual App (Laravel app), Nginx, Database (MySQL), Queue, Scheduler, Redis services.

Installation

Install Laravel

Clone the repo at your development machine. Go to your Laravel Docker directory. Then Run this

sh install

A bash script will download latest Laravel zip and then unzip the Laravel project into the app directory.

Update Laravel Version

To update Laravel version before installaiton, edit the install file in root directory.

Docker Container management

Build containers

Run this to build your docker containers for each services (app, database, queue, scheduler, redis).

docker-compose build

Run the containers

docker-compose up

To run the services at background

docker-compose up -d

SSH into your app console

To install Laravel, generate app key…

View on GitHub

Why Laravel Docker App?

There are many other docker images are available in GitHub for Laravel app development. But most of them are either too complicated, very heavy image size, or doesn't allow to run Queue in Redis or manually need to test scheduler by running php artisan command. To overcome these issues, I worked on this Docker Compose structure to run the App, Queue and scheduler in different services where Nginx, MySQL and Redis services are shared where needed.

How to start

For new project.

For new project, first you need to clone the repo from Github

git clone https://github.com/arifulhb/laravel-docker-app.git

and then need to run sh install from the rood directory of the cloned project. It will download Laravel and unzip in a new directory which is called app.

After the directory is created, need to run the command bellow to build the images.

docker-compose build

A full set of commands to manage docker containers can be found in the Readme.md file.

For existing project

For existing project, you need to copy the project directory into the newly cloned directory and rename the project folder name app. If you want to rename the project directory to something else, you need to update the docker-compose file and Dockerfile.dev files in the docker/images/* directory.

Run the containers

  docker-compose up

To run the services at background

  docker-compose up -d

Image of running containers.

Run docker ps to see the containers running in background.

Run docker stats to see the memory and cpu usages of the containers.

SSH into your app console

To install Laravel, generate app key and run migrations, you need to ssh to your app container service. To ssh to your app container, run this.

docker-compose exec app sh

This will take you to /var/www/app path inside your app service container. Now you can run your composer install and other Laravel or PHP specific commands there.

To ssh into other containers, replace the app with other container name as scheduler, queue. e.g.

docker-compose exec queue sh

Stop running containers

docker-compose stop

Environment Variables

PHP

If you want to change, enable/disable any PHP settings, you can change them in ./docker/config/php/php-ini-development.ini file and then build and up the container again.

MySQL

MySQL username, password can be changed from docker-compose.yml file. Fin the environment section under mysql. Change the value and build the mysql image again with docker-compose build mysql.

  environment:
    MYSQL_DATABASE: app
    MYSQL_ROOT_PASSWORD: root
    MYSQL_USER: admin
    MYSQL_PASSWORD: secret

After you change the value and build, you need to restart the mysql service docker-compose up mysql to make it affective.

Nginx

If you want to change Nginx web host configurations, you can find the file at ./docker/images/web/sites/default.dev.conf

Storage and Logs

This Laravel-docker-app leverage the power of docker volume and store some the docker container data at your host machine. Here is the details of folder structure and what data it contain:

./docker/data/mysql contain mysql database files
./docker/data/redis contain redis database file
./docker/data/web contain nginx webserver logs #### Connecting MySQL with local desktop client.

host: 0.0.0.0
username: root
password: root
port: 33066

Why of Laravel-docker-app

At the moment, there are many other Laravel Docker github repo or packages available, so why this new package again? Here I'll list few of my points:

This docker app images is based on alpine based PHP image, which makes it very light weight.
This is built on service based architecture. Usually for Laravel application, there should be Queue and cron running on behind. In this system, you can run Queue, Scheduler container separately and Queue will listen to a separate Redis database.
It's the most compatible with production environment. Very easily this can be converted to a production grade, scalable service.

Browse your site locally

You can find your site running at http://localhost

Conclusion

If you have any question, you can ask me in the comment or create an issue in the repo. If you have any improvement suggestion, a PR in the repo is most welcome.
I'd be really encouraged if I receive Star and Forks in the repo and Like in the article.

How to receive $1000 AWS Active Credit for your side project or startup

Ariful Haque — Sat, 08 May 2021 10:37:11 +0000

I've signed up with AWS in 2015 and all of my free-tire credits are exhausted few years ago. But that didn't stop me for using AWS with my own money.

I am running three different websites (all hobby projects) in four t3.small EC2 instances with one RDS instance in similar t3.small instance, one Application Load Balancer, ECS and using few other services. On average I was paying around $100_(+-$10)_ in every month.

Few months ago I learned about AWS Active program, which actually help developers and startups to by allowing them to use AWS services and resources freely by providing free AWS Credit. I wasn't quite sure if my startup/side project LaptopList.com can be eligible for applying the credits as its just a website I coded myself and deployed to AWS. But I decided to apply for the fund anyway.

Here I'll explain how you can apply for the fund and possibly save $1000 for your hobby project bills in AWS.

Applying for Active Fund

To apply for the fund, you'll definitely need an active AWS account.

Use the Apply Now button to initiate your application. It will redirect you to sign in to AWS. After sign in, you'll see two different category and you need to pick which category you are in. I've selected Founders package. Bonus is, if you are the developer of the product, you'll get $300 as Developers Credit, which I have also received.

Step 1

After choosing your category, you'll see a page which looks similar and it will ask you to verify your account and opt for applying the credit to currently logged-in account.

Step 2

In the step two, you'll need to provide some more information about your startup like Company name, Location, Profile, When founded, how many peoples working, if you already have any funding (I didn't had any).
Then you'll need to mention about your product, and which AWS services you are using.

Step 3

In step 3, it's just information about you, your contact info, role in the startup/product, your LinkedIn profile, etc and thats it.

Once you successfully complete the application, they'll say it will take around 7-10 business days to review your application and then they'll send update about your application status. But it took only 3 days for my application.

Receiving the fund

Once I received the email about my application getting approved, I Logged into my AWS console and visited AWS Billing Dashboard > Credit and saw this beautiful data there.

Conclusion

I hope the information provided here will help you to submit your application and I wish you best of luck. Please don't forget to share in the comment if you received your AWS Credits and also comment if you have any question. I'll try my best to help you as much I can.

If you feel this article can be helpful, please like and share the article in your community.

DEV Community: Ariful Haque

A Complete Docker based development environment for Laravel & PHP

arifulhb / laravel-docker-app

A complete Laravel, PHP Docker based development environment with individual Nginx, Web app, Queue, Scheduler, Redis containers.

Laravel-Docker-App

Laravel, PHP7.3, Nginx, MySQL 5.7, Redis Docker Container

Installation

Install Laravel

Update Laravel Version

Docker Container management

Build containers

Run the containers

To run the services at background

SSH into your app console

Why Laravel Docker App?

How to start

For new project.

For existing project

Run the containers

Image of running containers.

SSH into your app console

Stop running containers

Environment Variables

PHP

MySQL

Nginx

Storage and Logs

Why of Laravel-docker-app

Browse your site locally

Conclusion

How to receive $1000 AWS Active Credit for your side project or startup

Applying for Active Fund

Step 1

Step 2

Step 3

Receiving the fund

Conclusion