Getting Started
- API Laravel Boilerplate 5.5
- Apache 2
- MySQL
- Xdebug
- Docker
You can manage a RESTful API in the fastest, simplest and funniest way! and with open source code dependencies.
However you can contribute for better performance, the goal is to focus on the code avoiding the configurations and having docker installed.
Prerequisites
Environments
Dev or Local Mode
- docker-compose-dev.yml: generate automatically folders and require-dev dependencies on your local workspace including Xdebug. Note: the yaml file has a key called:"XDEBUG_MODE", this yaml by default has the value true (1) to install it.
You can appreciate the dependencies generated automatically on your workspace!
Play with Docker Mode
- docker-compose-pwd.yml: you can use it to visualize this environment and test it, however, you should see the container lists to verify the HEALTHCHECK.
# container lists
docker ps
# make sure that the docker dockerlaravelapidev_php_1 or php container is (healthy),
normally the process begins in starting mode (health: starting)
Production Mode
- docker-compose-prod.yml: if you are going to use this yaml, make sure to generate the migrations before!, you can modify the entrypoint to generate them.
Deployment
Docker Environments
Clone this repository and run the following commands based on your orchestrator.
Swarm Mode
Clone this repository and run the following commands:
cd docker-laravel-api-dev/
docker stack deploy -c docker-compose-dev.yml docker-laravel-api-dev
# wait for the HEALTHCHECK in healthy mode
Docker Compose
Clone this repository and run the following commands:
cd docker-laravel-api-dev/
docker-compose -f docker-compose-dev.yml up --build -d
or to see the logs
docker-compose -f docker-compose-dev.yml up
# wait for the HEALTHCHECK in healthy mode
Running the tests
You have a Travis Pipeline to apply Continous Integration, and other technology to test this environment.
You can modify the runtests.sh from the scripts folder
Insert jobs, instructions builds in this pipeline
Github Repository
API Boilerplate Reference
Author
License
This project is licensed under the MIT License - see the LICENSE.md file for more details.
Top comments (1)
Great post