README

This is a Docker-based template for Yii 2, built with:

• PHP 8.4 (FPM on Alpine)
• PostgreSQL 16
• Redis
• Node.js 22 + NPM
• Supervisor for Queue & Scheduler
• Makefile for easy commands (like Laravel Sail)
• Nginx
• Composer
• XDebug in Dev Mode

🛠 Setup Instructions

1️⃣ Clone the Repository

composer create-project m1n64/yii2-docker-app-basic yii2-app
cd yii2-app

2️⃣ Copy .env and Update Configuration

cp .env.example .env

• Open .env file and change it:

DB_DATABASE=<your-db> # Change DB name

• Change the container name prefix:

  Inside docker-compose.yml, rename y2- to your project name:

services:
    app:
        container_name: myproject-app
    nginx:
        container_name: myproject-nginx
    postgres:
        container_name: myproject-postgres
    redis:
        container_name: myproject-redis

• Change the Docker network

  In docker-compose.yml:

networks:
   myproject-network:

🚀 Start Containers

🔹 Using Docker

docker-compose up -d

🔹 Using Makefile

make up    # For development
make prod  # For production

📦 Install Dependencies

🛠 Install PHP Dependencies

Run inside the container:

docker-compose exec -u www-data app composer install

Or using Makefile:

make composer install

🎸 Install Node.js & NPM Dependencies

make npm install
make npm run dev   # Run Vite for development

📜 Run Migrations

make yii migrate

💻 Available Commands

🛠 Running Laravel Commands

🛑 Managing Containers

🔄 Restart & Stop

For list of all makefile commands, run make help.

💡 PHPStorm Setup

PHP Interpreter

or

XDebug

🧪 Run Tests

make test

📜 Additional Notes

• This setup supports Queues & Scheduler via Supervisor.
• PostgreSQL, Redis & Supervisor are configured out of the box.
• Uses Node.js 22 for Vite & frontend dependencies if you need.
• All Docker volumes persist data between container restarts.

🔥 Now your Yii 2 project is fully containerized!

Use Makefile commands just enjoy seamless Docker development! 🚀

🤖 Authors

• m1n64