laradock  by laradock

A comprehensive Docker-based PHP development environment

Created 11 years ago
12,654 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

1 month ago

Responsiveness

Inactive

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

Explore Similar Projects

Feedback? Help us improve.