THRIFT-5980: Add native method types to PHP Transport hierarchy

[sveneld]

Migrates the public methods on lib/php/lib/Transport/ from PHPDoc @param/@return annotations to native parameter and return types, plus fixes a long-standing correctness bug in TJSONProtocol::writeJSONDouble that strict-mode typing surfaced.

Completes the typing trajectory for the Transport subtree started by THRIFT-5976 (properties), THRIFT-5977 (ctor promotion), THRIFT-5978 (strict_types) and THRIFT-5979 (Server + Factory method types).

Library

• TTransport abstract — isOpen(): bool, open(): void, close(): void, read(int): string, readAll(int): string, write(string): void, flush(): void.
• TSocket / TSSLSocket / TSocketPool — open/close/read/write/flush typed; setSendTimeout / setRecvTimeout / setDebug / setNumRetries / etc typed; getHost / getPort typed; setHandle return typed.
• TBufferedTransport / TFramedTransport / TMemoryBuffer / TNullTransport / TPhpStream — all method overrides typed to match the abstract.
• TFramedTransport::write keeps the legacy ?int $len = null optional parameter so existing internal callers in TBinaryProtocol / TCompactProtocol still type-check; the non-write path now delegates with just the buffer.
• TCurlClient / THttpClient — read/write/flush/close/open typed; timeout setters typed as ?float (int widens automatically); addHeaders typed array.

NaN / Infinity round-trip fix

TJSONProtocol::readJSONDouble already parses the quoted strings "NaN" → NAN and "Infinity" → INF (Thrift JSON convention), but writeJSONDouble previously called json_encode($num) which returns false for NaN/INF; once typed write(string) rejects false, this used to silently emit empty output ({"dbl":}) — locked into integration tests with a #TODO Should be fixed in future comment.

Now writes the conventional quoted strings:

• NAN → "NaN"
• INF → "Infinity"
• -INF in TJSONProtocol → TProtocolException::INVALID_DATA (the read side has no inverse).
• -INF in TSimpleJSONProtocol → "-Infinity" symmetrically (write-only protocol).

The TODO is resolved; integration tests updated to assert the correct outputs.

Other side fixes surfaced by typing

• TSocket::setSendTimeout / setRecvTimeout: switched from floor($timeout / 1000) to intdiv($timeout, 1000) so the typed int property assignment is exact (floor returns float).
• TCurlClient::$timeout / $connectionTimeout and THttpClient::$timeout tightened from float|int|null to ?float (int widens automatically per PHP rules).

Tests

• TBinaryProtocolTest / TCompactProtocolTest / TBufferedTransportTest / TFramedTransportTest — dropped ->willReturn(N) from mocks of the now-void write/open/close/flush. Behavior unchanged; PHPUnit refuses to mock returning a value for void methods.
• TFramedTransportTest::testWrite — mock with('12345', 5) updated to with('12345') after the non-write path now passes only the buffer to the underlying transport.
• TCurlClientTest — timeout data provider switched to float literals (10.0 instead of 10) to match the now-typed ?float properties.
• Integration TJSONProtocolTest / TSimpleJSONProtocolTest — NaN / Infinity write assertions updated from the broken {"dbl":} / {"thing":} outputs to the correct round-trippable strings.

Part of THRIFT-5960 — modernizing PHP runtime library typing.

• Did you create an Apache Jira ticket? — THRIFT-5980
• If a ticket exists: Does your pull request title follow the pattern "THRIFT-NNNN: describe my issue"? — yes
• Did you squash your changes to a single commit? — yes
• Did you do your best to avoid breaking changes? — yes for the typing portion. The NaN/Infinity write change is a wire-format fix that aligns PHP with the Thrift JSON convention already used by TJSONProtocol::readJSONDouble; previously this path produced unreadable output, so callers depending on it were already broken.
• If your change does not involve any code, include [skip ci] anywhere in the commit message to free up build resources. — N/A (code change)

Generated-by: Claude Opus 4.7