## Idea
This Project aims to simplify setting up a laravel project in a local development environment for new and experienced developers.

It stores all data (excluding the built docker image) in a single directory to make it easy for a developer to remove existing projects again and keep their system clutter-free.

The only **dependencies** for this project are **git** and **docker(-compose)**.

Tested shells are: `bash`, `zsh`

## Content
This project ships with a custom docker container based on **php:8.2-apache** with the php extensions opcache, pdo_mysql, intl, and zip.

It also includes **mysql:8** and **phpmyadmin:latest**.

## Other useful info
- To reset the Database, stop the Docker containers, go to the project root and execute `rm -rf dbdata`. Then execute `./setup`.
- The apps and PMAs port can be changed by editing the `SETUP_APP_PORT` and `SETUP_PMA_PORT` variables in `.env`. This resets after running `./setup`.

## Setup
### Windows with VSCode
- If WSL isn't installed yet, install it by executing `wsl --install` in your preferred shell.
- Open WSL from startmenu or your preferred shell by executing `wsl`.
- Open VSCode by executing `code`.
- Wait until the VSCode server is installed.
- VSCode should open up. Press F1 and use `WSL: Connect to WSL` command.
- Press F1 and use `Git: Clone` to clone this repo.
- `cd` into this repo (the laravel-setup-script directory).
- Press F1 and use `Git: Clone` again. Make sure to clone it into this repo's folder and to NOT open the cloned repository and instead click `cancel`.
- Rename your project to `laravel` by either using the `mv` command in the VSCode terminal or by right-clicking on the directory in VSCode and clicking `rename`.
- Start Docker Desktop on Windows.
- Type `./setup` into the VSCode terminal.
- Type `./start` into the VSCode terminal.
- Done!
#### Tips & Tricks
- If you encounter any Docker-related issues, it might help to close Docker Engine and stop WSL by executing `wsl -t ubuntu` in your preferred shell. After that, start both again.
- If you want to commit to your laravel repo with the VSCode F1 commands, make sure to switch to the folder your repo is in first. This can be done via `File` => `Open Folder...`

### Linux
- If you're a (sigma) Linux user, follow the Windows instructions starting from when the repo should be cloned.
- Make sure you have access to the `docker` and `docker compose` commands.
- Make sure you started the Docker Daemon; that's `rc-service docker start` for Open-RC based distros and `systemctl start docker` for Systemd based distros. If you're not sure what type of distro you're running, you probably run a Systemd based one.