php-censor / phpdoc-checker
A simple tool for checking that your PHP classes and methods use PHPDocs (PHP DocBlocks Checker fork).
Installs: 72 591
Dependents: 2
Suggesters: 0
Security: 0
Stars: 13
Watchers: 2
Forks: 2
Open Issues: 0
pkg:composer/php-censor/phpdoc-checker
Requires
- php: >=7.4.0
- ext-ctype: *
- ext-json: *
- nikic/php-parser: ^4.12
- symfony/console: ^4.4|^5.0
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.4
- infection/infection: ^0.25
- php-parallel-lint/php-parallel-lint: ^1.3
- phploc/phploc: ^7.0
- phpmd/phpmd: ^2.10
- phpunit/phpunit: ^9.5
- sebastian/phpcpd: ^6.0
- vimeo/psalm: ^4.16
This package is auto-updated.
Last update: 2025-10-07 19:02:41 UTC
README
PHPDoc Checker
Check PHP files within a directory for appropriate use of PHPDocs (Docblocks). PHPDoc Checker is fork of PHP DocBlock Checker.
Installation
Composer:
composer require php-censor/phpdoc-checker
Building Phar Package
box.phar compile
Usage
vendor/bin/phpdoc-checker {params}
Parameters
| Short | Long | Description |
|---|---|---|
| -h | --help | Display help message. |
| -x | --exclude=EXCLUDE | Files and directories to exclude. |
| -d | --directory=DIRECTORY | Directory to scan. [default: "./"] |
| -f | --files=FILES | Files to scan. |
| none | --skip-classes | Don't check classes for docblocks. |
| none | --skip-methods | Don't check methods for docblocks. |
| none | --skip-signatures | Don't check docblocks against method signatures. |
| -j | --json | Output JSON instead of a log. |
| -l | --files-per-line=FILES-PER-LINE | Number of files per line in progress [default: 50] |
| -w | --fail-on-warnings | Consider the check failed if any warnings are produced. |
| -i | --info-only | Information-only mode, just show summary. |
| -q | --quiet | Do not output any message. |
| -V | --version | Display this application version. |
| none | --ansi | Force ANSI output. |
| none | --no-ansi | Disable ANSI output. |
| -n | --no-interaction | Do not ask any interactive question. |
| -v -vv -vvv | --verbose | Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug. |
Unit tests
Phpunit tests:
vendor/bin/phpunit --configuration=phpunit.xml.dist --coverage-text --coverage-html=tests/var/coverage
License
PHPDoc Checker is open source software licensed under the BSD-2-Clause license.