平时大家在开发php项目的时候,本地都要装php程序和composer,做单元测试的时候还需要phpunit,如果需要单测覆盖率的话还要开启debug,本文将使用一个docker镜像搞定这些。
先说下使用docker的优点
- 团队开发环境统一,新人容易上手
- 便于管理各种php扩展,也可以很方便的与测试生产环境保持一致
1,先准备一个docker镜像
下面是一个php7.3+composer2.1+phpunit9.5的dockerfile,大家也可以根据自己的需要进行修改,然后自己构建为镜像
FROM composer:2.2.6 as composer
FROM registry.cn-shenzhen.aliyuncs.com/nyg_base/phpunit:9.5.9 as phpunit
FROM php:7.3-cli
LABEL maintainer="nyg1991@aliyun.com"
# 更改为阿里云镜像
RUN sed -i s@/archive.ubuntu.com/@/mirrors.aliyun.com/@g /etc/apt/sources.list \
&& sed -i s@/deb.debian.org/@/mirrors.aliyun.com/@g /etc/apt/sources.list \
&& apt-get clean
#安装zip pdo_mysql扩展
RUN apt-get update \
&& apt-get install -y zlib1g-dev \
&& apt-get install -y libzip-dev \
&& docker-php-ext-install -j$(nproc) zip \
&& docker-php-ext-install -j$(nproc) pdo_mysql
#安装debug,单测覆盖率必须
RUN pecl install xdebug-2.8.1 && docker-php-ext-enable xdebug
#安装composer
COPY --from=composer /usr/bin/composer /usr/local/bin/composer
#安装phpunit
COPY --from=phpunit /usr/local/bin/phpunit /usr/local/bin/phpunit
RUN chmod +x /usr/local/bin/composer && chmod +x /usr/local/bin/phpunit
我把构建的镜像打个标签phpstorm:7.3-composer,方便下边使用
也可以拉取我已经构建好的镜像
docker pull registry.cn-shenzhen.aliyuncs.com/nyg/phpstorm:php-73-base
2,配置php解释器
本地要先启动docker desktop
2.1点击配置 》PHP 》CLI解释器
2.2 点击+ 》Form docker 》 docker 》选择第一步构建的镜像
2.3 添加成功后如下图,我们可以看到php版本号和xdebug的版本,然后点击应用,确定
2.4 这时已经配置成功了,phpstorm会自动生成路径映射,把项目根目录映射到容器中/opt/project
2.5 返回到编辑器,创建一个test.php文件,Crtl+Shift+F10 选择刚才配置的解释器,然后运行,我们可以看到运行成功,php解释器的配置就算完成了
3,配置composer
3.1 这步配置比较简单,看图就可以了
3.2 安装一个包测试一下
新建一个composer.json文件,点击 【工具】 》【composer】》【管理依赖项】》在composer.json文件里随便写一个包名,然后点击安装,如果执行成功,这步就完成了。如果失败,可以查看事件日志是否缺少某些php扩展,然后在dockerfile里安装扩展,重新构建镜像,再次点击composer安装,重新构建镜像不用再重新配置phpstorm。
3.3 配置composer命令行工具
使用phpstorm的composer工具只有几个常用命令,我们如果想要执行一些特殊的composer命令,比如composer -V,就需要再配置一个命令行工具
添加命令行工具,选择composer
确定,返回到编辑器,测试下是否配置成功
Ctrl+Shift+X 运行命令,输入
c -V
看到输出composer版本号,也就配置成功一半了。
我们执行下
c install
这时就发现执行失败,composer找不到
composer.json
,因为composer当前的工作路径是/usr/local/bin
,并不是项目所在的目录。然而phpstorm对这部分并不友好,找不到地方设置,只能用一个取巧的方法,配置--working-dir
指定composer的工作路径。回到上一步的设置,点击【在编辑器中定义】
然后在编辑器中,找到命令执行这里,增加
--working-dir=\opt\project
,然后直接关闭这里我们再次执行
c install
,就可以执行成功了composer的配置就到此了
配置测试框架(phpunit,覆盖率)
配置就直接看图吧
写个单元测试一下,首先准备一个要测试的文件如下
单元测试文件
然后点击 【使用覆盖率运行】,开始测试
运行的结果如下,可以看到测试结果,以及覆盖率,打开原文件能看到覆盖了哪几行代码,绿色的是覆盖过的,红色为未覆盖。
到此为止就配置完了,需要说明一点,这个镜像只是phpstorm执行一些命令行用的,是cli模式,不是项目运行镜像。项目运行镜像,可以和测试环境、生产环境用同一个镜像,基于php-fpm的镜像构建。