This is a super simple zero configuration Docker boilerplate for Laravel 5.8, intended for getting an environment started quickly and training purposes.
Check these requirements before starting:
- Ensure that Docker is installed
- Ensure that no other containers/projects are running:
docker ps - Ensure that there are no other servers reserving port 80 and 3306
- An IDE you're comfortable with, e.g. PhpStorm, VSCode, etc
- Sequel Pro or similar MySQL GUI
Follow these steps for a branch new installation:
- In terminal, browse to a place to install the project
- Run:
git clone [email protected]:KomodoHQ/docker-laravel.git myapp - Enter your project:
cd myapp - Start the project:
./scripts/start.sh
If this is the first time you've started the project it may take some time as it will install composer packages.
Once the project is booted, you should see the Laravel welcome screen at http://localhost.
NOTE: Before starting your work, ensure that you have created a new Git repository for your project using the steps below:
- In terminal, browse to your project directory
- Delete the unwanted .git directory:
rm -rf .git - Initialise your own project repositry:
git init - Add the Laravel framework files:
git add . - Commit to the repo:
git commit -m "Initial Laravel files" - Begin the work and commit regularly!
In some cases you may want to connect to your MySQL server via a GUI, you can do this using Sequel Pro.
When setting up a new connection, set thet host to 127.0.0.1 and you will find the username/password credentials within the environment section of the docker-compose.yml file located in this project.
The project contains some helper scripts for common tasks which you can run from your host machine at the project root:
./scripts/start.sh - Start the project, on first run will install composer packages and run the initial database migrations.
./scripts/down.sh - Kill the project containers.
./scripts/down-with-volumes.sh - Kill the project containers and also delete all associated volumes, this will also remove MySQL database data.
./scripts/clean.sh - Clean the project and return it back to the previous state before the project was booted, will clear caches and composer packages.
If you have any issues or feature requests, please get in touch or create a pull request!
-- Happy coding!