feat: add db recreation target and update Laravel setup docs

.dockerignore

@@ -1,3 +1,3 @@
 *
 !docker/entrypoint.sh
-!docker/php.ini
+!docker/php-fpm.conf

.editorconfig

@@ -19,6 +19,3 @@ indent_size = 2
 
 [Makefile]
 indent_style = tab
-
-[justfile]
-indent_size = 2

.env.example

@@ -1,13 +1,10 @@
-# Database
-# config/database.php
 DB_CONNECTION=mysql
 DB_HOST=mysql
 DB_PORT=3306
 DB_DATABASE=app
 DB_USERNAME=laravel
 DB_PASSWORD=secret
-
-# Docker
 DB_ROOT_PASSWORD=secret
+
 APP_UID=1000
 APP_GID=1000

.gitignore

@@ -9,7 +9,7 @@ Homestead.json
 # Vendor / dependencies
 /vendor
 /composer/
-.composer/
+.composer-hash
 
 # Laravel storage and cache
 /storage/*.key
@@ -23,7 +23,6 @@ Homestead.json
 # Build artifacts
 /public/build
 /public/hot
-/public/docs
 /bootstrap/cache/*
 !/bootstrap/cache/.gitignore
 
@@ -36,12 +35,40 @@ Homestead.json
 /.vscode
 .phpactor.json
 .scribe/
+.scribe-hash
 
 # System / logs
 *.log
 .DS_Store
 Thumbs.db
 .bash_history
+/bootstrap/ssr
+/node_modules
+/public/build
+/public/hot
+/public/storage
+/storage/*.key
+/storage/pail
+/resources/js/actions
+/resources/js/routes
+/resources/js/wayfinder
+/vendor
+.DS_Store
+.env
+.env.backup
+.env.production
+.phpactor.json
+.phpunit.result.cache
+Homestead.json
+Homestead.yaml
+npm-debug.log
+yarn-error.log
+/auth.json
+/.fleet
+/.idea
+/.nova
+/.vscode
+/.zed
 
-# Custom
+.composer-hash
-.hashes/
+.scribe-hash

Makefile

@@ -0,0 +1,61 @@
+-include .env
+APP_UID ?= 1000
+APP_GID ?= 1000
+
+IMAGE_NAME := laravel-setup-php-fpm
+IMAGE_TAG  := latest
+IMAGE      := $(IMAGE_NAME):$(IMAGE_TAG)
+TAR_FILE   := $(IMAGE_NAME)_$(IMAGE_TAG).tar.gz
+
+.PHONY: help build load shell docs db
+
+help:
+	@echo "Usage:"
+	@echo "  make <target> [SOURCE=...]"
+	@echo ""
+	@echo "Targets:"
+	@echo "  build         Build Docker image and save to archive"
+	@echo "  load          Load Docker image from archive, URL, or build if missing"
+	@echo "                Optional: SOURCE=url_or_file"
+	@echo "  shell         Enter php-fpm container as www"
+	@echo "  docs          Regenerate API documentation"
+	@echo "  db            Recreate DB"
+
+
+build:
+	@echo "Building image..."
+	docker build -f docker/Dockerfile --build-arg UID=$(APP_UID) --build-arg GID=$(APP_GID) -t $(IMAGE) .
+	@echo "Saving image to $(TAR_FILE)..."
+	docker save $(IMAGE) | gzip > $(TAR_FILE)
+
+load:
+ifdef SOURCE
+	@if echo "$(SOURCE)" | grep -qE '^https?://'; then \
+		echo "Downloading and loading image from $(SOURCE)..."; \
+		curl -L "$(SOURCE)" -o $(TAR_FILE); \
+		docker load < $(TAR_FILE); \
+	else \
+		echo "Loading image from file $(SOURCE)..."; \
+		docker load < $(SOURCE); \
+	fi
+else
+	@if [ -f "$(TAR_FILE)" ]; then \
+		echo "Loading image from archive $(TAR_FILE)..."; \
+		docker load < $(TAR_FILE); \
+	else \
+		echo "No archive found; building image..."; \
+        docker build -f docker/Dockerfile --build-arg UID=$(APP_UID) --build-arg GID=$(APP_GID) -t $(IMAGE) .; \
+	fi
+endif
+
+shell:
+	@echo "Entering php-fpm container as www..."
+	docker compose exec --user www php-fpm bash
+
+docs:
+	@echo "Regenerating API documentation..."
+	docker compose exec --user www php-fpm php artisan scribe:generate
+
+db:
+	@echo "Recreate DB..."
+	docker compose exec --user www php-fpm bash -c "php artisan migrate:fresh && php artisan db:seed"

README.md

@@ -1,19 +1,17 @@
 # Laravel Docker Setup
 
-- PHP-FPM, NGINX, MySQL, phpMyAdmin (in `compose.yaml`)
+- NGINX, MySQL, phpMyAdmin
 
-## Run a container
+## Create a project:
 
 ```bash
 cp .env.example .env
 # !change .env for yourself
 docker compose up -d php-fpm
-docker compose exec --user www php-fpm bash
+docker compose exec php-fpm bash
-# or `just shell`
+# or `make shell`
 ```
 
-## Create a project:
-
 **_Rewrite below for yourself:_**
 
 *RECOMENDED:*
@@ -27,7 +25,6 @@ export PATH="$HOME/.composer/vendor/bin:$PATH"
 # Check options via `laravel new -h`
 laravel new example-app
 
-# copy your `.env` content to `example-app/.env`
 mv example-app/* example-app/.* ./
 rmdir example-app
 ```
@@ -39,7 +36,6 @@ rmdir example-app
 ```bash
 composer create-project --prefer-dist laravel/laravel example-app ^11.0
 
-# copy your `.env` content to `example-app/.env`
 mv example-app/* example-app/.* ./
 rmdir example-app
 ```
@@ -47,5 +43,5 @@ rmdir example-app
 ## Quick Actions
 
 ```bash
-just
+make help
 ```

compose.yaml

@@ -26,10 +26,11 @@ services:
     volumes:
       - ./:/var/www
 
+
   mysql:
     image: mysql:8.0
     ports:
-      - "127.0.0.1:${DB_PORT:-3306}:3306"
+      - "${DB_PORT:-3306}:3306"
     environment:
       - MYSQL_DATABASE=${DB_DATABASE}
       - MYSQL_USER=${DB_USERNAME}
@@ -43,11 +44,9 @@ services:
     image: phpmyadmin:latest
     restart: unless-stopped
     ports:
-      - "127.0.0.1:8080:80"
+      - "8080:80"
     environment:
       - PMA_HOST=mysql
-      - PMA_USER=root
-      - PMA_PASSWORD=${DB_ROOT_PASSWORD}
       - PMA_PORT=${DB_PORT:-3306}
       - UPLOAD_LIMIT=100M
     depends_on:

docker/Dockerfile

@@ -1,14 +1,10 @@
-FROM mysql:8.0 AS mysql
-
 FROM php:8.3-fpm
 
-COPY --from=mysql /usr/bin/mysql /usr/bin/mysql
-COPY --from=mysql /usr/bin/mysqldump /usr/bin/mysqldump
-
 RUN apt-get update && apt-get install -y --no-install-recommends \
-    libonig-dev libicu-dev \
+    libpng-dev libonig-dev libxml2-dev libzip-dev \
-    gosu netcat-traditional \
+    zip unzip git gosu \
- && docker-php-ext-install pdo_mysql mbstring intl \
+    netcat-traditional \
+&& docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath gd zip \
 && apt-get clean && rm -rf /var/lib/apt/lists/*
 
 COPY --from=composer:latest /usr/bin/composer /usr/bin/composer
@@ -30,8 +26,6 @@ RUN if getent group ${GID}; then \
 RUN sed -i "s/user = www-data/user = www/g" /usr/local/etc/php-fpm.d/www.conf && \
     sed -i "s/group = www-data/group = $group_name/g" /usr/local/etc/php-fpm.d/www.conf
 
-COPY --chmod=644 ./docker/php.ini /usr/local/etc/php/conf.d/laravel.ini
-
 COPY ./docker/entrypoint.sh /usr/local/bin/
 RUN chmod +x /usr/local/bin/entrypoint.sh
 

docker/entrypoint.sh

@@ -11,7 +11,7 @@ fi
 
 gosu www mkdir -p .hashes
 
-if [ ! -f "vendor/autoload.php" ] || [ ! -f .hashes/.composer-hash ] || ! sha1sum -c .hashes/.composer-hash; then
+if [ ! -f .hashes/.composer-hash ] || ! sha1sum -c .hashes/.composer-hash; then
   echo ">> composer.json or composer.lock changed, installing dependencies..."
   gosu www composer install --optimize-autoloader --no-interaction
   gosu www sha1sum composer.json composer.lock > .hashes/.composer-hash

docker/nginx.conf

@@ -1,6 +1,5 @@
 server {
     listen 80;
-    client_max_body_size 20M;
     index index.php index.html;
     error_log  /var/log/nginx/error.log;
     access_log /var/log/nginx/access.log;

docker/php.ini

@@ -1,2 +0,0 @@
-post_max_size = 20M
-upload_max_filesize = 20M

justfile

@@ -1,44 +0,0 @@
-set dotenv-load
-set shell := ["bash", "-eu", "-o", "pipefail", "-c"]
-
-APP_UID := env("APP_UID", "1000")
-APP_GID := env("APP_GID", "1000")
-
-IMAGE_NAME := "laravel-setup-php-fpm"
-IMAGE_TAG  := "latest"
-IMAGE      := IMAGE_NAME + ":" + IMAGE_TAG
-
-# Show available recipes
-default:
-  @just --list
-
-# Build Docker image
-build:
-  docker build -f docker/Dockerfile \
-    --build-arg UID={{APP_UID}} \
-    --build-arg GID={{APP_GID}} \
-    -t {{IMAGE}} .
-
-# Open shell in PHP-FPM container
-shell:
-  docker compose exec --user www php-fpm bash
-
-# Generate API documentation
-docs *args:
-  docker compose exec --user www php-fpm php artisan scribe:generate {{ args }}
-
-# Regenerate DB and docs
-docs-fresh:
-  just db && just docs --force
-
-# Reset database with fresh migration and seeding
-db:
-  docker compose exec --user www php-fpm php artisan migrate:fresh --seed
-
-# Run tests
-test:
-  docker compose exec --user www php-fpm php artisan test
-
-# Run Pint
-lint:
-  docker compose exec --user www php-fpm php ./vendor/bin/pint