laradock  by laradock

A comprehensive Docker-based PHP development environment

Created 11 years ago
12,653 stars

Top 4.1% on SourcePulse

GitHubView on GitHub
Project Summary

<2-3 sentences summarising what the project addresses and solves, the target audience, and the benefit.> Laradock provides a comprehensive, pre-configured PHP development environment using Docker, designed for developers who want to quickly set up a local stack without manual configuration. It offers a consistent environment across Linux, macOS, and Windows, significantly reducing initial setup time and eliminating host system conflicts.

How It Works

Laradock employs Docker and Docker Compose to manage a comprehensive suite of over 100 pre-configured services, encompassing web servers, databases, caching layers, message brokers, and search engines. A key architectural choice is the workspace container, which serves as an isolated, all-in-one development shell. This container comes pre-loaded with essential tools such as PHP (multiple versions), Composer, Node.js, Git, and xDebug, eliminating the need to install these directly on the host machine. This containerized, service-per-container approach ensures robust isolation, preventing conflicts between different projects or dependencies and guaranteeing a consistent development environment across Linux, macOS, and Windows.

Quick Start & Requirements

Setup involves cloning the repository, copying and configuring the .env file, and launching services via docker compose up -d. Requires Docker and Docker Compose (v2.20+). Compatible with Linux, macOS, and Windows.

Highlighted Details

  • Version Flexibility: Supports any PHP version from 5.6 to 8.5, easily configurable via the .env file and subsequent rebuilds.
  • Extensive Service Catalog: Offers over 100 ready-made services, including a wide range of databases (MySQL, PostgreSQL, MongoDB, Neo4j), caches (Redis, Memcached), message queues (RabbitMQ, Kafka), search engines (Elasticsearch, Solr), and cutting-edge local AI/LLM tools (Ollama, LiteLLM, pgvector, Qdrant).
  • Host System Isolation: The workspace container provides a clean, pre-configured CLI environment with PHP, Composer, Node, Git, and xDebug, ensuring no development tools or dependencies are installed on the host machine, and leaving zero traces upon project teardown.
  • Framework Agnostic: Designed to be highly adaptable, working seamlessly with virtually any PHP framework (Laravel, Symfony), CMS (WordPress, Drupal), or e-commerce platform (Magento, WooCommerce).

Maintenance & Community

An MIT-licensed open-source project with a dedicated team of maintainers and numerous contributors. Financial support is acknowledged through sponsors.

Licensing & Compatibility

Laradock is released under the MIT License, which permits commercial use and modification, offering broad compatibility for integration into various projects.

Limitations & Caveats

Requires Docker and Docker Compose to be installed and functional on the host system. No other significant limitations are detailed in the provided documentation.

Health Check
Last Commit

22 hours ago

Responsiveness

Inactive

Pull Requests (30d)
39
Issues (30d)
0
Star History
10 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.