【2026年11月】PHP 8.6の新機能と上げるときの注意|部分適用・Duration・clamp()とセッションの既定の変更
はじめに
2026 年 11 月 19 日、PHP 8.6 が公開されました。毎年 11 月に出る、1 年に 1 回の新しい版です。関数の引数の一部を先に決めておける「部分適用」、時間の長さを表す Duration クラス、値を範囲に収める clamp() 関数など、日々のコードを短くする機能が入りました。
この記事では、主な新機能を PHP 8.5 までの書き方と比べて紹介し、上げるときに気をつけたい変更と、手元での試し方をまとめました。コードの例は、php.net の公式の発表の例をもとに短くしたものです。
サポートの期間
| バージョン | 公開 | 通常のサポート | セキュリティの修正 |
|---|---|---|---|
| 8.6 | 2026 年 11 月 19 日 | 2028 年 12 月 31 日まで | 2030 年 12 月 31 日まで |
| 8.5 | 2025 年 11 月 | 2027 年 12 月 31 日まで | 2029 年 12 月 31 日まで |
| 8.4 | 2024 年 11 月 | 2026 年 12 月 31 日まで | 2028 年 12 月 31 日まで |
| 8.3 | 2023 年 11 月 | 終了 | 2027 年 12 月 31 日まで |
| 8.2 | 2022 年 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 で包む必要がなくなります。
$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 はナノ秒の精度で、足し算や比べることができます。
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 も使えます)。
// 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'(文字列)、真偽値など、ばらばらの表し方をしていました。型で受け取れるので、間違った値を渡すとすぐにエラーになります。
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 プロパティに、宣言のところで値を書けるようになりました。決まった値を入れるためだけに、コンストラクタを書く必要がなくなります。
// 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() のメッセージの文字列を読むしかありませんでした。
$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_mode | 0 | 1 | サーバーが発行していないセッション 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 の公式イメージで、いまのコードがそのまま動くか試せます。
# 版を確かめる
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 に対応したか、各公式の発表を確かめてから本番を上げます
進める順番
- いまの PHP の版を確かめる。8.2 以前なら、先に 8.4・8.5 へ上げる(8.2 は 2026 年末でサポート終了)
- Docker などで 8.6 を用意し、テストを E_ALL で回して Deprecated を拾う
- セッションの既定の変更(とくに SameSite=Lax)で、ログインや外部サービスとの行き来が動くか確かめる
- 使っているフレームワーク・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 日時点)をもとにまとめています。



