Laravel DevContainer Starter (VSCode + Docker + xDebug)

A ready-to-use Laravel development environment using DevContainers, Docker, and VS Code. Includes Xdebug, Composer, Node, and MySQL.

📦 Features

• Laravel application running inside Docker containers
• Preconfigured PHP container with Xdebug support
• MySQL / MariaDB database container
• Apache as web server
• Easy host & network configuration

🧰 Prerequisites

Before you get started, you’ll need:

• Docker (Engine) installed
• Docker Compose installed
• Git
• VSCode + Dev Containers extension

🏗️ Setup & Installation

If you with, you can start a Laravel application in the way you think is better and just copy containers files to your repository, but if you want to use the Laravel application in this repository, here is the step-by-step:

1. Clone the repository

   git clone https://github.com/devdiogenes/laravel-docker-xdebug.git
   cd laravel-docker-xdebug

2. Copy .env.example to .env and adjust configuration if needed

   cp .env.example .env
   ```.
   

3. Open the folder in VSCode

   code .

4. Press Ctrl + Shift + P and open it as a dev container

5. Get your MariaDB container name

   docker ps

6. Set your MariaDB container name as DB_HOST in .env

7. Open terminal in VSCode (inside remote container)

8. Install PHP dependencies

   composer install

9. Generate Laravel application key

   docker-compose exec app php artisan key:generate

10. Run migrations

    php artisan migrate

11. Access your application in the browser
    The default URL is typically http://127.0.0.1

🤝 Contributing

Contributions, issues, and feature requests are welcome.

1. Fork the repo
2. Create a feature branch (git checkout -b feature/my-feature)
3. Commit your changes (git commit -m "Add some feature")
4. Push to the branch (git push origin feature/my-feature)
5. Open a Pull Request

📜 License

This project is open-sourced software licensed under the MIT License.