HN 日本語サマリー

← 一覧へ戻る
プログラミング

PHP 8.6の新機能

What's New in PHP 8.6 (php.net)

281 pointsby netol128 コメント

要約

PHP 8.6は、部分関数適用、新しい`\Time\Duration`クラス、ポーリングAPI、`clamp()`関数などの新機能を含むメジャーアップデートです。このバージョンは2026年11月19日にリリース予定で、コードの表現力、型の堅牢性、スケーラブルなI/Oの強化を目指しています。また、`SortDirection` enum、読み取り専用プロパティのデフォルト値、ストリームエラーハンドリングの改善なども含まれます。

全文翻訳

PHP 8.6の新機能

2026年11月19日リリース予定

より高速に、より安全に、よりパワフルに。

PHP 8.6はPHP言語のメジャーアップデートであり、部分関数適用、新しいDurationクラス、ポーリングAPI、新しいclamp()関数などの新機能が含まれています。

PHP 8.6はまだリリースされていません。2026年11月19日にリリースされる予定です。

PHP 8.6の主な機能

より表現力豊かなコード、より強力な型、そしてスケーラブルなI/O。

部分関数適用

関数の引数の一部を事前に指定し、残りの引数を受け付けるClosureを返すことができます。

新しい\Time\Durationクラス

Durationクラスはストップウォッチで測定された経過時間を表します。

ポーリングAPI

epoll、kqueueなどのネイティブメカニズムを使用したスケーラブルなI/O多重化で、ReactPHPやAMPHPのようなイベントループライブラリで利用可能です。

新しいclamp()関数

指定された値(数値またはその他)が指定された範囲内に収まるようにします。

新しいSortDirection enum

ライブラリ間で共有できる、ソート順序を表現するための標準的で型安全な方法です。

読み取り専用プロパティのデフォルト値

読み取り専用プロパティがデフォルト値を宣言できるようになり、固定値のコンストラクタでの代入が不要になります。

部分関数適用

関数の引数の一部を事前に指定し、残りの引数を受け付けるClosureを返すことができます。?と...プレースホルダーを使用して残りの引数を表します。結果として得られるClosureに関数が残りの引数を渡して初めて関数が呼び出されます。

$versions = ['8.4', '8.5', '8.6', '8.7', '9.0'];

$supportsPfa = array_filter(
    $versions,
    fn ($version) => version_compare($version, '8.6', '>='),
);
$versions = ['8.4', '8.5', '8.6', '8.7', '9.0'];

$supportsPfa = array_filter(
    $versions,
    version_compare(?, '8.6', '>='),
);

新しい\Time\Durationクラス

Durationクラスはストップウォッチで測定された経過時間を表します。その表現は時間やタイムゾーンに依存せず、ナノ秒精度で250年以上の範囲を表現できます。これにより、タイムアウトやベンチマーク時間を表現するのに適しています。

/**
 * すべての遅延はマイクロ秒単位です。
 */
function backoff(
    int $baseDelay,
    int $step,
    int $attempt,
): void {
    $delay = $baseDelay + ($step * (2 ** $attempt));

    // 最大30秒まで待機。
    usleep(min($delay, 30_000_000));
}

// ベース遅延1秒、プラス100ミリ秒
// 試行ごとに倍増。
backoff(1_000_000, 100_000, $attempt);
use Time\Duration;

function backoff(
    Duration $baseDelay,
    Duration $step,
    int $attempt,
): void {
    $delay = $baseDelay->add($step->multiplyBy(2 ** $attempt));

    // Durationは比較可能なので、min()が直接機能します。
    $delay = min($delay, Duration::fromSeconds(30));

    time_nanosleep($delay->seconds, $delay->nanoseconds);
}

backoff(
    Duration::fromSeconds(1),
    Duration::fromMilliseconds(100),
    $attempt,
);

// 部分関数適用を使用して遅延を事前設定します。
$waitBeforeRetry = backoff(
    Duration::fromSeconds(1),
    Duration::fromMilliseconds(100),
    attempt: ?,
);
$waitBeforeRetry($attempt);

ポーリングAPI

新しいIo\Poll APIは、各プラットフォームで利用可能な最良のメカニズム(epoll、kqueue、event ports、またはWSAPoll)を使用して多数のストリームを効率的に監視します。これはstream_select()の拡張性の限界を超え、ReactPHPやAMPHPのようなイベントループライブラリが構築できる共通の基盤として設計されています。

