adamculp/php-compatibility-check

php-compatibility-check

Docker镜像用于检查PHP代码与不同PHP版本的兼容性，目标是基于composer.lock文件快速生成已知的PHP安全警报报告，提供易用的容器化解决方案。

核心功能

该镜像包含3个关键工具：

1. wimg/php-compatibility：基于PHP_Codesniffer检测代码对各PHP版本的不兼容问题，报告代码在哪些版本中失效及失效原因。
2. sstalle/php7cc：针对PHP7版本检测代码中的兼容问题。
3. etsy/phan：针对PHP7+版本检测代码中的兼容问题。

注意：本工具并非 exhaustive 参考，但结合三个工具可提供较全面的检查结果。

使用场景

• PHP版本升级前，评估现有代码的兼容性风险；
• 日常代码质量检查，确保代码符合目标PHP版本要求；
• 项目迁移时，快速定位跨版本兼容问题。

配置说明

Windows用户注意

使用$PWD获取当前目录可能不符合预期，需替换为完整路径（如//c/Users/用户名/项目目录）。

PHPCompatibility工具示例

bash
docker run -it --rm -v "$PWD":/app -w /app docker.xuanyuan.run/adamculp/php-compatibility-check:latest \
php vendor/bin/phpcs -sv --extensions=vendor/wimg/php-compatibility --standard='PHPCompatibility' \
--extensions=php --ignore=vendor --report-file=./phpcompatibility_results.txt .

说明：挂载当前目录到容器/app，执行检查并输出结果到phpcompatibility_results.txt。

php7cc工具示例

bash
docker run -it --rm -v "$PWD":/app -w /app docker.xuanyuan.run/adamculp/php-compatibility-check:latest \
php vendor/bin/php7cc --extensions=php \
--except=vendor > ./php7cc_results.txt .

Phan工具示例

bash
docker run -it --rm -v "$PWD":/app -w /app docker.xuanyuan.run/adamculp/php-compatibility-check:latest \
php vendor/bin/phan -l . --exclude-directory-list "vendor/" \
> ./phan_results.txt

默认检查目录包括src、tests/Phan等，如需修改需编辑.phan/config.php文件。

本地构建镜像

如需自定义镜像（如更换PHP版本或工具版本），可本地构建：

1. 克隆仓库：

bash
git clone https://github.com/adamculp/php-compatibility-check.git
cd php-compatibility-check

2. 修改Dockerfile后构建：

bash
docker build -t adamculp/php-compatibility-check .

或直接从GitHub构建：

bash
docker build -t adamculp/php-compatibility-check https://github.com/adamculp/php-compatibility-check.git

提示

若觉得该镜像有用，欢迎在Docker Hub或GitHub上点赞支持！