Exit Codes

DocTest uses standard exit codes compatible with CI systems.

Exit Codes

Code	Constant	Meaning
0	Command::SUCCESS	All blocks passed (or were skipped)
1	Command::FAILURE	One or more blocks failed
3	—	No files found or no testable blocks extracted

CI Usage

Use the exit code to fail CI builds when documentation tests break:

vendor/bin/doctest || exit 1

Or simply:

vendor/bin/doctest

Most CI systems treat any non-zero exit code as a failure.

Exit Codes in Update Mode (--update)

In update mode, exit codes have slightly different semantics:

Code	Meaning
0	All updatable assertions rewritten; no non-updatable assertion failures
1	Non-updatable assertions (contains, matches, expect) still failing, or --update combined with --dry-run / --stop-on-failure
3	No files found or no testable blocks extracted

Verbosity in CI

For CI environments, the default verbosity is usually sufficient. Use -v for more detailed output in logs:

vendor/bin/doctest -v

Combining with Reporters

Use the JSON reporter for machine-readable test results:

Create a doctest.php config:

return [
    'reporters' => [
        'console' => true,
        'json'    => 'build/doctest.json',
    ],
];