Laravel应用专用Docker镜像文档

镜像概述与主要用途

本镜像为Laravel应用开发与部署设计，集成PHP、Apache Web服务器及Laravel应用运行所需的各类依赖包，可直接用于搭建Laravel应用的运行环境，无需手动配置基础依赖。

核心功能与特性

预装APT依赖包

• libmcrypt-dev：加密相关开发库
• zip/unzip：文件压缩/解压工具
• curl：网络请求工具
• git：版本控制工具
• supervisor：进程管理工具
• libpq5/libpq-dev：PostgreSQL客户端库及开发文件
• libxml2-dev：XML解析开发库
• php5-mysql：MySQL数据库PHP客户端
• php-soap：SOAP协议支持库

预装PHP扩展

• mcrypt：加密算法扩展
• mbstring：多字节字符串处理扩展
• tokenizer：PHP代码标记解析扩展
• pdo_pgsql：PostgreSQL数据库PDO驱动
• pdo_mysql：MySQL数据库PDO驱动
• soap：SOAP协议支持扩展

集成开发工具

• composer：PHP依赖管理工具，用于安装Laravel及PHP包依赖
• npm：Node.js包管理工具，用于管理前端资源依赖

Apache配置

• 默认网站根目录（DocumentRoot）已配置为/var/www/app/public，适配Laravel应用的public目录作为Web入口

使用场景与适用范围

• Laravel应用的本地开发环境快速搭建
• Laravel应用的测试环境部署
• 小型Laravel应用的生产环境基础镜像

使用方法与配置说明

基本使用步骤

1. 将本地Laravel应用代码目录挂载至容器内/var/www/app目录
2. 启动容器并映射Apache服务端口（默认80端口）

Docker Run部署示例

bash
docker run -d \
  -v /path/to/your/laravel/app:/var/www/app \
  -p 8080:80 \
  --name laravel-container \
  [镜像名称]

说明：

• -v /path/to/your/laravel/app:/var/www/app：将本地Laravel应用目录挂载至容器内应用根目录
• -p 8080:80：将容器内Apache的80端口映射至主机的8080端口（可根据需要调整主机端口）
• --name laravel-container：指定容器名称为laravel-container

目录结构说明

• 应用根目录：容器内/var/www/app，需挂载本地Laravel应用代码至此目录
• Web访问入口：Apache的DocumentRoot指向/var/www/app/public，对应Laravel应用的public目录（包含入口文件index.php）

扩展配置建议

如需自定义Apache配置或PHP.ini参数，可通过挂载配置文件至容器对应目录实现，例如：

• Apache配置：挂载自定义.conf文件至/etc/apache2/sites-available/
• PHP配置：挂载自定义php.ini文件至/etc/php5/apache2/php.ini（根据PHP版本调整路径）