This repository provides a Docker-based skeleton for PHP web projects, simplifying setup with built-in HTTPS, custom domains, and database support. It's designed for developers seeking a robust and easily configurable environment for their PHP applications.

How It Works

The project leverages Docker and Docker Compose to create a reproducible development environment. It uses Castor, a PHP-based task runner, to manage project configuration and execution. Key features include automatic domain mapping, HTTPS setup via Traefik, and support for various services like databases, message queues, and caching systems, all managed through docker-compose.yml configurations.

Quick Start & Requirements

• Install Castor: composer global require castor/castor
• Configure castor.php with project name, domain, and PHP version.
• Run castor init to set up the project structure.
• Official documentation: README.dist.md

Highlighted Details

• Integrates with Symfony, Webpack Encore, AssetMapper, and Sylius.
• Supports adding Elasticsearch, Kibana, RabbitMQ, Redis, Mailpit, Mercure, and redirection.io.
• Includes configurations for cron jobs, workers, and Blackfire.io profiling.
• Provides recipes for PostgreSQL, MySQL, and FrankenPHP.

Maintenance & Community

• Created by JoliCode.
• Logo by Caneco.

Licensing & Compatibility

• MIT License.
• Compatible with Docker for Windows.

Limitations & Caveats

• The castor init command should only be run once.
• PowerShell users may need to run environment variables manually.