Skip to content

All-in-one Docker-based PHP development suite for Laravel, WordPress, Magento, and more.

License

Notifications You must be signed in to change notification settings

focela/php-devsuite

Repository files navigation

PHP DevSuite

PHP DevSuite is an all-in-one Docker-based development suite for Laravel, WordPress, Magento, and more.
It provides a robust, scalable, and easy-to-use local development environment with pre-configured services.

Supported PHP Versions Supported Nginx Versions PHP Docker Pulls Nginx Docker Pulls Maintained - Yes MIT License

πŸ“Œ Table of Contents

πŸš€ Quick Start

Clone the repository

git clone git@github.com:focela/php-devsuite.git
cd php-devsuite

Start the environment

./compose/bin/start

Access your application

πŸ›  Features

  • Pre-configured PHP & Nginx setup
  • Supports Laravel, WordPress, Magento, and more
  • Elasticsearch, OpenSearch, RabbitMQ support
  • Customizable environment with Docker Compose
  • Easy start, stop, and restart scripts
  • Works seamlessly on Linux, macOS, and Windows (WSL2)

πŸ“¦ Services

Service Versions Available
PHP 8.1, 8.2, 8.3, 8.4
Nginx 1.18, 1.22, 1.24
Elasticsearch 7.16, 7.17, 8.4, 8.5, 8.7, 8.11, 8.13
OpenSearch 1.2, 2.5, 2.12
RabbitMQ 3.8, 3.9, 3.11, 3.12, 3.13

πŸ”§ Setup

Install dependencies

Ensure you have Docker installed. If not, install it from Docker Official Site.

Run the project

./compose/bin/start

Stop the environment

./compose/bin/stop

πŸ“‚ Directory Structure

.
β”œβ”€β”€ CODE_OF_CONDUCT.md   # Community guidelines
β”œβ”€β”€ CONTRIBUTING.md      # Contribution guidelines
β”œβ”€β”€ LICENSE              # MIT License
β”œβ”€β”€ compose/             # Docker Compose configuration & scripts
β”‚   β”œβ”€β”€ bin/             # Utility scripts
β”‚   β”‚   β”œβ”€β”€ bash
β”‚   β”‚   β”œβ”€β”€ cli
β”‚   β”‚   β”œβ”€β”€ restart
β”‚   β”‚   β”œβ”€β”€ setup-ssl
β”‚   β”‚   β”œβ”€β”€ start
β”‚   β”‚   └── stop
β”‚   β”œβ”€β”€ compose.yaml     # Main Docker Compose configuration
β”‚   β”œβ”€β”€ docker/
β”‚   β”‚   └── nginx/       # Nginx configurations
β”‚   β”‚       β”œβ”€β”€ nginx.conf
β”‚   β”‚       └── sites-enabled/
β”‚   β”‚           └── default.conf
β”‚   └── src/             # Sample PHP application
β”‚       └── index.php
└── images/              # Custom Docker images
    β”œβ”€β”€ php/             # PHP images
    β”œβ”€β”€ nginx/           # Nginx images
    β”œβ”€β”€ elasticsearch/   # Elasticsearch versions
    β”œβ”€β”€ opensearch/      # OpenSearch versions
    β”œβ”€β”€ rabbitmq/        # RabbitMQ versions

βš™ Management

Restart all containers:

./compose/bin/restart

Stop the environment:

./compose/bin/stop

View logs:

docker-compose logs -f

🀝 Contributing

We welcome contributions! Please check:

πŸ“„ License

PHP DevSuite is licensed under the MIT License. See the LICENSE file for more details.

πŸ’¬ Support

If you encounter any issues, please open an issue in the repository:
GitHub Issues