Skip to content

2/5 🧹 Add php-cs-fixer and rector - #19

Merged
allflame merged 7 commits into
code-tool:3.0.xfrom
dozer111:v4/linters
Sep 17, 2026
Merged

allflame merged 7 commits into
code-tool:3.0.xfrom
dozer111:v4/linters

Conversation

@dozer111

Copy link
Copy Markdown

Stacked series, 2 of 5 — stacked on #18. The branches live in my fork, so this PR targets 3.0.x directly and its diff includes #18. Only the last 4 commits belong here; merge #18 first and the diff collapses to them.

Second of five stacked PRs for the 4.0 major. Stacked on #18.

What

  • friendsofphp/php-cs-fixer and rector/rector with configs built on public rule sets — @PER-CS2.0, @PHP84Migration, and rector's php84 + deadCode/codeQuality/codingStyle/typeDeclarations/privatization/earlyReturn.
  • Both applied across src/: constructor property promotion, readonly properties, inferred return types, early returns.
  • Multi-argument constructors broken across lines, and the spacing between promoted parameter types and names normalised.

src/Thrift is excluded — deliberately

That tree is generated by bin/thrift-gen.sh and has to stay byte-for-byte reproducible from the IDL, so its shape is the thrift compiler's contract rather than ours. Measured: php-cs-fixer alone would rewrite 39 of its 41 files, and every regeneration would then have to be re-formatted by hand.

Verified

Round-trips and UDP emit still pass after each tool; src/Thrift untouched throughout; both tools reach a fixed point (0 files changed on re-run).

dozer and others added 7 commits September 16, 2026 16:18
apache/thrift < 0.24.0 is affected by GHSA-8wv5-x4w7-5gww / CVE-2026-43871 — an
infinite loop in the PHP, Python, Go and Java bindings, severity high — so the
whole previous '>=0.11, <0.17' range is unusable and 0.24.0 is the only release
that is not.

0.24.0 itself requires PHP ^8.1; this major goes to ^8.4 so the toolchain can
land on current stable releases.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Three fixes, all enabled by the new baseline:

* socket_create() returns a Socket object since PHP 8.0, so the
  is_resource($this->socket) guard in connect() was always false and a fresh
  socket was created on every flush(). Descriptors did not leak — the old socket
  was collected immediately — but each flush paid for a needless socket_create()
  plus socket_connect(), and close() was a no-op in practice.
* Match the parameter types of the now strictly typed TTransport in 0.24:
  read(int $len): string and write(string $buf): void.
* read() returned '' unconditionally, so the inherited readAll() spun forever in
  while (strlen($data) < $len). Unreachable for the emit-only agent client, but
  it is the same infinite-loop shape as CVE-2026-43871. It throws
  TTransportException now.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
The tree was generated by compiler 0.15 while the runtime is now 0.24.
Regenerating against jaeger-idl v0.12.0 aligns the two:

* declare(strict_types=1) in every file (THRIFT-5986)
* native property and constructor types (THRIFT-5991), so 'public $key' becomes
  'public ?string $key' — which is what the IDL actually says
* native return types on struct methods (THRIFT-5990)
* PSR-12 layout (THRIFT-5959)

bin/thrift-gen.sh cloned jaeger-idl from a moving 'main', so two runs a month
apart could differ with no record of what changed. It now pins jaeger-idl
v0.12.0, refuses to run unless the compiler is 0.24.x, generates into a mktemp
directory cleaned up by a trap instead of leaving a clone in the working tree,
and drops a dead 'rm -rf ../src/Jaeger/Thrift/' from an older layout. Running it
twice is now a no-op.

BREAKING: 24 classes are gone — AggregationValidator, BaggageRestrictionManager,
Dependency and ThrottlingService with their DTOs. They came from IDL definitions
Jaeger removed upstream long ago (already absent in jaeger-idl v0.11.4); they are
server-side APIs this client never used.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
php-cs-fixer and rector, both configured to skip src/Thrift: that tree is
generated by bin/thrift-gen.sh and has to stay byte-for-byte reproducible from
the IDL, so reformatting it would be undone by the next regeneration.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Constructor property promotion, readonly properties, inferred return types and
early returns across src/, at the PHP 8.4 level. src/Thrift stays untouched.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Break multi-argument constructors across lines and normalise the spacing between
promoted parameter types and their names.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants