PHP Coding Standards Fixer(PHP CS Fixer) 도구는 표준을 따르도록 코드를 수정합니다. PSR-1, PSR-2 등에 정의된 PHP 코딩 표준을 따르거나 Symfony와 같은 다른 커뮤니티 기반 표준을 따르기를 원하는지 여부. 구성을 통해 (팀의) 스타일을 정의할 수도 있습니다 .
코드를 현대화하고(예: PHP 5.6에서 pow
함수를 **
연산자로 변환) (마이크로) 최적화할 수 있습니다.
코드의 코딩 표준 문제를 식별하기 위해 이미 린터를 사용하고 있다면, 특히 대규모 프로젝트에서 문제를 직접 수정하는 것이 지루하다는 것을 알고 있을 것입니다. 이 도구는 이러한 문제를 감지할 뿐만 아니라 해결해 줍니다.
참고 각각의 새로운 PHP 버전은 새로운 구문을 지원하기 위해 엄청난 노력을 필요로 합니다. 그렇기 때문에 최신 PHP 버전이 아직 지원되지 않을 수 있습니다. 필요하다면 코드 기여나 기존 PR 검토 등 편리한 방법으로 프로젝트를 지원하는 것을 고려해 보세요. 아직 지원되지 않는 버전에서 PHP CS Fixer를 실행하려면 "자신의 책임하에" PHP_CS_FIXER_IGNORE_ENV를 활용하세요.
PHP CS Fixer를 설치하는 권장 방법은 프로젝트의 전용 composer.json
파일(예: tools/php-cs-fixer
디렉터리)에서 Composer를 사용하는 것입니다.
mkdir -p tools/php-cs-fixer
composer require --working-dir=tools/php-cs-fixer friendsofphp/php-cs-fixer
또는 기본 composer.json
사용합니다.
composer require --dev friendsofphp/php-cs-fixer
자세한 내용 및 기타 설치 방법은 설치 지침을 참조하세요.
사전 빌드된 Docker 이미지를 사용하여 php-cs-fixer
실행할 수 있습니다.
docker run -it --rm -v $(pwd):/code ghcr.io/php-cs-fixer/php-cs-fixer:${FIXER_VERSION:-3-php8.3} fix src
위의 예에 사용된 $FIXER_VERSION
사용하려는 릴리스의 식별자로, Fixer와 PHP 버전이 결합된 것을 기반으로 합니다. <php-cs-fixer-version>-php<php-version>
구문을 사용하여 각 Fixer의 SemVer 레벨 및 PHP 버전에 대해 서로 다른 태그가 있습니다. 예를 들어:
3.57.0-php7.4
3.57-php8.0
3-php8.3
위의 지침에 따라 PHP CS Fixer를 설치했다고 가정하면 다음 명령을 실행하여 src
디렉터리의 PHP 파일을 수정할 수 있습니다.
tools/php-cs-fixer/vendor/bin/php-cs-fixer fix src
자세한 내용은 사용법, 기본 제공 규칙 목록, 규칙 세트 목록 및 구성 파일 설명서를 참조하세요.
도구에서 지원하지 않는 코드 스타일을 적용해야 하는 경우 사용자 정의 규칙을 생성할 수 있습니다.
다음을 위한 전용 플러그인이 있습니다.
PHP CS Fixer는 GitHub(https://github.com/PHP-CS-Fixer/PHP-CS-Fixer)에서 유지 관리됩니다. 새로운 기능에 대한 버그 보고서와 아이디어를 환영합니다.
프로젝트, 구성, 가능한 개선 사항, 아이디어 및 질문에 관한 GitHub 토론에서 우리에게 연락할 수 있습니다. 꼭 방문해 주세요!
이 도구에는 몇 가지 내장 수정 프로그램이 포함되어 있지만 더 많은 수정 프로그램을 제공하는 것은 누구나 환영합니다.