Stdlib: FTP\\Connection object — PHP 8.4 ext/ftp resource→object missing (ftp.stub.php, pairs #3353)

[PurHur]

Category

stdlib

Problem

PHP 8.4 replaced ext/ftp connection resources with the FTP\Connection object (ext/ftp/ftp.stub.php). #3353 tracks ftp_connect/login handlers, but the compiler must register the FTP\Connection internal class before handlers return Zend-compatible values (instanceof FTP\Connection, not resource).

Verified 2026-06-07:

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php -r "
echo class_exists(\"FTP\\\\Connection\", false) ? \"yes\" : \"no\", PHP_EOL;
echo function_exists(\"ftp_connect\") ? \"yes\" : \"no\", PHP_EOL;
"'
# no / no

php-src reference

• php/php-src ext/ftp/ftp.stub.php — class Connection in namespace FTP
• php/php-src ext/ftp/php_ftp.c — connection object allocation, ftp_connect

Repro (failure today)

<?php
var_export(class_exists('FTP\\Connection', false));
echo "\n";

Runtime	FTP\Connection class
Zend PHP 8.4+	true (final internal)
bin/vm.php	false

Scope (this repo)

Path	Work
ext/ftp/BuiltinClasses.php (new)	Register FTP\Connection internal class
ext/ftp/Module.php	Module skeleton (phase 0) even before libc handlers
#3353	ftp_connect() returns FTP\Connection object
Tests	test/unit/FtpConnectionClassTest.php

PHP-in-PHP: connection object stores socket state in PHP; thin socket FFI only.

Done when

• class_exists('FTP\\Connection') true on VM
• ftp_connect() (when Stdlib: ext/ftp — ftp_connect/login/get/put (ext/ftp parity) #3353 lands) returns FTP\Connection, not resource
• get_debug_type($conn) is FTP\Connection

Verification

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && vendor/bin/phpunit --filter FtpConnectionClass'

Related

• Stdlib: ext/ftp — ftp_connect/login/get/put (ext/ftp parity) #3353 ftp API · Stdlib: Resource builtin class — PHP 8.4 resource object model missing (Zend/zend_types.h) #7071 Resource model · Epic: Self-host critical path — compiler compiles itself (M3→M5) #1492

[PurHur]

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

[PurHur]

Merged via #16656.

Verification: With PHP_COMPILER_PROFILE=8.4, class_exists('FTP\\Connection', false) is true and ReflectionClass::getName() returns FTP\Connection. Repro maintainer_gap_ftp_connection_class.php prints ok. ./script/ci-fast.sh green.