PHP 8.6 Features: Partial Application, clamp(), Time\Duration & More

Release Timeline

PHP 8.6 is scheduled for general availability on November 19, 2026. The release cycle includes Alpha 1–3 (July 2–30, 2026), Beta 1 (soft feature freeze) on August 13, Beta 3 on September 10, feature freeze on September 22, RC1 on September 24, RC4 on November 5, and GA on November 19.

1. Partial Function Application (PFA)

Partial function application allows pre-filling some arguments of a function, returning a closure that accepts the remaining arguments. The ? placeholder represents a single pending argument, while ... represents all remaining arguments. Arguments provided during partial application are evaluated immediately at creation time, not when the closure is called. Each ? placeholder becomes a required parameter in the resulting closure, even if the original parameter was optional. The feature was previously rejected in 2021 but passed unanimously (33–0) in its v2 RFC.

$makeSlug = str_replace(' ', '-', ?);
$makeSlug('Hello World'); // Hello-World

$titles = array_map(strtolower(?), $titles);

2. Built-in clamp() Function

The new clamp() function constrains a value within a given range: if the value lies between $min and $max it is returned unchanged; otherwise the nearest boundary is returned. It supports all comparable types, including strings and DateTime objects. If $min > $max, a ValueError is thrown. This replaces the error-prone min(max($value, $min), $max) pattern.

clamp(10, min: 0, max: 100); // 10
clamp(101, min: 0, max: 100); // 100
clamp(-1, min: 0, max: 100); // 0

3. Time\Duration Class

PHP 8.6 introduces the final, read-only Time\Duration class for representing a time span with nanosecond precision. It provides factory methods for various units ( fromSeconds, fromMilliseconds, etc.), arithmetic operations ( add, divideBy, multiplyBy), and comparison operators. Durations can also be created from ISO 8601 duration strings. The class is designed as a standard type for core functions and the new polling API, replacing loose integer or float duration parameters.

use Time\Duration;

$oneSecond = Duration::fromSeconds(1);
$halfSecond = $oneSecond->divideBy(2);
$total = $oneSecond->add($halfSecond);
$delay = Duration::fromMilliseconds(100)->multiplyBy(2 ** $attempt);

$total > $delay; // comparison operators work directly

4. Readonly Properties with Default Values

Readonly properties can now declare default values. Previously this caused a compile error, making it awkward to implement read-only interface properties with fixed values (e.g., migration class names). The readonly semantics remain unchanged: the property cannot be reassigned after initialization.

final readonly class CreateBooksTable implements Migration {
    public string $name = '2026_01_01_create_books_table';
}

5. Inline Parameter Doc Comments

Documentation comments can now be placed directly above individual function parameters. These comments are retrievable via ReflectionParameter::getDocComment(), eliminating the need to repeat parameter names in a function-level @param tag. Static analysis tools and IDEs can read the parameter-specific comments directly.

function search(
    /** Keyword to retrieve from database */
    string $query,
    /** Maximum number of results to return */
    int $limit = 10
): array {
    // ...
}

6. Unified Polling API (Io\Poll)

The new Io\Poll namespace provides a cross-platform IO polling abstraction: epoll on Linux, kqueue on BSD/macOS, event ports on Solaris, and WSAPoll on Windows. It is intended to replace the legacy stream_select() for developers building event loops or async runtimes. The RFC notes the primary driver is internal optimization (signal handling, FPM performance), with user-space async frameworks as secondary beneficiaries.

use Io\Poll\{Context, Event, StreamPollHandle};

$poll = new Context();
$server = stream_socket_server('tcp://0.0.0.0:8080');
stream_set_blocking($server, false);

$poll->add(
    new StreamPollHandle($server),
    [Event::Read],
    ['type' => 'server']
);

while (true) {
    foreach ($poll->wait(1) as $watcher) {
        if ($watcher->hasTriggered(Event::Read)) {
            // handle new connection
        }
    }
}

7. SortDirection Enum

A global SortDirection enum with two cases — Ascending and Descending — is introduced. Core functions have not yet adopted it; the goal is to provide a standard type so libraries (e.g., query builders) avoid redefining their own direction enums.

$query->orderBy('created_at', SortDirection::Descending);

8. Enum __debugInfo() Magic Method

Enums, which were introduced in PHP 8.1, were restricted from defining most magic methods. PHP 8.6 lifts the restriction on __debugInfo(), allowing customization of var_dump() output for enum cases. Since the method does not rely on instance state, it is safe to implement.

enum Status: int {
    case Ok = 200;

    public function __debugInfo(): array {
        return [__CLASS__ . '::' . $this->name . ' = ' . $this->value];
    }
}

9. Unified Stream Error Handling

Stream operations gain a unified error model. A new error_mode context option switches between three modes: default warnings, throwing exceptions, or silent ignore. The function stream_last_errors() returns a structured StreamError object for the last operation. The StreamErrorCode enum defines over 50 semantic error codes.

$context = stream_context_create([
    'stream' => [
        'error_mode' => StreamErrorMode::Exception
    ]
]);

try {
    $stream = fopen('/nonexistent/file.txt', 'r', false, $context);
} catch (StreamException $e) {
    foreach ($e->getErrors() as $error) {
        echo $error->code->name . ': ' . $error->message;
    }
}

10. URI Extension Enhancements

The URI extension (introduced in PHP 8.5) receives a builder class ( Uri\Rfc3986\UriBuilder) that assembles a complete URI without creating intermediate objects for each component. Additional methods getUriType() and getHostType() are added, along with percent-encoding functions for individual URI components.

$uri = new Uri\Rfc3986\UriBuilder()
    ->setScheme('https')
    ->setHost('example.com')
    ->setPath('/foo/bar')
    ->build();

11. Session Security Default Upgrades

For fresh PHP installations, three session-related php.ini defaults are tightened: session.use_strict_mode: 0 → 1 session.cookie_httponly: 0 → 1 session.cookie_samesite: unset →

Lax