Stdlib: imap_timeout() + IMAP_*TIMEOUT constants missing when IMAP advertised (ext/imap/php_imap.stub.php)

[PurHur]

Category

stdlib · php-src-strict · IMAP side-load / PROFILE≥8.4 (or PHP_COMPILER_ENABLE_IMAP=1)

Problem

When IMAP is advertised (extension_loaded('imap') true under PHP_COMPILER_PROFILE=8.4+, or with PHP_COMPILER_ENABLE_IMAP=1), imap_open / imap_close / … register, but imap_timeout() and the IMAP_OPENTIMEOUT / IMAP_READTIMEOUT / IMAP_WRITETIMEOUT / IMAP_CLOSETIMEOUT constants are absent. php-src ships imap_timeout(int $timeout_type, int $timeout = -1): int|bool for get/set of c-client timeouts. ext/imap/Module.php only lists eight procedural APIs.

Repro	Zend 8.3+ (ext/imap)	VM (2026-08-04, IMAP advertised)
function_exists('imap_timeout')	true	false
defined('IMAP_OPENTIMEOUT') (and READ/WRITE/CLOSE)	true	false
imap_timeout(IMAP_OPENTIMEOUT)	int (current)	Error: Call to undefined function

php-src reference

• php/php-src ext/imap/php_imap.stub.php — imap_timeout, IMAP_*TIMEOUT
• php/php-src ext/imap/php_imap.c — PHP_FUNCTION(imap_timeout)

Note: core php-src unbundled imap after 8.3; PHP-8.3 / PECL stub remains the reference for in-tree ext/imap. Sibling gap: #27674 (imap_is_open).

PHP implementation target

• ext/imap/imap_timeout.php — new Internal (process-wide timeout table is fine for v1 local-mbox)
• ext/imap/Module.php — register + define IMAP_*TIMEOUT when ImapExtensionPolicy::advertisesBuiltins()
• Prefer PHP-in-PHP; JIT may stay VM-only like other imap_* v1 helpers

Repro

./script/docker-exec.sh -- bash -lc 'PHP_COMPILER_ENABLE_IMAP=1 PHP_COMPILER_PROFILE=8.3 php bin/vm.php -r "
echo function_exists(\"imap_timeout\") ? \"Y\" : \"N\", PHP_EOL;
echo defined(\"IMAP_OPENTIMEOUT\") ? \"Y\" : \"N\", PHP_EOL;
"'

Done when

• function_exists('imap_timeout') and IMAP_*TIMEOUT defined when IMAP advertised
• Get/set semantics match php-src for the four timeout types (including $timeout = -1 get)
• Compliance .phpt under test/compliance/cases/ with IMAP enabled
• php-src-strict; no php-compiler-strict shortcut

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #27821, #27680, #27674, #27682, #27683). Starting with #27821; will ship sequential PRs and merge each before next.

[PurHur]

claim: PHP Compiler STD Lib Advanced — starting #27680 now (batch #27821 abandoned as invalid, then #27680 → #27674 → #27682 → #27683).

[PurHur]

merged: PHP Compiler STD Lib Advanced — #27680 via #28114

Verification

• PHP_COMPILER_ENABLE_IMAP=1 PHP_COMPILER_PROFILE=8.3 php bin/vm.php test/repro/imap_timeout_27680.php → Y/Y, constants 1–4, get/set 60→true→42, Reflection int|bool / default -1
• PHPT stdlib/imap_timeout.phpt EXPECT match
• inventory --check OK 7122/7122; spine coverage OK; generated docs in sync

Next in batch: #27674 (imap_is_open).