Stdlib: stream_metadata() — stream wrapper metadata callback missing (ext/standard/streamsfuncs.c)

[PurHur]

Category

stdlib

Problem

stream_metadata() is missing. Zend uses it internally and exposes it for custom stream wrappers to handle touch/chmod/chown/chgrp/access metadata operations on stream resources.

function_exists('stream_metadata') is false on bin/vm.php; Zend returns true.

php-src reference

• php/php-src ext/standard/streamsfuncs.c — PHP_FUNCTION(stream_metadata)
• php/php-src ext/standard/basic_functions.stub.php

Repro (failure today)

php bin/vm.php test/repro/maintainer_stream_metadata_missing.php
# stream_metadata: no

Scope (this repo)

Layer	Path
ext/standard	stream_metadata.php + VM hook into wrapper ops table
VM	Dispatch STREAM_META_* codes to registered wrapper; php-src-strict operand checks
Tests	test/compliance/cases/stdlib/stream_metadata.phpt

Pair with #3448 (stream context helpers) and wrapper registration issues.

Done when

• function_exists('stream_metadata') true on VM
• Non-resource first arg → TypeError like Zend
• Known STREAM_META_* codes forwarded to wrapper callback
• Targeted compliance filter green

Related

• Stdlib: stream_context_set_option / get_options / get_params / set_default (ext/standard/streams.c parity) #3448 — stream_context_set_option/get_options

[PurHur]

claim: cursor-agent-lane-b — starting this run

[PurHur]

Merged via #16636

Fix: touch() / chmod() / chown() / chgrp() on custom protocol URLs now dispatch the wrapper's stream_metadata() callback (VmStreamWrapperMetadata) instead of failing against the host filesystem.

Verification:

php bin/vm.php test/repro/maintainer_stream_metadata_touch_chmod.php  # ok
php bin/vm.php test/compliance/cases/stdlib/stream_wrapper_metadata.phpt  # 4× true
php script/bootstrap-inventory.php --check  # OK 4083/4083

Note: Zend 8.2 does not expose a global stream_metadata() function — parity is via wrapper callback dispatch on metadata file ops (php-src filestat.c).