$server = stream_socket_server('tcp://0.0.0.0:8080');
$clients = [];

while (true) {
    $read = [$server, ...$clients];
    $write = $except = null;

    // select()に基づいており、通常は1024接続以上を処理できません。
    stream_select($read, $write, $except, null);

    foreach ($read as $stream) {
        if ($stream === $server) {
            $clients[] = stream_socket_accept($server);
            continue;
        }

        $data = fread($stream, 8192);

        if ($data === '' || $data === false) {
            $key = array_search($stream, $clients, true);
            unset($clients[$key]);
            fclose($stream);
        } else {
            fwrite($stream, $data);
        }
    }
}
use Io\Poll\{Context, Event};

$server = stream_socket_server('tcp://0.0.0.0:8080');

// epoll、kqueue、event ports、またはWSAPollを自動的に使用します。
$poll = new Context();
$poll->add(new StreamPollHandle($server), [Event::Read]);

while (true) {
    foreach ($poll->wait() as $watcher) {
        $stream = $watcher->getHandle()->getStream();

        if ($stream === $server) {
            $client = stream_socket_accept($server);
            $poll->add(
                new StreamPollHandle($client),
                [Event::Read],
            );
            continue;
        }

        $data = fread($stream, 8192);

        if ($data === '' || $data === false) {
            $watcher->remove();
            fclose($stream);
        } else {
            fwrite($stream, $data);
        }
    }
}

ストリームエラーハンドリング

ストリーム操作は、警告を発する代わりに、StreamExceptionをスローするか、サイレントに失敗するように設定できるようになりました。エラーは構造化されたStreamErrorオブジェクトとして報告され、StreamErrorCode enumケース、ラッパー名、および影響を受けるパスまたはURLが含まれます。また、stream_last_errors()で後で取得したり、カスタムエラーハンドラに渡したりすることもできます。

$config = @file_get_contents('/etc/app/config.json');

if ($config === false) {
    // 非構造化メッセージ文字列のみが利用可能です。
    $error = error_get_last();
    log_error($error['message']);
}
$context = stream_context_create([
    'stream' => [
        'error_mode' => StreamErrorMode::Exception,
    ],
]);

try {
    $config = file_get_contents(
        '/etc/app/config.json',
        context: $context,
    );
} catch (StreamException $e) {
    foreach ($e->getErrors() as $error) {
        // $error->code は StreamErrorCode enum ケースです。
        log_error(
            $error->code->name,
            $error->message,
            $error->wrapperName,
        );
    }
}

新しいclamp()関数

指定された値(数値またはその他)が指定された範囲内に収まるようにします。そうでない場合は、最も近い境界値が返されます。

var_dump(max(0, min(-10, 100)));
// int(0)

var_dump(max(0, min(50, 100)));
// int(50)

var_dump(max(0, min(110, 100)));
// int(100)
var_dump(clamp(-10, 0, 100));
// int(0)

var_dump(clamp(50, 0, 100));
// int(50)

var_dump(clamp(110, 0, 100));
// int(100)

// clamp()は比較可能な任意の値を扱えます。これには新しいDurationクラスも含まれます。
var_dump(
    clamp(
        \Time\Duration::fromSeconds(30),
        min: \Time\Duration::fromMinutes(1),
        max: \Time\Duration::fromMinutes(10),
    )->seconds
);
// int(60)

新しいSortDirection enum

SortDirection enumは、AscendingとDescendingケースを持つソート順序を表現するための、共有可能で型安全な方法を提供します。以前は、各ライブラリが独自のソート順序表現を定義する必要があり、互換性のない整数、文字列、ブール値、カスタムenumの混在が生じていました。SortDirectionはPHPに組み込まれているため、ライブラリはアダプターコードなしで公開APIでこれを受け入れることができます。

この機能の詳細については、The PHP Foundationのブログをご覧ください。

class QueryBuilder
{
    private array $orderBy = [];

    public function orderBy(
        string $column,
        int $direction = SORT_ASC,
    ): static {
        $this->orderBy[] = $column . ' ' . match ($direction) {
            SORT_ASC => 'ASC',
            SORT_DESC => 'DESC',
        };

        return $this;
    }
}

$qb->orderBy('name', SORT_DESC);
$qb->orderBy('name', SORT_STRING);
// シグネチャには受け入れられるが、メソッド内で失敗する:
// UnhandledMatchError: Unhandled match case 2
class QueryBuilder
{
    private array $orderBy = [];

    public function orderBy(
        string $column,
        SortDirection $direction = SortDirection::Ascending,
    ): static {
        $this->orderBy[] = $column . ' ' . match ($direction) {
            SortDirection::Ascending => 'ASC',
            SortDirection::Descending => 'DESC',
        };

        return $this;
    }
}

$qb->orderBy('name', SortDirection::Descending);
$qb->orderBy('name', SORT_STRING);
// TypeError: QueryBuilder::orderBy(): Argument #2 ($direction) must be of type SortDirection, int given

関数およびメソッドのパラメータは、独自のDocCommentを持つことができるようになり、新しいReflectionParameter::getDocComment()メソッドからアクセスできるようになりました。これにより、各パラメータは@paramタグで名前と型を繰り返すことなく、宣言のすぐ隣でドキュメント化できます。

class DB
{
    /**
     * $query に一致する項目を最大 $limit 件返します。
     *
     * @param string $query 検索する用語
     * @param int $limit 結果の最大数
     */
    public function search(string $query, int $limit = 10): array
    {
        return [];
    }
}

// パラメータの説明は、関数のDocCommentを解析することによってのみ抽出できます。
class DB
{
    /**
     * $query に一致する項目を最大 $limit 件返します。
     */
    public function search(
        /** 検索する用語 */
        string $query,

        /** 結果の最大数 */
        int $limit = 10,
    ): array {
        return [];
    }
}

var_dump(
    new ReflectionParameter([DB::class, 'search'], 'query')
        ->getDocComment(),
);
// string(22) "/** 検索する用語 */"

新しいReflectionProperty::isReadable()およびReflectionProperty::isWritable()メソッド

読み取り専用プロパティ、非対称な可視性、プロパティフックにより、プロパティがpublicであるかどうかをチェックするだけでは、それが読み取り可能か書き込み可能かを知るには不十分になりました。新しいメソッドは、可視性、初期化状態、フック、およびマジックメソッドを考慮して、指定されたスコープに対して、オプションで特定のオブジェクトに対して直接回答します。

class NewsEntry
{
    public string $title = 'PHP 8.6 released!';

    public private(set) string $slug = 'php-86-released';
}

$entry = new NewsEntry();
foreach (['title', 'slug'] as $item) {
    $property = new ReflectionProperty(NewsEntry::class, $item);
    printf(
        "%s: isReadable=%s isWritable=%s\n",
        $item,
        $property->isReadable(null, $entry) ? 'yes' : 'no',
        $property->isWritable(null, $entry) ? 'yes' : 'no',
    );
}
// title: isReadable=yes isWritable=yes
// slug: isReadable=yes isWritable=no

読み取り専用プロパティのデフォルト値

インスタンスの読み取り専用プロパティ(読み取り専用クラスのプロパティを含む)は、デフォルト値を宣言できるようになりました。これにより、固定値を持つget-onlyインターフェイスプロパティを簡単に実装できます。以前はコンストラクタで代入する必要がありました。デフォルト値はプロパティの初期化と見なされるため、コンストラクタで上書きすることはできません。

interface Rule
{
    public string $parser { get; }
}

final readonly class SlugRule implements Rule
{
    public string $parser;

    public function __construct()
    {
        $this->parser = SlugParser::class;
    }
}
interface Rule
{
    public string $parser { get; }
}

final readonly class SlugRule implements Rule
{
    public string $parser = SlugParser::class;
}

その他の機能と改善点

  • #[\]Override属性をクラス定数およびenumケースに適用できるようになりました。
  • enumは__debugInfo()マジックメソッドを実装できるようになりました。
  • 定数に格納されているオブジェクトのプロパティは直接変更できるようになりました。例: Config::DEFAULTS->timeout = 30。
  • 新しいUri\Rfc3986\UriBuilderおよびUri\WhatWg\UrlBuilderクラスは、コンポーネントからURIを構築します。また、URIおよびホストタイプの検出用の新しいメソッドと、Uri\WhatWg\url_percent_encode()関数も追加されました。
  • Sodium拡張機能は、ポスト量子暗号化(X-WingおよびML-KEM-768)、IPアドレス暗号化、およびSHAKEとTurboSHAKEの拡張可能な出力関数を追加しました。
  • TLSストリームは、セッション再開、外部事前共有キー、およびTLS 1.3早期データ(0-RTT)をサポートするようになりました。
  • 新しいmysqli::quote_string()メソッドは、文字列をエスケープし、引用符で囲みます。これはPDO::quote()に相当します。
  • pack()およびunpack()は、整数および浮動小数点フォーマットコードで<および>エンディアンモディファイアを受け入れるようになりました。
  • JSONエラーメッセージには、入力中のエラーの場所が含まれるようになりました。
  • 新しいerror_include_args INI設定は、エラーメッセージに関数引数を一貫して含めるようになりました。
  • 新しいgrapheme_strrev()関数は、グラフェムクラスターごとに文字列を反転させ、新しいIntlNumberRangeFormatterクラスは数値の範囲をフォーマットします。
  • 新しいZipArchive::openString()およびZipArchive::closeString()メソッドは、インメモリアーカイブを扱います。
  • パフォーマンスの改善には、array_map()をファーストクラスのコール可能または部分適用コールバックでループにコンパイルすること、printf()呼び出しの高速化、ステートレスなクロージャのキャッシュ、およびJSONエンコーディングの高速化が含まれます。

非推奨と後方互換性のブレーク

  • finallyブロック内でのreturnの使用は、例外をサイレントに破棄し、tryまたはcatchブロックから返された値を上書きするため、非推奨になりました。
  • __construct()または__destruct()からの値の返却、およびそれらをジェネレータにすること(__construct / __destructがジェネレータであること)は非推奨になりました。__debugInfo()のnull許容戻り値型の宣言も非推奨です。
  • letまたはisをクラス、関数、または定数の名前として使用することは非推奨になりました。定数名として_、クラス定数名としてnamespace、関数名としてreadonlyを使用することも非推奨です。
  • mbstringの正規表現関数(mb_ereg()やmb_split()など)は、基盤となるOnigurumaライブラリがメンテナンスされなくなったため、非推奨になりました。uモディファイアを持つPCRE関数を代わりに利用できます。
  • is_double()、is_long()、is_integer()、およびdoubleval()のエイリアスは非推奨になりました。代わりにis_float()、is_int()、およびfloatval()を使用してください。
  • spl_object_hash()はspl_object_id()に置き換えるために非推奨になり、spl_classes()はReflectionExtension::getClassNames()に置き換えるために非推奨になりました。
  • 配列が期待される場所にオブジェクトをarray_walk()、array_walk_recursive()、http_build_query()、mb_convert_variables()、および圧縮関数やフィルタに渡すことは非推奨になりました。最初にオブジェクトを変換するにはget_object_vars()を使用してください。
  • strcoll()およびSORT_LOCALE_STRINGソートフラグは非推奨になりました。代わりにintl拡張機能のCollatorクラスを使用してください。
  • define()に3番目の引数を渡すこと、および$allow_stringがfalseの場合にクラス名文字列でis_a()またはis_subclass_of()を呼び出すことは非推奨になりました。
  • filter.max_filter_countコンテキストオプションを設定せずにphp://filter URLで16を超えるフィルタを使用することは非推奨になりました。
  • セッションはデフォルトでより安全になりました: session.use_strict_modeおよびsession.cookie_httponlyが有効になり、session.cookie_samesiteはLaxに設定されました。
  • create_sid()とvalidateId()の両方を実装しないカスタムセッションハンドラは非推奨になりました。
  • metaphone()、mysqli_get_charset()、およびmysqli_stmt_init()関数は、SplFileObjectのCSVメソッド、およびArrayIteratorのソート、フラグ、シリアライズメソッドと共に非推奨になりました。
  • trim()、ltrim()、およびrtrim()は、デフォルトでフォームフィード( )文字も削除するようになりました。
  • fclose()、file_put_contents()、およびcopy()は、ストリームのフラッシュまたはクローズが失敗した場合、失敗をサイレントに無視するのではなく、falseを返すようになりました。
  • 多くの関数は、範囲外の値、無効なフラグ、またはNULバイトを含む文字列に対して、サイレントに切り捨てたり無視したりするのではなく、ValueErrorをスローするようになりました。