2026.11.20

【2026年11月】PHP 8.6の新機能と上げるときの注意|部分適用・Duration・clamp()とセッションの既定の変更

はじめに

2026 年 11 月 19 日、PHP 8.6 が公開されました。毎年 11 月に出る、1 年に 1 回の新しい版です。関数の引数の一部を先に決めておける「部分適用」、時間の長さを表す Duration クラス、値を範囲に収める clamp() 関数など、日々のコードを短くする機能が入りました。

この記事では、主な新機能を PHP 8.5 までの書き方と比べて紹介し、上げるときに気をつけたい変更と、手元での試し方をまとめました。コードの例は、php.net の公式の発表の例をもとに短くしたものです。

サポートの期間

バージョン公開通常のサポートセキュリティの修正
8.62026 年 11 月 19 日2028 年 12 月 31 日まで2030 年 12 月 31 日まで
8.52025 年 11 月2027 年 12 月 31 日まで2029 年 12 月 31 日まで
8.42024 年 11 月2026 年 12 月 31 日まで2028 年 12 月 31 日まで
8.32023 年 11 月終了2027 年 12 月 31 日まで
8.22022 年 12 月終了2026 年 12 月 31 日まで

8.6 は、2030 年末までセキュリティの修正が出ます。ただ、出たばかりの版は、フレームワークやライブラリの対応が追いついていないことがよくあります。本番を今すぐ 8.6 にする必要はありません。サポートが年末で終わる 8.2 などを使っているなら、まず 8.4・8.5 に上げるのが先です(PHP 8.2 のサポート終了と 8.4・8.5 への上げ方)。

主な新機能

関数の部分適用

関数を呼ぶときに、引数の一部を ? にしておくと、残りの引数を受け取るクロージャが返ってきます。array_filter() などに渡すために、fn で包む必要がなくなります。

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

// 8.5 まで
$new = array_filter($versions, fn ($v) => version_compare($v, '8.6', '>='));

// 8.6 から(? のところに、配列の要素が入る)
$new = array_filter($versions, version_compare(?, '8.6', '>='));

? は 1 つの引数、... は残りの引数ぜんぶを表します。名前付き引数と組み合わせて、backoff($base, $step, attempt: ?) のようにも書けます。

時間の長さを表す \Time\Duration

「1 秒」「100 ミリ秒」のような時間の長さを表すクラスです。これまでは整数で持つしかなく、マイクロ秒なのかミリ秒なのか、コメントで断るしかありませんでした。Duration はナノ秒の精度で、足し算や比べることができます。

PHP
use Time\Duration;

// 8.5 まで:単位はコメントで断るしかない
usleep(min($delayMicroseconds, 30_000_000)); // 最大 30 秒

// 8.6 から
$delay = Duration::fromSeconds(1)->add(Duration::fromMilliseconds(100));
$delay = min($delay, Duration::fromSeconds(30)); // 比べられるので min() が使える
time_nanosleep($delay->seconds, $delay->nanoseconds);

値を範囲に収める clamp()

値が下限より小さければ下限を、上限より大きければ上限を返します。max(0, min($x, 100)) のような書き方が要らなくなります。数値でなくても、比べられる値なら使えます(Duration も使えます)。

PHP
// 8.5 まで
$volume = max(0, min($input, 100));

// 8.6 から
$volume = clamp($input, 0, 100);
var_dump(clamp(110, 0, 100)); // int(100)

並べる向きを表す SortDirection

昇順・降順を表す列挙型 SortDirection(Ascending・Descending)が、PHP に組み込まれました。これまではライブラリごとに SORT_ASC(整数)、'asc'(文字列)、真偽値など、ばらばらの表し方をしていました。型で受け取れるので、間違った値を渡すとすぐにエラーになります。

PHP
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(8.5 までは、メソッドの中で初めて失敗していた)

readonly プロパティにデフォルト値

readonly プロパティに、宣言のところで値を書けるようになりました。決まった値を入れるためだけに、コンストラクタを書く必要がなくなります。

PHP
// 8.5 まで
final readonly class SlugRule implements Rule
{
    public string $parser;

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

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

ストリームのエラーを例外で受け取る

file_get_contents() などのファイルやネットワークの操作で、失敗したときに警告ではなく例外(StreamException)を投げるように設定できるようになりました。これまでは @ で警告を消して、error_get_last() のメッセージの文字列を読むしかありませんでした。

PHP
$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 の列挙型
        log_error($error->code->name, $error->message);
    }
}

たくさんの接続を待つ Polling API

新しい Io\Poll は、Linux の epoll など、OS ごとにいちばん効率のよいしくみで、たくさんのストリームを同時に待ちます。stream_select() はふつう 1024 本くらいまでしか扱えませんでした。自分で直接使うより、ReactPHP や AMPHP などのライブラリが土台に使うためのものです。

そのほか

  • 関数の引数ごとに DocComment(/** ... */)を書けるようになり、ReflectionParameter::getDocComment() で読める
  • ReflectionProperty::isReadable()・isWritable() で、プロパティを読み書きできるかを、readonly や非対称の可視性も考えて調べられる
  • #[\Override] 属性を、クラス定数と列挙型の case にも付けられる
  • 定数に入れたオブジェクトのプロパティを、Config::DEFAULTS->timeout = 30 のように直接変えられる
  • URI を部品から組み立てる Uri\Rfc3986\UriBuilder・Uri\WhatWg\UrlBuilder
  • Sodium に、量子コンピューターでも破られにくい鍵の交換(X-Wing・ML-KEM-768)などが入った
  • TLS のストリームが、セッションの再開や TLS 1.3 の 0-RTT に対応
  • mysqli::quote_string()(PDO::quote() と同じく、エスケープして引用符で囲む)
  • JSON のエラーメッセージに、エラーの位置が入るようになった
  • array_map() にクロージャを渡したときの処理や、printf()、JSON のエンコードが速くなった

