Stdlib: DatePeriod OOP — date range iteration (ext/date/php_date.c parity)

[PurHur]

Category

stdlib

Problem

DatePeriod is a core ext/date class for iterating date ranges (new DatePeriod($start, $interval, $end)). It is not registered — class_exists('DatePeriod') is false under bin/vm.php. Calendar/scheduling code and Symfony-style date utilities depend on it.

Follow-up to #3072 / #3162 (DateTime / DateInterval); DatePeriod requires both plus range iteration semantics.

php-src reference

• php/php-src ext/date/php_date.c — php_date_initialize, DatePeriod class registration
• php/php-src ext/date/lib/period.c — period iteration / boundary rules
• php/php-src ext/date/lib/timelib.h — timelib period helpers

Repro (failure today)

<?php
$start = new DateTime('2024-01-01');
$end   = new DateTime('2024-01-04');
$step  = new DateInterval('P1D');
foreach (new DatePeriod($start, $step, $end) as $dt) {
    echo $dt->format('Y-m-d'), "\n";
}

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php bin/vm.php repro.php'
# class DatePeriod not found (after #3072 DateTime exists)

./script/docker-exec.sh -- bash -lc 'source script/php-env.sh && php repro.php'
# Zend:
# 2024-01-01
# 2024-01-02
# 2024-01-03

Scope (this repo)

Module	Path
VM OOP	ext/standard/VmDate.php or new ext/date/ module — DatePeriod + Iterator
Prerequisite	#3072 DateTime, #3162 DateInterval
Foreach	#3234 Traversable/Iterator foreach if object iteration not generic yet
Registration	ext/standard/Module.php or dedicated date module
Tests	test/compliance/cases/stdlib/date_period.phpt
Matrix	docs/capabilities-syntax.md DateTime row extension

Done when

• Repro prints three dates on VM matching Zend (exclusive end boundary per php-src)
• DatePeriod implements Iterator / Traversable; foreach works
• Recurrence count form new DatePeriod($start, $interval, $recurrences) matches Zend
• ./script/ci-fast.sh --filter date_period green

Related

• Stdlib: strtotime() / mktime() / checkdate() / date_default_timezone_* — procedural date parsing (ext/date parity) #3292 — procedural strtotime/mktime (orthogonal)
• Stdlib: timezone_identifiers_list() and date timezone introspection (ext/date parity) #3504 — timezone introspection