Options Reference

Complete reference for all vendor/bin/doctest command-line options.

Arguments

files

Positional arguments specifying markdown files or directories to test.

# Single file
vendor/bin/doctest README.md

# Multiple files
vendor/bin/doctest docs/getting-started.md docs/api.md

# Directory (scans recursively for .md files)
vendor/bin/doctest docs/

# Mixed
vendor/bin/doctest README.md docs/

If no files are specified, DocTest uses the configured paths (default: docs/ and README.md).

Options

--filter, -f

Filter blocks by content or file name. Only blocks whose code or file path contains the filter string will execute.

# Only run blocks containing "array_map"
vendor/bin/doctest --filter="array_map"

# Filter by file name
vendor/bin/doctest --filter="getting-started"

--exclude

Exclude files matching a pattern.

# Skip vendor directory
vendor/bin/doctest --exclude vendor

# Skip draft docs
vendor/bin/doctest --exclude drafts

--dry-run

Parse and list blocks without executing them. Useful for verifying which blocks DocTest will find.

vendor/bin/doctest --dry-run

--stop-on-failure

Stop execution at the first failing block.

vendor/bin/doctest --stop-on-failure

--config, -c

Specify a custom config file path (default: doctest.php in project root).

vendor/bin/doctest -c custom-doctest.php

Verbosity

Verbosity is controlled with the standard Symfony Console -v flags:

Flag	Level	Shows
(none)	Normal	Block-level pass/fail only
-v	Verbose	Per-assertion details under each block
-vv	Very verbose	Also shows source code on failure

# Show assertion details
vendor/bin/doctest -v

# Show assertion details + source code
vendor/bin/doctest -vv

Combining Options

Options can be combined:

vendor/bin/doctest docs/ --filter="database" --stop-on-failure -v