Always-read and written properties
PHPStan is able to detect unused, never-read and never-written private properties. There might be some cases where PHPStan thinks a property is unused, but the code might actually be correct. For example libraries like Doctrine ORM might take advantage of reflection to write and read private properties which static analysis cannot understand, but fortunately you can write a custom extension to make PHPStan understand what’s going on and avoid false-positives.
This is the interface your extension needs to implement:
public function isAlwaysRead(PropertyReflection $property, string $propertyName): bool;
public function isAlwaysWritten(PropertyReflection $property, string $propertyName): bool;
public function isInitialized(PropertyReflection $property, string $propertyName): bool;
The implementation needs to be registered in your configuration file:
- Property is always read (it doesn’t need a getter) if it’s a persisted field or association. This is because we might save some data into the database without reading them in the code, only referencing the fields in DQL queries, or maybe having them read directly from the database by another company department.
- Property is always written (it doesn’t need assigning in code) if it’s a primary key with a generated value, or if it’s a read-only entity without a constructor. Records for read-only entities are usually inserted into the database through some other means and are for tables where data doesn’t change often.