目标:基于主流的 PHP 框架,用 Docker 镜像的方式搭建一个 Laravel + Mysql 的应用 。本项目代码维护在 Github:DaoCloud/php-laravel-mysql-sample 项目中。
国外的一片关于介绍 Docker 与 Laravel 结合的文章 http://dylanlindgren.com/docker-for-the-laravel-framework/
首先,选择官方的 PHP 镜像作为项目的基础镜像。
FROM daocloud.io/php:5.6-apache
其次,通过安装脚本安装 Laravel 应用所需要的 PHP 依赖
# APT 自动安装PHP相关的依赖包,如需其他依赖包在此添加
RUN apt-get update -q && \
apt-get install -y \
libmcrypt-dev \
libz-dev \
wget && \
# Docker Hub 官方 PHP 镜像内置命令,安装 PHP 依赖
docker-php-ext-install \
mcrypt \
mbstring \
pdo_mysql \
zip && \
# 用完包管理器后安排打扫卫生可以显著的减少镜像大小.
apt-get clean && \
apt-get autoclean && \
rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* && \
# 安装Composer,此物是PHP用来管理依赖关系的工具.
curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
# 配置 composer 执行.
ENV PATH=$PATH:~/.composer/vendor/bin
- 依赖包安装通过
docker-php-ext-install安装,如果依赖包需要配置参数则通过docker-php-ext-configure命令。具体用法请参考:PHP 镜像说明。 - Docker 是分层结构,镜像的大小所有的层次的大小总和。尽量精简我们每次构建镜像的大小。
- Composer 为 Laravel 下载第三方 Vendor 包所必需的插件,Composer 同时也是 PHP 最流行的包管理工具。
接着,创建 Laravel 目录结构
# 开启 Url 重写模块
# 配置默认放置 App 的目录
RUN a2enmod rewrite && \
mkdir -p /app && \
rm -fr /var/www/html && \
ln -s /app/public /var/www/html
WORKDIR /app
- Laravel 是通过统一的项目的入口文件进入应用系统的。进而需要 apache 开启链接重写模块。
- apache 默认的文档目录为
/var/www/html,将/app定义为 Laravel 应用目录,而 Laravel 的项目入口文件位于/app/public。为了方便管理,把/var/www/html软链接到/app/public。
紧接着,根据 DaoCloud Dockerfile 最佳实践,我们需要把第三方依赖预先加载好。
# 预先加载 Composer 包依赖,优化 Docker 构建镜像的速度
COPY ./composer.json /app/
COPY ./composer.lock /app/
RUN composer install --no-autoloader --no-scripts
- 复制
composer.json和composer.lock到/app,composer.lock会锁定 composer 加载的依赖包版本号,防止由于第三方依赖包的版本不同导致的应用运行错误。 --no-autoloader为了阻止composer install之后进行的自动加载,防止由于代码不全导致的自动加载报错。--no-scripts为了阻止composer install运行时composer.json所定义的脚本,同样是防止代码不全导致的加载错误问题。
然后,将 Laravel 应用程序复制到 /app
# 复制代码到 App 目录
COPY . /app
# 执行 Composer 自动加载和相关脚本
# 修改目录权限
RUN composer install && \
chown -R www-data:www-data /app && \
chmod -R 0777 /app/storage
composer install执行之前阻止的操作,完成自动加载及脚本运行- 修改
/app与/app/storage的权限,保证 Laravel 在运行中有足够的权限 - 因为基础镜像内已经声明了暴露端口和启动命令,此处可以省略。
至此,包含 Laravel 应用的 Docker 容器已经准备好了。Laravel 代码中访问数据库所需的参数,是通过读取环境变量的方式声明的。
config/database.php 修改变量为更贴近 Docker 的方式
'host' => env('MYSQL_PORT_3306_TCP_ADDR', 'localhost'),
'database' => env('MYSQL_INSTANCE_NAME', 'forge'),
'username' => env('MYSQL_USERNAME', 'forge'),
'password' => env('MYSQL_PASSWORD', ''),
- 这样做是因为在 Docker 化应用开发的最佳实践中,通常将有状态的数据类服务放在另一个容器内运行,并通过容器特有的绑定机制将应用容器与数据容器动态的连接在一起。
首先,需要创建一个 MySQL 容器。
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d mysql:tag
之后,通过 Docker 容器间的link机制,便可将 MySQL 的默认端口 (3306) 暴露给应用容器。
docker run --name some-app --link some-mysql:mysql -d app-that-uses-mysql
MySQL 容器的具体用法请参考:MySQL 镜像说明。
比起本地创建,在云端创建和绑定 MySQL 数据服务会更简单。
「截图」