Onionmixer: PHPUnit 5.1 Command-Line switches 페이지 추가

2013-07-02T07:48:11Z

PHPUnit 5.1 Command-Line switches 페이지 추가

New page

;5.1 Command-Line switches

다음 코드를 통해, PHPUnit 의 command-line tool 의 스위치들을 살펴봅시다.

<syntaxhighlight lang="text">
phpunit --help
PHPUnit 3.7.0 by Sebastian Bergmann.

Usage: phpunit [switches] UnitTest [UnitTest.php]
phpunit [switches] <directory>

--log-junit <file> Log test execution in JUnit XML format to file.
--log-tap <file> Log test execution in TAP format to file.
--log-json <file> Log test execution in JSON format.

--coverage-clover <file> Generate code coverage report in Clover XML format.
--coverage-html <dir> Generate code coverage report in HTML format.
--coverage-php <file> Serialize PHP_CodeCoverage object to file.
--coverage-text=<file> Generate code coverage report in text format.
Default to writing to the standard output.

--testdox-html <file> Write agile documentation in HTML format to file.
--testdox-text <file> Write agile documentation in Text format to file.

--filter <pattern> Filter which tests to run.
--group ... Only runs tests from the specified group(s).
--exclude-group ... Exclude tests from the specified group(s).
--list-groups List available test groups.

--loader <loader> TestSuiteLoader implementation to use.
--printer <printer> TestSuiteListener implementation to use.
--repeat <times> Runs the test(s) repeatedly.

--tap Report test execution progress in TAP format.
--testdox Report test execution progress in TestDox format.

--colors Use colors in output.
--stderr Write to STDERR instead of STDOUT.
--stop-on-error Stop execution upon first error.
--stop-on-failure Stop execution upon first error or failure.
--stop-on-skipped Stop execution upon first skipped test.
--stop-on-incomplete Stop execution upon first incomplete test.
--strict Run tests in strict mode.
-v|--verbose Output more verbose information.
--debug Display debbuging information during test execution.

--process-isolation Run each test in a separate PHP process.
--no-globals-backup Do not backup and restore $GLOBALS for each test.
--static-backup Backup and restore static attributes for each test.

--bootstrap <file> A "bootstrap" PHP file that is run before the tests.
-c|--configuration <file> Read configuration from XML file.
--no-configuration Ignore default configuration file (phpunit.xml).
--include-path <path(s)> Prepend PHP's include_path with given path(s).
-d key[=value] Sets a php.ini value.

-h|--help Prints this usage information.
--version Prints the version and exits.
</syntaxhighlight>

