Repository navigation
Stdlib: stream_socket_pair() — connected socket pair (ext/standard/streams.c parity) #3437
Description
Category
stdlib
Problem
stream_socket_pair() creates two connected stream endpoints (used for IPC, subprocess pipes, and tests). It is registered in Zend but missing from ext/standard/Module.php.
php-src reference
ext/standard/streams.c—PHP_FUNCTION(stream_socket_pair)ext/standard/basic_functions.stub.php—(array|false) stream_socket_pair(int $domain, int $type, int $protocol)
Repro (failure today)
<?php
var_export(function_exists('stream_socket_pair'));
$s = stream_socket_pair(STREAM_PF_UNIX, STREAM_SOCK_STREAM, STREAM_IPPROTO_IP);
var_export($s);./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php repro.php'
php repro.phpZend PHP: function_exists → true; returns two stream resources
This compiler: function_exists → false
Scope (this repo)
ext/standard/stream_socket_pair.php+ VM helper usingstream_socket_pair()host call or native socketpair- Wire into existing stream resource representation (Stdlib: stream_get_meta_data / stream_set_blocking — stream introspection (ext/standard/streams.c parity) #3237 meta)
- Compliance PHPT: UNIX domain pair echo round-trip
- Optional JIT stub deferral (VM-first)
Done when
- Repro returns two readable/writable streams on Linux
STREAM_PF_UNIX - Errors for unsupported domain/type match Zend
ValueError/Warningsubset -
./script/ci-fast.sh --filter stream_socket_pairgreen -
docs/capabilities.mdrow
Activity
PurHur commentedon Jun 13, 2026
claim: PHP Compiler STD Lib — starting this run
PurHur commentedon Jun 13, 2026
Merged via #8316.
Verification
VM path uses `VmStreamSocketPairNative` (libc socketpair FFI). JIT/AOT `call()` lowering remains deferred.
Add stream_socket_pair() via libc socketpair FFI (#3437). (#8316)
PurHur commentedon Jun 13, 2026
claim: PHP Compiler STD Lib — starting this run (stream_socket_pair JIT/AOT lowering, phase 2 of #3437).
Add JIT/AOT lowering for stream_socket_pair() (#3437). (#8386)
PurHur commentedon Jun 13, 2026
Merged via #8386
PHP path:
StreamSocketPairJitemits__compiler_stream_socket_pair(libcsocketpair+fdopen, registers both ends inphpc_stream_handles).JitStreamSocketPairwraps the returned hashtable as a PHP array of stream handles.C shrink: 0 lines (no new
runtime/symbols).Verification (green):
vendor/bin/phpunit --filter stream_socket_pair test/compliance/→ OK (6 tests, VM + JIT)php bin/compile.php -l test/fixtures/aot/compile-only/stream_socket_pair_smoke.php→ exit 0docs/capabilities.md:stream_socket_pairyes/yes/yes