tomasvotruba/ctor

Prefer constructor over always called setters

0.0.6 2025-07-12 06:32 UTC

Requires

• php: ^7.4|^8.0
• phpstan/phpstan: ^2.1.14
• webmozart/assert: ^1.11

MIT

README

If you can use constructor instead of setters, use it. These PHPStan rules will help you to find such cases.

What It Does?

This tool collects instances of new object() followed by a series of method calls on the same object:

$human = new Human();
$human->setName('Tomas');
$human->setAge(35);

...and suggests turning them into constructor arguments:

$human = new Human('Tomas', 35);

Why?

Such chained setters often indicate implicit required dependencies. By moving them to the constructor, you make the object state explicit, safer, and easier to reason about — and even easier to test.

Installation

composer require tomasvotruba/ctor --dev

Usage

Make use phpstan/extension-installer to load the extension automatically.

Run PHPStan and it will automatically run the rules.

Happy coding!