---
title: "PHP 8.6とは：部分関数適用・clamp()など新機能と8.5からの移行手順をDockerで確認【2026年11月】"
url: "https://www.issoh.co.jp/tech/details/20045/"
published: 2026-11-21
updated: 2026-11-21
categories: ["開発"]
publisher: "株式会社一創"
---

# PHP 8.6とは：部分関数適用・clamp()など新機能と8.5からの移行手順をDockerで確認【2026年11月】

PHP 8.6は、2026年11月19日に8.6.0が公開されたPHPの最新の系列です。目玉は、引数の一部を先に決めてクロージャを作る部分関数適用（Partial Function Application）で、ほかにreadonlyプロパティの既定値、イベントループ向けの`Io\Poll`、経過時間を表す`\Time\Duration`、`clamp()`、`SortDirection`列挙型が入りました。この記事では、公式のリリース告知とマニュアルに沿って新機能を8.5以前の書き方と比べ、セッション設定の既定値の変更や非推奨の洗い出し、Dockerでの動作確認の手順、本番を8.6へ上げる時期の判断までをまとめます。

## まとめ：PHP 8.6で変わる書き方と、本番を上げる前に確かめる3つのこと

PHP 8.6.0の公開日は2026年11月19日で、[php.netのSupported Versions](https://www.php.net/supported-versions.php)では通常のサポートが2028年12月31日まで、セキュリティ修正が2030年12月31日までと示されています。新しく書くコードでは、短いアロー関数を部分関数適用に置き換えられる場面が増えます。

既存のシステムを上げる前に見るのは、セッション設定の既定値（`session.use_strict_mode`などが有効に変わった点）、非推奨になった関数の呼び出し、例外や`ValueError`に変わった関数の3つです。本番の切り替えは、利用しているフレームワークと主要ライブラリが8.6対応を公表し、8.6.2前後のパッチが出てからにするのが安全です。2026年12月31日でセキュリティ修正が終わる8.2を使っている場合は、8.6を待たずに8.4か8.5へ移すほうを先に進めてください。

## PHP 8.6.0の公開日とサポート期限、8.5からの位置づけ

PHPは毎年11月下旬に新しいマイナー版を出し、各系列に2年の通常サポートと、その後2年のセキュリティ修正の期間を設けています。8.6もこの周期どおりで、8.5.0（2025年11月20日）のちょうど1年後に出ました。

### 8.2〜8.6の公開日と通常サポート・セキュリティ修正の期限

php.netのSupported Versionsに掲載されている日付を、2026年11月20日時点で並べると次のとおりです。

| 系列  | 公開日         | 通常サポート終了    | セキュリティ修正終了  |
| --- | ----------- | ----------- | ----------- |
| 8.2 | 2022年12月8日  | 2024年12月31日 | 2026年12月31日 |
| 8.3 | 2023年11月23日 | 2025年12月31日 | 2027年12月31日 |
| 8.4 | 2024年11月21日 | 2026年12月31日 | 2028年12月31日 |
| 8.5 | 2025年11月20日 | 2027年12月31日 | 2029年12月31日 |
| 8.6 | 2026年11月19日 | 2028年12月31日 | 2030年12月31日 |

8.2はあと1か月余りでセキュリティ修正も止まります。系列ごとの期限と移行の順番は[PHPのサポート期限一覧と版ごとのEOL・移行手順](https://www.issoh.co.jp/tech/details/18881/)で詳しく扱っているので、ここでは8.6の中身に絞ります。

### 8.5の変更点との関係と、8.6で追加された構文・機能の一覧

8.5ではパイプ演算子`|>`やURI拡張が入りました。8.6の部分関数適用は、このパイプ演算子と組み合わせる前提で設計されています。8.5で何が入ったかは[PHP 8.5の変更点と新機能](https://www.issoh.co.jp/tech/details/8179/)で確認できます。

[PHP 8.6のリリース告知](https://www.php.net/releases/8.6/en.php)が大きく取り上げている機能は次の9つです。

- 部分関数適用（`?`と`...`のプレースホルダ）
- readonlyプロパティの既定値
- ポーリングAPI（`Io\Poll`）
- `\Time\Duration`クラス
- `clamp()`関数
- `SortDirection`列挙型
- ストリーム操作のエラーを例外で受け取る`StreamException`
- 関数の引数ごとのDocComment
- `ReflectionProperty::isReadable()`と`isWritable()`

このほか、Sodium拡張への耐量子のKEM（X-WingとML-KEM-768）の追加、`mysqli::quote_string()`の追加、JSONのエラーメッセージに位置が入る変更なども含まれます。業務システムの実装で書き方が変わるのは、上の6つまでと考えてよいでしょう。

## 部分関数適用とreadonly既定値を8.5以前のコードから書き換える

ここからは、リリース告知とマニュアルに載っている例を使って、8.5以前の書き方と並べます。コードは`php:8.6.0-cli`のコンテナでそのまま実行できる形にしてあります。

### ?と…のプレースホルダで引数の一部を先に決めてクロージャを作る書き方

[PHPマニュアルの部分関数適用のページ](https://www.php.net/manual/en/functions.partial-application.php)によると、関数呼び出しの引数に`?`か`...`を書くと、その場では関数を呼ばず、残りの引数を受け取る`Closure`が返ります。`?`はちょうど1個の引数、`...`はまだ指定していない残りすべての引数を表します。

```
<?php
$versions = ['8.4', '8.5', '8.6', '8.7', '9.0'];

// 8.5以前：アロー関数で包む
$old = array_filter($versions, fn ($v) => version_compare($v, '8.6', '>='));

// 8.6：? の位置に要素が入る Closure を作る
$new = array_filter($versions, version_compare(?, '8.6', '>='));

// 名前付きプレースホルダは書いた順が引数の順になる
$remove = str_replace(subject: ?, search: ?, replace: '');
var_dump($remove('a-b-c', '-'));  // string(3) "abc"
```

見た目はアロー関数の省略形ですが、挙動に違いが1つあります。先に渡した引数は、クロージャを作った時点で一度だけの評価です。`greet(?, now())`と書くと`now()`は作成時に1回呼ばれるだけで、呼び出しのたびに現在時刻を取り直すアロー関数とは結果が変わります。時刻や乱数を渡すコードを機械的に置き換えると、ここで不具合になります。

### 部分関数適用が使えない4つの書き方とコンパイル時に出るエラー

マニュアルは、次の書き方をコンパイル時のエラーとしています。

- `new Foo(1, ?)`：`new`は呼び出しとみなされない
- `$obj?->method(1, ?)`：nullsafe演算子とは組み合わせられない
- `foo(?, ...$array)`：引数の展開とは組み合わせられない
- `foo(..., ?)`：`...`は最後に1回だけ置ける

`compact()`や`func_get_args()`のように呼び出し元のスコープを見る関数は、部分適用すると実行時に`Error`になります。`...`を付けない場合、クロージャに余分に渡した引数は黙って捨てられる点も覚えておくと、デバッグで迷いません。

### readonlyプロパティに既定値を書いてコンストラクタを省く

[readonly\_property\_defaultsのRFC](https://wiki.php.net/rfc/readonly%5Fproperty%5Fdefaults)が採用され、readonlyクラスを含むインスタンスのreadonlyプロパティに既定値を書けるようになりました。8.5までは、固定値を入れるだけのためにコンストラクタが必要でした。

```
<?php
final readonly class SlugRule
{
    // 8.5以前はコンストラクタで $this->parser = ... と代入していた
    public string $parser = 'SlugParser';
}

var_dump((new SlugRule())->parser);  // string(10) "SlugParser"
```

既定値は初期化済みとして扱われるため、コンストラクタで別の値を代入すると書き込みエラーになります。設定値を外から差し替えたいプロパティには既定値を書かず、従来どおりコンストラクタで受け取ってください。

## clamp()・Duration・SortDirection・Io\\Pollの実装例と用途

残りの新機能は、これまで自前で書いていた小さな処理を標準に置き換えるものです。どれも新しく書くコードから使い始められます。

### clamp()とDurationで再試行の待ち時間を上限30秒に収める

[clamp\_v2のRFC](https://wiki.php.net/rfc/clamp%5Fv2)で入った`clamp($value, $min, $max)`は、値を範囲内に収め、外れたときは近いほうの境界を返します。`max(0, min($v, 100))`の入れ子より読み違えが起きにくく、比較できる値なら数値以外にも使えます。[duration\_classのRFC](https://wiki.php.net/rfc/duration%5Fclass)で入った`\Time\Duration`は、時刻やタイムゾーンと関係のない経過時間をナノ秒の精度で持つクラスです。

```
<?php
use Time\Duration;

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

// 指数バックオフ：1秒＋100ミリ秒×2^n、上限30秒
function backoffDelay(int $attempt): Duration
{
    $delay = Duration::fromSeconds(1)
        ->add(Duration::fromMilliseconds(100)->multiplyBy(2 ** $attempt));
    return min($delay, Duration::fromSeconds(30));
}

$d = backoffDelay(3);
time_nanosleep($d->seconds, $d->nanoseconds);
```

マイクロ秒の整数を`usleep()`へ渡していたコードは、単位の取り違えが起きやすい箇所です。外部APIの再試行やタイムアウトの値を`Duration`で持つと、型で単位を固定できます。

### SortDirection列挙型で並び順の引数に型を付けて誤りを防ぐ

並び順を`SORT_ASC`と`SORT_DESC`の整数で受け取ると、`SORT_STRING`のような別の定数も受け付けてしまい、メソッドの中で初めて失敗します。8.6の`SortDirection`は`Ascending`と`Descending`の2ケースだけを持つ列挙型です。

```
<?php
function orderBy(string $column, SortDirection $dir = SortDirection::Ascending): string
{
    return $column . ' ' . match ($dir) {
        SortDirection::Ascending => 'ASC',
        SortDirection::Descending => 'DESC',
    };
}

echo orderBy('created_at', SortDirection::Descending);  // created_at DESC
orderBy('name', SORT_STRING);  // TypeError
```

リリース告知の例でも、整数の定数を渡した呼び出しは`TypeError`として呼び出し側で止まります。社内のクエリビルダーや一覧画面の並び替えのように、複数の部品で同じ「並び順」を受け渡す箇所から置き換えると効果が見えやすくなります。

### Io\\Pollがstream\_select()の1024接続の制約を外す仕組み

[poll\_apiのRFC](https://wiki.php.net/rfc/poll%5Fapi)で入った`Io\Poll`は、Linuxならepoll、macOSやBSDならkqueue、WindowsならWSAPollと、OSごとの監視の仕組みを自動で選びます。`select()`を土台にする`stream_select()`は、一般に1024を超える接続を扱えませんでした。

リリース告知は、ReactPHPやAMPHPのようなイベントループのライブラリが共通の土台として使うことを想定していると書いています。普通のWebアプリケーションのコードがこのAPIを直接呼ぶ場面はほとんどありません。WebSocketやチャットのサーバーをPHPで常駐させている場合に、使っているライブラリが8.6向けに`Io\Poll`へ切り替えるかを追う、という付き合い方で十分です。

## 8.6へ上げる前にDockerで非推奨と非互換変更を洗い出す手順

既存のコードを8.6で動かすときに、どこが壊れるかを本番の前に調べる手順です。サーバーへ8.6を入れなくても、Docker公式イメージで同じ確認ができます。

### php:8.6.0-cliのイメージでテストを流し非推奨の警告を集める

[Docker公式のphpイメージ](https://hub.docker.com/%5F/php)には、2026年11月19日付で`8.6.0-cli`、`8.6.0-fpm`、`8.6.0-apache`などのタグが登録されています。手元のプロジェクトをマウントし、次の順で確認します。

```
# 1. 版の確認
docker run --rm php:8.6.0-cli php -v

# 2. 新機能が動くかを1行で確認
docker run --rm php:8.6.0-cli php -r 'var_dump(clamp(110, 0, 100));'

# 3. 8.6で非推奨になった関数の呼び出しを探す（vendor は除く）
grep -rnE '\b(is_double|is_long|is_integer|doubleval|spl_object_hash|strcoll|mb_ereg|mb_split|metaphone)\s*\(' \
  --include='*.php' --exclude-dir=vendor .

# 4. 既存のテストを E_ALL で流し、Deprecated の行だけ数える
docker run --rm -v "$PWD":/app -w /app php:8.6.0-cli \
  php -d error_reporting=E_ALL -d display_errors=1 vendor/bin/phpunit 2>&1 \
  | grep -c 'Deprecated'
```

4つ目はPHPUnitを使っている場合の例です。拡張が必要なアプリケーションは公式イメージに`docker-php-ext-install`で拡張を足したDockerfileを用意してください。依存ライブラリが8.6を許可しているかは、Composerの[config.platformの設定](https://getcomposer.org/doc/06-config.md#platform)に`"php": "8.6.0"`を入れて`composer update --dry-run`を実行すると、解決できないパッケージが一覧で出ます。

### 業務コードで見つかりやすい8.6の非推奨関数と書き換え先の対応表

リリース告知と[移行ガイドの非推奨のページ](https://www.php.net/manual/en/migration86.deprecated.php)から、業務アプリケーションで見つかりやすいものを抜き出しました。非推奨は警告が出るだけで、8.6の中ではまだ動きます。

| 8.6で非推奨                   | 書き換え先                   |
| ------------------------- | ----------------------- |
| is\_double() / is\_long() | is\_float() / is\_int() |
| is\_integer()/doubleval() | is\_int() / floatval()  |
| spl\_object\_hash()       | spl\_object\_id()       |
| mb\_ereg() / mb\_split()  | preg\_match() など（u修飾子）  |
| strcoll()                 | intl拡張の Collator        |
| SORT\_LOCALE\_STRING      | intl拡張の Collator        |
| finally の中での return       | try の中で値を返す             |
| define() の第3引数            | 引数を2つにする                |

mbstringの正規表現関数が非推奨になったのは、土台のOnigurumaライブラリの保守が止まったためです。日本語の入力チェックで`mb_ereg()`を使っている古いコードは多く、件数が多いならこの置き換えを先に済ませておくと、将来の版で関数が削除されたときにも慌てずに済みます。

### セッション設定の既定値が変わる3項目とphp -iで実際の値を確認する手順

[移行ガイドの非互換変更のページ](https://www.php.net/manual/en/migration86.incompatible.php)によると、8.6ではセッションの次の3つの既定値が変わりました。

| 設定                        | 8.5まで | 8.6から |
| ------------------------- | ----- | ----- |
| session.use\_strict\_mode | 0     | 1     |
| session.cookie\_httponly  | 0     | 1     |
| session.cookie\_samesite  | 未設定   | Lax   |

php.iniで明示的に値を書いている環境は影響を受けません。既定値に頼っている環境では、JavaScriptからセッションのCookieを読む処理と、外部の決済画面などから別サイトのPOSTで戻ってくる画面が動かなくなるおそれがある点に注意してください。後者はマニュアルどおり`"None"`と`session.cookie_secure=1`を指定します。実際に効いている値は次のコマンドで確かめられます。

```
docker run --rm php:8.6.0-cli php -i | grep -E 'session\.(use_strict_mode|cookie_httponly|cookie_samesite)'
```

独自のセッションハンドラーを書いている場合は、`create_sid()`と`validateId()`の両方を実装していないと非推奨の警告が出ます。`trim()`がフォームフィード（`\f`）も取り除くようになった点、`filesize()`などのファイル関数がNULバイトを含む引数で`ValueError`を投げるようになった点も、同じページに載っています。

## 本番のPHPを8.6へ上げる時期の判断と、8.5に留める条件

新しい系列が出た直後に本番を上げるかどうかは、機能の魅力ではなく、依存しているソフトウェアの対応状況で決めます。ここでは判断を言い切ります。

### 8.6.0の直後に本番を上げてよいのは新規開発だけという判断

これから作り始めるシステムは、開発環境を最初から8.6にしてください。本番の公開が数か月先なら、その間にパッチが出てフレームワークも追いつきます。8.6のセキュリティ修正は2030年12月31日まで続くため、8.5で始めるより1年長く使えます。

稼働中のシステムは、8.6.0の時点では上げません。PHPの.0は公開直後の数か月にバグ修正のパッチが続けて出るのが通例で、2026年11月には8.5系でも[マジックメソッドの脆弱性CVE-2026-129474](https://www.issoh.co.jp/tech/details/20026/)が8.5.13で直ったばかりです。利用中のフレームワークと、Composerで解決できなかったパッケージがすべて8.6対応を出したことを確かめてから、検証環境で上の手順を通します。

### 8.5に留めてよい条件と、8.2・8.3から先に動くべき理由

8.5は2027年12月31日まで通常サポートが続きます。セッションの既定値や`mb_ereg()`の置き換えに手間がかかるシステムは、2027年の前半に8.6へ上げる計画で十分間に合います。急ぐ理由があるのは、8.2と8.3を使っているシステムのほうです。

8.2は2026年12月31日、8.3は2027年12月31日でセキュリティ修正が終わります。8.2から一気に8.6へ上げると、8.3〜8.6の4系列分の非推奨と非互換変更をまとめて受けることになり、検証の範囲が広がります。8.2の環境は、まず8.4か8.5へ上げて安定させ、8.6は次の段階に回してください。社内に移行を担える人が足りず、フレームワークの更新も重なる場合は、[システムマイグレーション・リプレイス](https://www.issoh.co.jp/service/system/migration/)のように、版上げと周辺の刷新をまとめて外部に任せる選択肢もあります。

## よくある質問

PHP 8.6について、公開直後によく出る質問に答えます。

### PHP 8.6はいつリリースされましたか？

PHP 8.6.0は2026年11月19日に公開されました。php.netのSupported Versionsでは、通常サポートが2028年12月31日まで、セキュリティ修正が2030年12月31日までです。今後はおおむね月に1回のペースで8.6.1、8.6.2とパッチが出ます。各系列の期限の一覧は[PHPのサポート期限一覧](https://www.issoh.co.jp/tech/details/18881/)にまとめています。

### 部分関数適用とアロー関数は何が違いますか？

先に渡した引数を評価するタイミングが違います。部分関数適用はクロージャを作った時点で引数を一度だけ評価し、アロー関数では呼び出すたびに評価する仕組みです。また、部分関数適用でできるクロージャは元の関数の引数名、型宣言、戻り値の型を引き継ぎます。`new`や引数の展開とは組み合わせられないので、その場合はアロー関数を使います。

### PHP 8.6でLaravelやWordPressは動きますか？

対応はそれぞれのプロジェクトが発表するため、PHP側の告知からは判断できません。利用中の版のリリースノートで8.6への対応を確かめてください。Composerで管理しているアプリケーションなら、`config.platform`に8.6.0を指定して`composer update --dry-run`を実行すると、8.6を許可していないパッケージがその場で分かります。

### PHP 8.5から8.6に上げると既存のコードは動かなくなりますか？

多くのコードはそのまま動きます。非推奨になった関数は警告が出るだけです。動作が変わるのは、セッション設定の既定値に頼っている箇所、NULバイトを含む値をファイル関数へ渡している箇所、範囲外の値で`ValueError`になる関数、`unpack()`の書式で`<`や`>`をキー名に使っている箇所などです。テストを8.6のコンテナで流して確かめてください。

### XAMPPやLaragonでPHP 8.6を使えますか？

XAMPPやLaragonが同梱するPHPの版は、それぞれの配布元の更新に依存します。8.6を同梱した版が出るまでは、Docker公式イメージの`php:8.6.0-cli`や`php:8.6.0-apache`で試すのが手早い方法です。手元の開発環境の作り方は[PHP開発の始め方](https://www.issoh.co.jp/tech/details/1316/)で解説しています。

## 関連記事

- [PHP 8.5の変更点と新機能｜8.4との違い・非推奨・性能を実行結果で確認【8.5.12対応】](https://www.issoh.co.jp/tech/details/8179/)：パイプ演算子など8.6の前提になる8.5の変更
- [PHPのサポート期限一覧：8.2は2026年末で終了、8.6の期限と版ごとのEOL・移行手順【2026年11月】](https://www.issoh.co.jp/tech/details/18881/)：どの系列をいつまで使えるかの判断材料
- [PHP 8.4の新機能と変更点｜8.4.27までのパッチとサポート期限、移行時の非推奨を実行結果で確認](https://www.issoh.co.jp/tech/details/4525/)：8.2・8.3から先に移る先の候補
- [PHP開発の始め方｜環境構築・フレームワーク選定・システム開発の進め方【PHP 8.5対応】](https://www.issoh.co.jp/tech/details/1316/)：開発環境の作り方とフレームワーク選び
- [PHPマジックメソッドの脆弱性CVE-2026-129474：8.5.13への更新とphp.ini設定の確認手順【11月20日時点】](https://www.issoh.co.jp/tech/details/20026/)：8.5系を使い続ける場合に当てるパッチ

---

出典: [PHP 8.6とは：部分関数適用・clamp()など新機能と8.5からの移行手順をDockerで確認【2026年11月】](<https://www.issoh.co.jp/tech/details/20045/>)（株式会社一創）
