PHPUnitManual:14.3

14.3 파일의 포함과 제외

초기 설정에서는 1행이라도 코드가 실행된 소스 코드 파일은 모두 (그리고 그러한 파일만이) 레포트에 포함됩니다. 레포트에 포함되는 소스 코드 파일은, 화이트 리스트 방식이나 블랙 리스트 방식으로 필터링할 수 있습니다.

블랙 리스트에는, PHPUnit 자체 소스 코드 파일이나 테스트 파일이 처음부터 등록되어 있습니다. 화이트 리스트가 비어 있는 (초기 상태인) 경우에는 블랙 리스트를 사용하고, 화이트 리스트가 비어 있지 않은 경우에는 화이트 리스트를 사용합니다. 화이트 리스트에 들어 있는 각 파일은, 해당 파일의 실행 여부와 상관없이 레포트에 추가됩니다. 추가된 파일의 모든 행은, 실행 불가능한 행도 포함하여 "실행되지 않은 행" 으로 간주됩니다.

PHPUnit 의 설정에, processUncoveredFilesFromWhitelist="true" ("Code coverage 대상 파일의 추가/제외" 를 참조하세요) 를 추가할 경우, 해당 파일들이 PHP_CodeCoverage 에 include 되고, 실행 가능한 행 수가 계산됩니다.

주의사항

processUncoveredFilesFromWhitelist="true" 가 설정되어 있는 경우, 클래스나 함수의 scope 에서 벗어나는 코드가 포함된 소스 파일의 읽기에서 문제가 발생할 수 있습니다.

PHPUnit 의 XML 설정 파일 ( "Code Coverage 대상 파일의 추가/제외"를 참조하세요) 를 사용하여, 블랙 리스트 / 화이트 리스트를 제어할 수 있습니다. 화이트 리스트를 사용하여 Code coverage 레포트에 포함시키는 것을 권장합니다.