psr – Türker Yıldırım

A PSR-18 decorator ordering that was documented and still got reversed

NoteAugust 14, 20262 min read

A comment explaining why each layer is where it is, and a fifth layer inserted in the wrong place anyway. A comment describing an order is read by…

PSR-3 context, and the field that was finally queried

NoteMay 7, 20262 min read

A structured logging field added in 2023, never queried, and the one week it was the only thing that helped. A field with no queries against it for…

The value object library, five years on

Deep diveMay 5, 202610 min read

32 value objects in 2021, 41 now, and a retrospective on which of them earned their place. No symptom — a deliberate look.

PSR-7 immutability, and the request I mutated by accident

NoteDecember 10, 20252 min read

A with method whose return value was discarded, which is the one mistake PSR-7 makes easy. An immutable interface with fluent setters produces exactly this, and the discarded…

PSR-18 middleware, and the order that matters

NoteNovember 13, 20251 min read

Four decorators around an HTTP client, composed in an order that is obvious once and unrecoverable afterwards. Signing inside retry is mandatory — a retried request needs a…

The PSR-18 client I wrote for one API

Deep diveJune 26, 202510 min read

A supplier API with a signing scheme, a rate limit and a pagination style of its own, and the same four concerns implemented in three places.

A package I published, and the API design I got wrong twice

Deep diveMay 19, 202516 min read

turkerdev/php-figma-api, a typed client for a third-party REST API, and two design mistakes that only appear once somebody else uses it.

A PSR-14 dispatcher, and the listener I could not order

NoteFebruary 19, 20252 min read

PSR-14 deliberately says nothing about listener priority, which is a principled decision and occasionally an obstacle. Two listeners on the same event where one must observe the other’s…

Property hooks, and the getter that was a habit

Deep diveDecember 16, 202410 min read

8.4 on 21 November, and a property can have a getter without being a method. 412 getters that return a property unchanged.

PSR-20 clocks, and the fake I stopped writing

NoteApril 3, 20242 min read

A clock interface written by hand in four projects, each slightly different, replaced by the standard one. One method returning a DateTimeImmutable is a small enough interface that…