akimsir/php-fixer

akimsir/php-fixer镜像说明

镜像概述

本Docker镜像整合了php-cs-fixer和phpcbf两个常用的PHP代码风格修复工具，旨在帮助开发者高效统一代码格式，减少人工调整成本。

核心功能

1. php-cs-fixer：根据指定配置文件（.php_cs）修复PHP代码的语法风格与编码规范
2. phpcbf：应用自定义规则集（cs-ruleset.xml）自动修正代码格式问题

使用场景

• 本地开发环境中快速修复单个或多个PHP文件的风格问题
• 集成到项目构建流程（如Makefile）中，实现代码风格检查与修复的自动化
• 团队协作时统一代码规范，提升代码可读性

配置说明

1. 项目根目录需存在.php_cs文件（用于php-cs-fixer的配置）
2. 项目需包含data/cs-ruleset.xml规则文件（用于phpcbf的标准定义）

部署示例

Makefile集成

在项目Makefile中添加以下命令，可通过快捷键触发执行：

makefile
php-fixer:
	docker pull akimsir/php-fixer:latest
	docker run --rm -i \
	--user ${shell id -u}:$(shell id -g) \
	--volume $(CURDIR):/project \
	akimsir/php-fixer:latest "php-cs-fixer --verbose fix ${FILE_TO_FIX} --config=.php_cs \
	&& phpcbf --standard=data/cs-ruleset.xml -s ${FILE_TO_FIX}"

直接执行（修复单个文件）

bash
docker run --rm -i \
--user $(id -u):$(id -g) \
--volume $(pwd):/project \
akimsir/php-fixer:latest "php-cs-fixer --verbose fix path/to/your/file.php --config=.php_cs && phpcbf --standard=data/cs-ruleset.xml -s path/to/your/file.php"