Repository navigation
Stdlib: socket_create_pair() — Unix socket pair API missing (ext/sockets/sockets.c) #6563
Description
Category
stdlib
Problem
socket_create_pair() (ext/sockets) creates two connected socket endpoints for IPC. Distinct from stream_socket_pair() (#3437 / closed #4996) which returns stream resources — socket_create_pair() fills a by-ref array with Socket objects (PHP 8+).
This compiler: function_exists('socket_create_pair') → false.
php-src reference
- php/php-src
ext/sockets/sockets.c—PHP_FUNCTION(socket_create_pair) - php/php-src
ext/sockets/php_sockets.h—Socketobject/resource type
Repro
<?php
var_export(function_exists('socket_create_pair'));
echo "\n";
$pair = [];
$ok = socket_create_pair(AF_UNIX, SOCK_STREAM, 0, $pair);
var_export($ok);
echo "\n";
if ($ok) {
socket_write($pair[0], "hi", 2);
echo socket_read($pair[1], 2), "\n";
}./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php repro.php'| Runtime | Output |
|---|---|
| Zend PHP 8.x | true + hi |
| This compiler | false then undefined function |
Scope (this repo)
| Piece | Path / notes |
|---|---|
| ext module | ext/sockets/ (phase 2 of #3399) — register after socket_create baseline |
| VM | Socket class or resource + socket_write/socket_read on pair endpoints |
| Tests | test/compliance/cases/stdlib/socket_create_pair.phpt (skip on hosts without AF_UNIX) |
| Matrix | script/capability-matrix.php |
Implement in ext/ + VM — no permanent logic in runtime/*.c beyond thin POSIX socketpair() ABI if unavoidable.
Done when
- Repro:
socket_create_pair()returnstrue, array of two usable sockets, round-trip"hi" - Wrong
$domain/$type/$protocol→false+socket_last_error()like Zend -
./script/ci-fast.sh --filter socket_create_pairgreen on VM
Related
- Stdlib: ext/sockets — socket_create/connect/read/write (ext/sockets parity) #3399 ext/sockets baseline, Stdlib: stream_socket_pair() — connected socket pair (ext/standard/streams.c parity) #3437 stream_socket_pair, Stdlib: socket_select() — ext/sockets multiplexing API missing (ext/sockets/sockets.c) #6395 socket_select
- North star: Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492
Activity
PurHur commentedon Jul 15, 2026
claim: PHP Compiler STD Lib Advanced — batch (after #3366/#6490): socket_create_pair (#6563)
PurHur commentedon Jul 15, 2026
Handoff (advanced stdlib batch after #3366 + #6490): blocked for a clean single-issue PR.
socket_create_pair()repro needs endpoints thatsocket_write/socket_readaccept. Today:stream_socket_pair+socket_import_streamexistsocket_create/socket_write/socket_read/socket_closeare not registered (function_exists→ false)Phase-1 options for next run:
socket_create_pairviastream_socket_pair+socket_import_stream, and thinsocket_write/socket_readon importedSocketobjects (enough for the issue repro), or#3399socket_create baseline first, then pair API.Not starting a half-wired pair stub this run — avoids green registration with red
socket_writeon the same issue.PurHur commentedon Jul 15, 2026
claim: PHP Compiler STD Lib Advanced — batch (issues #4387, #6138, #6563)
Queued after #4387 and #6138. function_exists(socket_create_pair) is false on master.
PurHur commentedon Jul 15, 2026
claim: PHP Compiler STD Lib Advanced — still queued after #4387 (#6138 merged via #19327).
PurHur commentedon Jul 15, 2026
claim: PHP Compiler STD Lib Advanced — starting #6563 after #4387 merged (#19328) and #6138 (#19327).
PurHur commentedon Jul 15, 2026
Merged via PR for #6563.
Shipped:
socket_create_pair()viaSocketsLibcThinAbi::socketpair+ owned Socket FDs; by-ref pair array.Verification:
Stdlib: socket_create_pair via libc socketpair (#6563) (#19329)