PHP PSR-12: 현대적인 PHP 코드 스타일 가이드 완벽 분석

핵심 기술

PSR-12는 PHP 개발 커뮤니티에서 코드의 일관성과 가독성을 높여 개발 효율성을 증대시키기 위한 최신 코딩 표준입니다. 이는 이전 표준인 PSR-2를 대체하며 더욱 현대적인 PHP 개발 환경에 맞춰 개선된 가이드라인을 제공합니다.

기술적 세부사항

• PSR-12 준수: PSR-1의 모든 명시적 규칙을 준수해야 합니다.
• 명명 규칙: 'StudlyCaps'는 'PascalCase'로 해석됩니다.
• 파일 끝: 모든 PHP 파일은 정확히 하나의 빈 줄(
  , LF)로 끝나야 하며, 이전에 비어 있지 않은 코드 또는 주석 줄이 있어야 합니다.
• 닫는 PHP 태그: PHP 코드만 포함된 파일에서는 ?> 태그를 생략해야 합니다.
• 줄 길이: 엄격한 줄 길이 제한은 없지만, 120자 정도가 허용 가능한 범위이며, 80자를 넘지 않도록 권장하고 긴 줄은 분리해야 합니다.
• 공백: 줄 끝에 공백이 없어야 하며, 가독성을 위해 빈 줄을 적절히 사용할 수 있습니다.
• 구문: 한 줄에 하나의 문장만 포함해야 합니다.
• 들여쓰기: 4개의 공백을 사용하며 탭은 사용하지 않습니다.
• 키워드: 모든 예약어와 타입 선언은 소문자여야 합니다 ('bool' 대신 'boolean' 사용).
• 헤더 순서: PHP 태그, 파일 Docblock, 선언문, 네임스페이스, use 문(클래스, 함수, 상수 순서) 및 기타 코드로 구성됩니다.
• 클래스 선언: extends, implements는 클래스 이름과 같은 줄에 선언하며, 클래스 정의의 여는 중괄호 {는 별도의 줄에, 닫는 중괄호 }는 클래스 본문 다음 줄에 위치해야 합니다. Trait 사용 시 use는 클래스 여는 중괄호 다음 줄에 오고, trait마다 별도의 use를 사용해야 합니다.
• 속성 및 메서드: 모든 속성과 메서드는 가시성(public, private, protected)을 명시해야 합니다. 속성 이름 앞에 언더스코어(_)를 사용하지 않습니다.
• 호출: 함수/메서드 호출 시 함수/메서드 이름과 여는 괄호 사이에 공백이 없어야 합니다.
• 제어 구조: 제어 구조 키워드 후에는 공백이 있어야 하며, 괄호 안팎의 공백 규칙, 본문의 들여쓰기 및 중괄호 위치 등을 규정합니다.
• Switch: case는 한 단계 들여쓰고, break는 case 본문과 같은 레벨로 들여씁니다. 의도적인 case 연쇄 시 주석을 추가합니다.

개발 임팩트

PSR-12는 PHP 코드의 일관성을 확보하여 여러 개발자가 함께 작업할 때 발생하는 마찰을 줄여줍니다. 이는 코드의 가독성을 높이고, 유지보수성을 개선하며, 코드 리뷰 프로세스를 간소화하는 데 기여합니다. 또한, 자동화된 코드 검증 도구와의 호환성을 높여 개발 생산성을 향상시킬 수 있습니다.