如何在composer.json中定义项目的代码规范(如PSR-12)?

冰火之心
发布: 2025-11-16 17:37:02
原创
315人浏览过
答案:通过 Composer 配置开发依赖和脚本集成 PHP CS Fixer 或 PHP_CodeSniffer,可在项目中实现 PSR-12 代码规范检查与修复,提升代码一致性。

如何在composer.json中定义项目的代码规范(如psr-12)?

要在 composer.json 中定义项目的代码规范(如 PSR-12),Composer 本身不直接执行代码规范检查,但你可以通过配置脚本或开发依赖来集成代码规范工具。常用方式是结合 PHP_CodeSnifferPHP CS Fixer 来实现。

1. 安装代码规范检查工具

推荐使用 PHP CS FixerPHP_CodeSniffer。以 PHP CS Fixer 为例:

composer require --dev friendsofphp/php-cs-fixer

如果你更喜欢 PHP_CodeSniffer:

composer require --dev squizlabs/php_codesniffer

2. 配置代码规范规则

在项目根目录创建配置文件,例如使用 PHP CS Fixer 时,创建 .php-cs-fixer.php

// .php-cs-fixer.php
$finder = PhpCsFixer\Finder::create()
    ->in(__DIR__ . '/src')
    ->in(__DIR__ . '/tests');

return PhpCsFixer\Config::create()
    ->setRules(['@PSR12' => true])
    ->setFinder($finder);

如果使用 PHP_CodeSniffer,可在 phpcs.xml 中定义:

<?xml version="1.0"?>
<ruleset>
  <rule ref="PSR12"/>
  <file>src/</file>
  <file>tests/</file>
</ruleset>

3. 在 composer.json 中添加脚本命令

将代码规范检查和修复命令加入 scripts 字段,方便团队统一调用:

如知AI笔记
如知AI笔记

如知笔记——支持markdown的在线笔记,支持ai智能写作、AI搜索,支持DeepseekR1满血大模型

如知AI笔记 27
查看详情 如知AI笔记
"scripts": {
  "cs:check": "php-cs-fixer fix --dry-run --verbose",
  "cs:fix": "php-cs-fixer fix",
  "lint": "phpcs"
}

这样开发者可以通过以下命令检查代码:

composer run cs:check

自动修复不符合规范的代码:

composer run cs:fix

4. (可选)在 CI/CD 中运行检查

将这些脚本加入持续集成流程,确保提交的代码符合 PSR-12 规范。例如在 GitHub Actions 中添加步骤:

- name: Check code style
  run: composer run cs:check

基本上就这些。Composer 不直接管理代码规范,但通过 dev 依赖和脚本,可以很好地集成 PSR-12 等标准,提升项目代码一致性。

以上就是如何在composer.json中定义项目的代码规范(如PSR-12)?的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号