{| class = "collapsible collapsed" width=100% style = "border-radius: 10px; -moz-border-radius: 10px; -webkit-border-radius: 10px; -khtml-border-radius: 10px; -icab-border-radius: 10px; -o-border-radius: 10px; border: 5px groove #000066;"
|- style="color: white; background-color: black;"
|'''Option'''||'''내용'''
|- style="vertical-align:top;"
|phpunit UnitTest||UnitTest 클래스에 정의되어 있는 테스트를 실행합니다. 이 클래스는 UnitTest.php 파일에서 정의되어 있어야 합니다.

UnitTest 는 PHPUnit_Framework_TestCase 를 계승하는 클래스거나, 혹은 PHPUnit_Framework_TestCase 오브젝트를 return 하는 메소드를 제공하는 클래스 (예: PHPUnit_Framework_TestSuite) 여야 합니다.
|- style="vertical-align:top;"
|phpunit UnitTest UnitTest.php||UnitTest 클래스에 정의되어 있는 테스트를 실행합니다. 이 클래스는 지정 파일에 정의되어 있어야 합니다.
|- style="vertical-align:top;"
|'''--log-junit'''||JUnit XML 포맷을 사용하여 테스트의 실행 결과 로그를 작성합니다. "18장 로그 출력"을 참조해 주세요.
|- style="vertical-align:top;"
|'''--log-tap'''||Test Anything Protocol (TAP) [http://testanything.org/] 포맷을 사용하여 테스트의 실행 결과 로그를 작성합니다. "18장 로그 출력"을 참조해 주세요.
|- style="vertical-align:top;"
|'''--log-json'''||JSON [http://www.json.org/] 포맷을 사용하여 테스트의 실행 결과 로그를 작성합니다. "18장 로그 출력"을 참조해 주세요.
|- style="vertical-align:top;"
|'''--coverage-html'''||code coverage 레포트를 HTML 형식으로 작성합니다. "14장 code coverage 해석" 을 참조해 주세요.

이 기능은, tokenizer 확장 모듈 및 Xdebug 확장 모듈이 인스톨되어 있는 경우, 사용 가능합니다.
|- style="vertical-align:top;"
|'''--coverage-clover'''||테스트 결과를 XML 형식의 로그 파일로 작성하고, code coverage 정보도 포함시킵니다. "18장 로그 출력"을 참조해 주세요.

이 기능은, tokenizer 확장 모듈 및 Xdebug 확장 모듈이 인스톨되어 있는 경우, 사용 가능합니다.
|- style="vertical-align:top;"
|'''--coverage-php'''||연속적인 (serialized) PHP_CodeCoverage 오브젝트를 생성하고, code coverage 정보도 포함시킵니다.

이 기능은, tokenizer 확장 모듈 및 Xdebug 확장 모듈이 인스톨되어 있는 경우, 사용 가능합니다.
|- style="vertical-align:top;"
|'''--coverage-text'''||테스트 실행시, 로그 파일 혹은 command-line 출력으로 code coverage 정보를 생성합니다. "18장 로그 출력"을 참조해 주세요.

이 기능은, tokenizer 확장 모듈 및 Xdebug 확장 모듈이 인스톨되어 있는 경우, 사용 가능합니다.
|- style="vertical-align:top;"
|'''--testdox-html and --testdox-text'''||실행한 테스트 결과를 HTML 혹은 text 파일 형식의 문서로 생성합니다. "15장 테스트의 기타 사용법" 을 참조해 주세요.
|- style="vertical-align:top;"
|'''--filter'''||지정 패턴과 일치하는 테스트만을 실행합니다. 패턴으로 지정 가능한 것은 테스트의 이름이나 정규식 [http://www.php.net/pcre] 입니다.
|- style="vertical-align:top;"
|'''--group'''||지정 그룹의 테스트만을 실행합니다. 테스트를 그룹에 포함시키기 위해서는 @group 선언을 사용합니다.

@author 선언은 @group 의 일종으로, 테스트의 작성자 별로 테스트를 필터링합니다.
|- style="vertical-align:top;"
|'''--exclude-group'''||지정한 그룹을 테스트에서 제외합니다. 테스트를 그룹에 포함시키기 위해서는 @group 선언을 사용합니다.
|- style="vertical-align:top;"
|'''--list-groups'''||사용 가능한 테스트의 그룹의 리스트를 표시합니다.
|- style="vertical-align:top;"
|'''--loader'''||PHPUnit_Runner_TestSuiteLoader 를 구현한 클래스 중, 실제로 사용하는 클래스를 지정합니다.

표준 test suite loader 는 현재의 작업 디렉토리와 PHP 설정항목 include_path 에 지정된 디렉토리에서 소스 파일을 검색합니다. PEAR 명명규칙에 따라 Project_Package_Class 클래스는 소스파일의 패스 Project/Package/Class.php 를 의미합니다.
|- style="vertical-align:top;"
|'''--printer'''||결과를 표시하기 위해 사용하는 프린트 클래스를 지정합니다. 이 프린트 클래스는 PHPUnit_Util_Printer 를 계승하는 동시에 PHPUnit_Framework_TestListener 의 인터페이스를 구현한 것이어야 합니다.
|- style="vertical-align:top;"
|'''--repeat'''||지정 횟수만큼 테스트를 반복합니다.
|- style="vertical-align:top;"
|'''--tap'''||Test Anything Protocol (TAP) [http://testanything.org/] 를 사용하여 테스트의 진행 상황을 보고합니다. "18장 로그 출력"을 참조해 주세요.
|- style="vertical-align:top;"
|'''--testdox'''||테스트의 진행 상황을 agile 문서로 보고합니다. "15장 테스트의 기타 사용법" 을 참조해 주세요.
|- style="vertical-align:top;"
|'''--colors'''||색을 사용하여 출력합니다.
|- style="vertical-align:top;"
|'''--stderr'''||출력을 STDOUT 가 아닌 STDERR 로 지정합니다.
|- style="vertical-align:top;"
|'''--stop-on-error'''||첫번째 에러에서 테스트를 중단합니다.
|- style="vertical-align:top;"
|'''--stop-on-failure'''||첫번째 에러나 실패에서 테스트를 중단합니다.
|- style="vertical-align:top;"
|'''--stop-on-skipped'''||첫번째 테스트 skip 에서 테스트를 중단합니다.
|- style="vertical-align:top;"
|'''--stop-on-incomplete'''||첫번째 불완전한 테스트에서 테스트를 중단합니다.
|- style="vertical-align:top;"
|'''--strict'''||strict 모드에서 테스트를 실행합니다.
|- style="vertical-align:top;"
|'''--verbose'''||보다 자세한 정보를 출력합니다. 예를 들어, 불완전 테스트나 skip된 테스트의 이름이 표시됩니다.
|- style="vertical-align:top;"
|'''--process-isolation'''||각각의 테스트를 개별 PHP 프로세스로 실행합니다.
|- style="vertical-align:top;"
|'''--no-globals-backup'''||$GLOBALS 백업과 복구를 하지 않습니다. "Global State" 를 참조해 주세요.
|- style="vertical-align:top;"
|'''--static-backup'''||사용자 정의 클래스의 정적 속성을 백업, 복구합니다. "Global State" 를 참조해 주세요.
|- style="vertical-align:top;"
|'''--bootstrap'''||테스트 전에 실행되는 "bootstrap" PHP 파일을 지정합니다.
|- style="vertical-align:top;"
|'''--configuration, -c'''||XML 파일에서 설정을 로드합니다. "부록C XML 설정 파일" 을 참조해 주세요.

phpunit.xml 혹은 phpunit.xml.dist (이 순서로 사용합니다) 가 현재의 작업 디렉토리에 존재하고, 또한 --configuration 가 사용되지 않은 경우, 해당 파일로부터 설정을 자동적으로 로드합니다.
|- style="vertical-align:top;"
|'''--no-configuration'''||현재의 작업 디렉토리에 있는 phpunit.xml 과 phpunit.xml.dist 를 무시합니다.
|- style="vertical-align:top;"
|'''--include-path'''||PHP 의 include_path 의 처음부분에 지정 패스를 추가합니다.
|- style="vertical-align:top;"
|'''-d'''||지정한 PHP 설정 옵션값을 설정합니다.
|- style="vertical-align:top;"
|'''--debug'''||테스트의 이름 등 디버그 정보를 테스트 실행이 시작될 때 출력합니다.
|- style="color: black; background-color: gray;"
| colspan="2" |phpunit 의 옵션들
|}

==Notes==
<references />

PHPUnitManual:5.1 - Revision history

Onionmixer: PHPUnit 5.1 Command-Line switches 페이지 추가