ender25/laravel-php-7.2-fpm

Laravel Docker 开发环境

概述

本项目提供了一个专为 Laravel 框架设计的 Docker 容器化开发环境。它集成了 PHP-FPM、Nginx、MySQL 和 Redis 等核心服务，旨在为开发者提供开箱即用的本地开发体验。

⚠️ 注意：本仓库及相关镜像仅限用于开发目的，请勿直接用于生产环境。

核心功能与特性

• 多版本兼容：完美支持 Laravel 5.6、5.7 和 5.8 版本。
• 服务集成：内置 PHP-FPM 应用服务、Nginx Web 服务器、MySQL 数据库及 Redis 缓存服务。
• 便捷配置：提供标准化的 .env 和 Nginx 配置模板，快速完成环境初始化。
• CLI 支持：通过 Docker Compose 轻松执行 Composer 和 Laravel Artisan 命令行工具。

使用场景和适用范围

• Laravel 5.x 项目的本地开发与调试。
• 快速搭建标准化的团队开发环境，保证开发环境的一致性。
• 学习和测试 Laravel 框架及其相关生态组件。

详细使用方法和配置说明

1. 安装与克隆

将本仓库克隆到您的 Laravel 项目根目录中：

bash
git clone https://github.com/acollazo25/laravel-docker.git

2. 配置 Laravel 环境变量

修改 Laravel 项目根目录下的 .env 文件，确保数据库和 Redis 的连接信息指向 Docker 容器服务名称（如 db 和 redis）。

.env 配置示例：

dotenv
# 数据库配置
DB_CONNECTION=mysql
DB_HOST=db
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret

# Redis 配置
REDIS_HOST=redis
REDIS_PASSWORD=null
REDIS_PORT=6379

3. 配置 Nginx 服务器

在 laravel-docker 目录中，复制 Nginx 配置示例文件以启用站点配置：

bash
cp nginx/app.conf.example nginx/app.conf

注：您可以根据实际项目需求修改 nginx/app.conf 中的路由和目录配置。

4. 启动容器服务

进入 laravel-docker 目录并启动所有后台服务：

bash
cd laravel-docker
docker-compose up -d

启动完成后，在浏览器中访问 🌐 http://localhost 即可查看项目。

Laravel Artisan CLI 操作指南

在使用 Artisan 或 Composer 命令时，请确保当前位于 laravel-docker 目录下，并通过 docker-compose run 在 app 容器中执行。

安装 PHP 依赖

bash
docker-compose run --rm app composer install

生成应用密钥

bash
docker-compose run --rm app php artisan key:generate

创建存储软链接

bash
docker-compose run --rm app php artisan storage:link

执行数据库迁移与数据填充

bash
docker-compose run --rm app php artisan migrate --seed

启动 Tinker 交互式环境

bash
docker-compose run --rm app php artisan tinker