PHPackages juampi92/phecks - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Testing & Quality](/categories/testing) 4. / 5. juampi92/phecks ActiveLibrary[Testing & Quality](/categories/testing) juampi92/phecks =============== A package to run custom PHP checks v1.4(6mo ago)4395.9k—9.9%5[1 PRs](https://github.com/juampi92/phecks/pulls)MITPHPPHP ^8.1|^8.2|^8.3|^8.4CI passing Since Jul 13Pushed 6mo ago2 watchersCompare [ Source](https://github.com/juampi92/phecks)[ Packagist](https://packagist.org/packages/juampi92/phecks)[ RSS](/packages/juampi92-phecks/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (9)Versions (15)Used By (0) Phecks ======== [](#------------phecks--------) [Documentation](https://juanpablo2.gitbook.io/phecks/) | [Credits](#credits) [![Latest Version on Packagist](https://camo.githubusercontent.com/6769599aa29e0a5b5e1730d84a106d602a6344d83e29cc996da1745cb5cc22c1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6a75616d706939322f706865636b732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/juampi92/phecks) [![Downloads Per Month](https://camo.githubusercontent.com/197b21f4cb368b50196cfadd40a2f6961c001975bc9f7c156194f0a75fdaad55/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6a75616d706939322f706865636b732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/juampi92/phecks) [![GitHub Tests Action Status](https://camo.githubusercontent.com/943372f5ec105a5bedb2366a0ff83a64c2058b273126320ba693cbc7848c0709/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f776f726b666c6f772f7374617475732f6a75616d706939322f706865636b732f72756e2d74657374733f6c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/juampi92/phecks/actions?query=workflow%3Arun-tests+branch%3Amain) [![PHP from Packagist](https://camo.githubusercontent.com/34eb1c51818f4ed842984b397962e39884b2a04fe520f73f20224cdec2f5d9a9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6a75616d706939322f706865636b732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/juampi92/phecks) --- Phecks (stands for PHP-Checks) is a custom Check Runner. It will run custom checks in your codebase and will make a report of violations that need fixing. What is it for? --------------- [](#what-is-it-for) - For big teams to align on a styleguide beyond linting. - Used as an extra set of eyes during the Code Review. - Teams make their own checks according to their architectural decisions and styleguides. [See what checks are for](https://juanpablo2.gitbook.io/phecks/about-phecks/what-is-a-check). On its own, Phecks doesn't contain any checks. You and your team are responsible for defining and implementing these checks based on your architectural decisions. Phecks will provide you with a structure to develop and run these checks easily. Installation ------------ [](#installation) You can install the package via composer: ``` composer require juampi92/phecks --dev ``` Read the full installation instructions in the [documentation](https://juanpablo2.gitbook.io/phecks/). Usage ----- [](#usage) Create a Check to make sure your team's architectural decisions are respected: ``` /** * @implements Check */ class ConsoleClassesMustBeSuffixedWithCommandCheck implements Check { public function __construct( private readonly ClassSource $source, ) {} /** * This method will get all the possible matches. */ public function getMatches(): MatchCollection { return $this->source ->directory('./app/Console') ->run() ->reject(fn (ReflectionClass $class): bool => $class->isAbstract()) ->pipe(new WhereExtendsClassFilter(\Illuminate\Console\Command::class)); } /** * processMatch will check if the matches are * actual violations, and format them properly. */ public function processMatch($match, FileMatch $file): array { if (Str::endsWith($match->getName(), 'Command')) { return []; } return [ ViolationBuilder::make()->message('Command classes must be suffixed with \'Command\''), ]; } } ``` Add the class in the config `phecks.checks` And run the following: ``` php artisan phecks:run ``` [![error-output](docs/error-output.png)](docs/error-output.png) Testing ------- [](#testing) ``` composer test ``` Credits ------- [](#credits) - [juampi92](https://github.com/juampi92) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 52 — FairBetter than 96% of packages Maintenance65 Regular maintenance activity Popularity40 Moderate usage in the ecosystem Community15 Small or concentrated contributor base Maturity72 Established project with proven stability Bus Factor1 Top contributor holds 94.7% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~92 days Recently: every ~199 days Total 14 Last Release 209d ago Major Versions v0.4 → v1.02022-08-26 PHP version history (4 changes)v0.1PHP ^7.4|^8.0|^8.1 v1.0.1PHP ^8.0|^8.1|^8.2 v1.1PHP ^8.1|^8.2|^8.3 v1.4PHP ^8.1|^8.2|^8.3|^8.4 ### Community Maintainers ![](https://www.gravatar.com/avatar/1f8d31c9bb6d7862e21aac7af0f7b2615dc06485b4c30b19b8d9fdffaa42c712?d=identicon)[juampi92](/maintainers/juampi92) --- Top Contributors [![juampi92](https://avatars.githubusercontent.com/u/2080215?v=4)](https://github.com/juampi92 "juampi92 (90 commits)")[![alirezamirsepassi](https://avatars.githubusercontent.com/u/22807073?v=4)](https://github.com/alirezamirsepassi "alirezamirsepassi (2 commits)")[![sunchayn](https://avatars.githubusercontent.com/u/14861869?v=4)](https://github.com/sunchayn "sunchayn (2 commits)")[![laravel-shift](https://avatars.githubusercontent.com/u/15991828?v=4)](https://github.com/laravel-shift "laravel-shift (1 commits)") --- Tags ci-cdlaravelphecksphptestingapilaravel ### Code Quality TestsPHPUnit Static AnalysisPHPStan Code StylePHP CS Fixer ### Embed Badge ![Health badge](/badges/juampi92-phecks/health.svg) ``` [![Health](https://phpackages.com/badges/juampi92-phecks/health.svg)](https://phpackages.com/packages/juampi92-phecks) ``` ### Alternatives [larastan/larastan Larastan - Discover bugs in your code without running it. A phpstan/phpstan extension for Laravel 6.4k43.5M5.2k](/packages/larastan-larastan)[roots/acorn Framework for Roots WordPress projects built with Laravel components. 9682.1M97](/packages/roots-acorn)[andreaselia/laravel-api-to-postman Generate a Postman collection automatically from your Laravel API 1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[laravel/ai The official AI SDK for Laravel. 732506.3k60](/packages/laravel-ai)[laravel/folio Page based routing for Laravel. 608453.9k27](/packages/laravel-folio)[laravel-zero/framework The Laravel Zero Framework. 3371.4M369](/packages/laravel-zero-framework) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)