Laradose

Overview:

Laradose is a Docker compose configuration designed to simplify the process of running a Laravel application locally. With its provided Bash script, installation and configuration become effortless. The configuration settings are saved in Laravel's .env file. Laradose includes six pre-installed containers such as PHP with configurable versions and xdebug support, Nginx with HTTPS support, MySQL with automatic database import, Artisan to run Laravel Artisan commands, Composer to install PHP packages, and NPM with Hot Module Reload and Browsersync support. Additional containers can be enabled, including Queues, Redis (in-memory database for cache storage), Laravel Horizon (Redis-powered queue manager), MailHog (local email server), PHPMyAdmin (database management), and Scheduler (Laravel Scheduler).

Features:

• Lightweight and powerful Docker compose configuration
• Easy installation and configuration with the provided Bash script
• Customizable settings saved in Laravel's .env file
• Pre-installed containers: PHP, Nginx, MySQL, Artisan, Composer, NPM
• Additional containers for queues, cache storage, queue management, email server, database management, and scheduler

Automated installation:

1. Download the repository's files.
2. Copy the downloaded files to your project's folder.
3. Generate SSL certificates for HTTPS.
4. Modify the following files to match your local environment: .env, .env.example, package.json, webpack.mix.js.
5. Apply correct permissions.
6. Run the configuration tool to enable/disable containers and specify ports.
7. Commit your files before running the script for easy rollback if needed.

Manual installation:

1. Copy the "docker" folder and the "docker-compose.yml" file to your project folder.
2. Append the content of .env to your .env file.
3. Set DB_HOST=mysql and REDIS_HOST=redis in your .env file.
4. Generate SSL certificates.
5. Append the content of webpack.mix.js to your webpack.mix.js file.
6. Add the "--https" argument to the "hot" section of your package.json file.
7. Set write permissions on the host.
8. Manually configure environment variables as described in the "Available Parameters" section.

Installation on Windows:

1. Install Docker and Docker Compose.
2. Install unzip and wget or curl.
3. Follow the automated or manual installation instructions mentioned above.

Summary:

Laradose is a Docker compose configuration that simplifies the process of running a Laravel application locally. With its provided Bash script and easy installation instructions, users can quickly set up and configure the necessary containers for their Laravel project. Laradose also allows for customization and enables additional containers for more advanced functionalities. Overall, Laradose aims to streamline the local development environment for Laravel developers.