上げるときに気をつけること

セッションの既定の設定が変わる

いちばん影響が出やすいのが、セッションの既定の設定です。php.ini で自分で設定していない項目は、8.6 にすると次のように変わります。

設定8.5 まで8.6 から何が変わるか
session.use_strict_mode01サーバーが発行していないセッション ID を受け付けない(セッション固定攻撃を防ぐ)
session.cookie_httponlyオフオンJavaScript からセッションの Cookie を読めない
session.cookie_samesite(空)Laxほかのサイトからの POST などに、セッションの Cookie が付かない
  • どれも安全になる方向の変更で、ふつうのログインの画面は、そのまま動くことがほとんどです
  • ほかのドメインから POST で戻ってくるしくみ(外部の決済やログインのサービスから、POST でサイトに戻るものなど)は、SameSite=Lax だとセッションの Cookie が付かず、ログインが切れたように見えることがあります。検証の環境で必ず試します
  • JavaScript でセッションの Cookie を読んでいるコードは、読めなくなります
  • 自作のセッションハンドラで、create_sid() と validateId() の両方を実装していないものは、非推奨になりました

動きが変わる関数

  • trim()・ltrim()・rtrim() が、既定で改ページの文字(\f)も取り除くようになった
  • fclose()・file_put_contents()・copy() は、書き出しやクローズに失敗したとき、黙って成功したふりをせず false を返すようになった。戻り値を見ていないコードは、今まで気づかなかった失敗に気づくきっかけになります
  • 多くの関数が、範囲外の値・無効なフラグ・NUL バイトを含む文字列を渡されると、黙って切り詰めず ValueError を投げるようになった

非推奨になったもの

非推奨は、今すぐ動かなくなるわけではありません。Deprecated のメッセージが出るようになり、次の大きな版(PHP 9)で削除される予定です。

  • finally の中の return(例外を黙って捨て、try・catch の戻り値を上書きしてしまうため)
  • __construct()・__destruct() から値を返すこと
  • クラス・関数・定数の名前に let・is を使うこと
  • mb_ereg()・mb_split() などの mbstring の正規表現の関数(土台の Oniguruma のメンテナンスが止まったため)。u 修飾子付きの preg_* に置き換えます
  • is_double()・is_long()・is_integer()・doubleval()(is_float()・is_int()・floatval() に)
  • spl_object_hash()(spl_object_id() に)
  • array_walk()・http_build_query() などの配列を受け取る関数に、オブジェクトを渡すこと(先に get_object_vars() で配列にする)
  • strcoll() と SORT_LOCALE_STRING(intl の Collator に)
  • define() の第 3 引数、metaphone()、mysqli_get_charset()・mysqli_stmt_init() など

手元で試すには

本番に入れる前に、Docker の公式イメージで、いまのコードがそのまま動くか試せます。

bash
# 版を確かめる
docker run --rm php:8.6-cli php -v

# いまのディレクトリのコードで、テストを E_ALL で回す(PHPUnit の例)
docker run --rm -v "$PWD":/app -w /app php:8.6-cli \
  php -d error_reporting=E_ALL -d display_errors=1 vendor/bin/phpunit
  • Deprecated のメッセージを拾って、上の「非推奨になったもの」を直していきます
  • Ubuntu なら、ondrej さんの PPA(ppa:ondrej/php)に php8.6 があります。Ubuntu の標準のパッケージには入っていません
  • Composer のパッケージが 8.6 を許していないと、composer install で止まります。フレームワークや CMS が 8.6 に対応したか、各公式の発表を確かめてから本番を上げます

進める順番

  1. いまの PHP の版を確かめる。8.2 以前なら、先に 8.4・8.5 へ上げる(8.2 は 2026 年末でサポート終了)
  2. Docker などで 8.6 を用意し、テストを E_ALL で回して Deprecated を拾う
  3. セッションの既定の変更(とくに SameSite=Lax)で、ログインや外部サービスとの行き来が動くか確かめる
  4. 使っているフレームワーク・CMS・ライブラリが 8.6 に対応したら、本番を上げる

まとめ

  • PHP 8.6 は 2026 年 11 月 19 日に公開。セキュリティの修正は 2030 年末まで
  • 新機能は、関数の部分適用(?)、\Time\Duration、clamp()、SortDirection、readonly のデフォルト値、ストリームの例外、Polling API など
  • 気をつけるのは、セッションの既定(strict_mode・HttpOnly・SameSite=Lax)、trim() と fclose() などの動きの変更、ValueError
  • finally の return、mb_ereg()、is_double() などは非推奨。Deprecated を拾って直しておく
  • 本番を今すぐ 8.6 にする必要はない。古い版なら、まず 8.4・8.5 へ

11 月 19 日には、8.2〜8.5 の修正版(重大なものを含む 17 件の脆弱性の修正)も出ています。中身は2026 年 11 月の脆弱性の確認と対応にまとめています。PHP 7 系・5 系からの移行はPHP 7 系から 8 系へ・PHP 5 系から 8 系へもどうぞ。

参考

php.net の公式の情報(2026 年 11 月 20 日時点)をもとにまとめています。

PHP 8.6.0 リリース - php.net

Supported Versions - PHP

PHP 8 ChangeLog - php.net

php - Docker Official Image - Docker Hub

TFT
soflan187本の記事

https://x.com/soflan