Stdlib: fsockopen() — procedural TCP wrapper missing while stream_socket_client partial (#3202)

[PurHur]

Category

stdlib | runtime

Problem

Zend exposes both fsockopen($hostname, $port, …) and stream_socket_client('tcp://…'). This compiler registers stream_socket_client() (via VmStreamSocketNative) and pfsockopen(), but fsockopen() itself is not registered — function_exists('fsockopen') is false.

Legacy apps, PHPMailer, and health checks call fsockopen directly; parity requires the procedural wrapper.

php-src reference

• php/php-src ext/standard/fsock.c — PHP_FUNCTION(fsockopen)
• php/php-src ext/standard/streamsfuncs.c — shared transport behind php_stream_xport_create

Repro (failure today)

<?php
$errno = 0; $errstr = '';
$fp = @fsockopen('127.0.0.1', 9, $errno, $errstr, 1);
var_export([function_exists('fsockopen'), is_resource($fp), $errno, $errstr]);

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh
php -r "var_dump(function_exists(\"fsockopen\"), function_exists(\"stream_socket_client\"));"
php bin/vm.php repro_fsockopen.php
'

Verified 2026-06-16 harness: stream_socket_client → yes, fsockopen → no.

Runtime	function_exists('fsockopen')	Connect port 9
Zend PHP 8.x	true	false + errno
bin/vm.php	false	fatal undefined function

Scope (this repo)

Path	Work
ext/standard/fsockopen.php	New builtin — build tcp://host:port and delegate to existing stream socket helper
ext/standard/Module.php	Register
ext/standard/VmStreamSocketNative.php	Shared transport (#8954 pure path)
Tests	test/compliance/cases/stdlib/fsockopen_discard_port.phpt

Implement in ext/standard PHP; no new runtime/*.c socket table.

Done when

• function_exists('fsockopen') → true on VM
• Repro: false resource + populated $errno/$errstr on unreachable port
• $timeout float honored (subset matching Zend)
• Enum hostname/port operands TypeError per php-src-strict (add PHPT if coerce bug found)
• ./script/ci-fast.sh --filter fsockopen green

Related

• Stdlib: fsockopen() / stream_socket_client() — TCP/UDP sockets (streams parity) #3202 umbrella streams parity
• Stdlib: fsockopen() — procedural TCP wrapper missing while stream_socket_client partial (#3202) #8954 VmStreamSocketNative php-in-php migration
• Stdlib: pfsockopen() — persistent TCP socket streams (ext/standard/fsock.c parity) #3384 pfsockopen persistent sockets
• Web: FastCGI request loop adapter (nginx / php-fpm compatible) #173 FastCGI upstream

[PurHur]

claim: PHP Compiler STD Lib — starting this run

[PurHur]

Merged via #8984.

Verification:

php bin/vm.php test/repro/maintainer_gap_fsockopen.php
# array (0 => true, 1 => false, 2 => 111, 3 => 'Connection failed')

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter FsockopenBuiltinTest'
# OK (3 tests, 5 assertions)

php bin/compile.php -l test/repro/maintainer_gap_fsockopen.php
# compile-only OK

Implementation: ext/standard/fsockopen.php delegates to VmStreamSocketNative::client() via tcp:// URI (php-src ext/standard/fsock.c parity). No new C runtime.