Hihaho Rector RulesStop reviewing the same convention twice

Rector rules that rewrite Laravel convention breaches instead of reporting them: naming, routing, migration safety, Eloquent relations and named arguments.

Why these rules?

Installation

Getting started

Verify, then rewrite

A table string becomes a model class only when the resolved model's own table provably equals it. A model with a mismatched $table or an overridden getTable() is left alone.

Seven sets, enable what you want

Code quality, Eloquent, naming, routing, migrations, imports and testing. Take all of them with one constant, or pick per set.

Never invents a symbol

Relation strings become constants that already exist and are public. A nested path converts all or nothing, so an unresolvable segment leaves the whole string as it was.

Migration safety

Strips column positioning that can disable MySQL's INSTANT DDL, and inlines the class constants that make a migration depend on code that will move.

Four rules stay opt-in

Where the safe answer depends on your database engine, your middleware aliases or your auth boundary, the rule is a no-op until you say so.

Pairs with PHPStan

hihaho/phpstan-rules reports what needs a human decision. These rules fix what does not.

What a run looks like

text

1 file with changes
===================

1) app/Http/Resources/Article.php:4

    ---------- begin diff ----------
@@ Line 4 @@

 use Illuminate\Http\Resources\Json\JsonResource;

-class Article extends JsonResource
+class ArticleResource extends JsonResource
 {
 }
    ----------- end diff -----------

Applied rules:
 * AddResourceSuffixRector


 [OK] 1 file would have been changed (dry-run) by Rector

Install it as a dev dependency, enable a set, and dry-run before you apply.

bash

composer require hihaho/rector-rules --dev
vendor/bin/rector process --dry-run

Where to next

Step 1Why hihaho/rector-rules?What the rules rewrite, what they refuse to guess at, and when another tool is the right one.Step 2InstallationRequire the package, check the versions, and enable a set in rector.php.Step 3Getting startedOne dry run, reading the diff it prints, and keeping the codebase clean in CI.