目标:基于主流的 PHP 框架,用 Docker 镜像的方式搭建一个 Laravel + MySQL 的应用。
本项目代码维护在 DaoCloud/php-laravel-mysql-sample 项目中。
因所有官方镜像均位于境外服务器,为了确保所有示例能正常运行,DaoCloud 提供了一套境内镜像源,并与官方源保持同步。
FROM daocloud.io/php:5.6-apache
# 安装 PHP 相关的依赖包,如需其他依赖包在此添加
RUN apt-get update \
&& apt-get install -y \
libmcrypt-dev \
libz-dev \
git \
wget \
# 官方 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
docker-php-ext-install
安装,如果依赖包需要配置参数则通过 docker-php-ext-configure
命令。# 开启 URL 重写模块
# 配置默认放置 App 的目录
RUN a2enmod rewrite \
&& mkdir -p /app \
&& rm -fr /var/www/html \
&& ln -s /app/public /var/www/html
WORKDIR /app
/var/www/html
,将 /app
定义为 Laravel 应用目录,而 Laravel 的项目入口文件位于 /app/public
。为了方便管理,把 /var/www/html
软链接到 /app/public
。# 预先加载 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
所定义的脚本,同样是防止代码不全导致的加载错误问题。/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 化应用开发的最佳实践中,通常将有状态的数据类服务放在另一个容器内运行,并通过容器特有的 link
机制将应用容器与数据容器动态的连接在一起。
docker run --name some-mysql -e MYSQL_ROOT_PASSWORD=my-secret-pw -d daocloud.io/mysql:5.5
link
机制,便可将 MySQL 的默认端口 (3306) 暴露给应用容器。docker run --name some-app --link some-mysql:mysql -d app-that-uses-mysql
比起本地创建,在云端创建和绑定 MySQL 数据服务会更简单。
DaoCloud 使用图文介绍