Stdlib: imap_delete/undelete/expunge + ping/check/status missing when IMAP advertised (ext/imap/php_imap.stub.php)

[PurHur]

Category

enhancement · php-src-strict · IMAP surface · pillar 4

Problem

IMAP is advertised (extension_loaded(\"imap\"), imap_open/imap_close/imap_num_msg present), but core mailbox/message lifecycle APIs are missing: imap_delete, imap_undelete, imap_expunge, imap_ping, imap_check, imap_status.

Verified 2026-08-05 on tip 724a117bf. Sibling IMAP gaps already tracked: #27765 compose, #27764 mutf7, #27681 utf7, #27680 timeout, #27674 imap_is_open, #27683 MIME codecs.

Repro	php-src stub (8.3)	VM (IMAP on)
function_exists(\"imap_delete\")	true	false
function_exists(\"imap_undelete\")	true	false
function_exists(\"imap_expunge\")	true	false
function_exists(\"imap_ping\")	true	false
function_exists(\"imap_check\")	true	false
function_exists(\"imap_status\")	true	false

php-src reference

• php/php-src ext/imap/php_imap.stub.php — imap_delete / imap_undelete / imap_expunge / imap_ping / imap_check / imap_status
• php/php-src ext/imap/php_imap.c — matching PHP_FUNCTIONs

PHP implementation target

• ext/imap/ PHP helpers on VmImapConnection / mailbox engine (mark deleted, expunge, NOOP ping, check/status status objects)
• Register in ext/imap/Module.php; Reflection parity with stubs
• PHP-in-PHP; no new C runtime

Repro

./script/docker-exec.sh -- bash -lc '
cat > /tmp/imap_lifecycle.php <<'"'"'PHP'"'"'
<?php
echo "ext=", extension_loaded("imap") ? "Y" : "N", "\n";
foreach (["imap_delete","imap_undelete","imap_expunge","imap_ping","imap_check","imap_status"] as $f) {
  echo $f, "=", function_exists($f) ? "Y" : "N", "\n";
}
PHP
PHP_COMPILER_PROFILE=8.4 php bin/vm.php /tmp/imap_lifecycle.php
'

Done when

• All six function_exists true when IMAP advertised
• Minimal in-memory / mock-mbox behavior documented; Reflection matches stubs
• VM (+ JIT if in scope); php-src-strict

Gate context (2026-08-05)

• user_release_ready: no — helper-runtime-prelink + north-star5-fast red; inventory OK

[PurHur]

claim: PHP Compiler STD Lib Advanced — batch (issues #27799 → #27814 → #27783 → #27784 → #27800)

Queued after #27814 merge (delete/undelete/expunge + ping/check/status).

[PurHur]

Merged: #27871

Verification:

• PHP_COMPILER_ENABLE_IMAP=1 php bin/vm.php test/repro/issue_27783_imap_delete_status.php — six symbols + SA_ALL; delete/undelete/expunge/ping/check/status; closed → TypeError
• Compliance imap_delete_status.phpt FILE/EXPECT match
• inventory 7040/7040; spine sync OK (incl. ArrayWalkLlvm require); generated docs OK

Batch status (PHP Compiler STD Lib Advanced):

• ✅ Stdlib: imap_list/lsub/subscribe/unsubscribe + createmailbox/deletemailbox/renamemailbox/getmailboxes missing when IMAP advertised (ext/imap/php_imap.stub.php) #27799 merged (Stdlib: imap mailbox list/subscribe/create local-mbox surface (#27799) #27865) — mailbox list/subscribe/create
• ✅ Stdlib: imap_append/savebody/bodystruct/fetchmime missing when IMAP advertised (ext/imap/php_imap.stub.php) #27814 merged (Stdlib: imap_append/savebody/bodystruct/fetchmime local-mbox surface (#27814) #27870) — append/savebody/bodystruct/fetchmime
• ✅ Stdlib: imap_delete/undelete/expunge + ping/check/status missing when IMAP advertised (ext/imap/php_imap.stub.php) #27783 merged (Stdlib: imap_delete/undelete/expunge + ping/check/status (#27783) #27871) — delete/undelete/expunge + ping/check/status
• ⏳ Stdlib: imap_fetchstructure/fetchheader/fetch_overview/body/sort missing when IMAP advertised (ext/imap/php_imap.stub.php) #27784 next — fetchstructure/fetchheader/fetch_overview/body/sort
• ⏳ Stdlib: imap_setflag_full/clearflag_full + alerts/gc/thread/acl/headers/mailboxmsginfo missing when IMAP advertised (ext/imap/php_imap.stub.php) #27800 — flags/ACL/alerts/gc/thread/headers/mailboxmsginfo