実務で先に確認したいポイント

運用中のプロジェクトで、PHP8.4から8.5へのアップグレードをいくつか担当しました。その際に気になった点をまとめます。 公式ドキュメントにもある通り、今回の変更には破壊的変更がないため、細かな注意点を取り上げます。 パイプ演算子など、PHP8.5の新機能はすでに多くの記事で紹介されています。ここでは新機能には触れず、既存プロジェクトをアップグレードする際の注意点に絞ります。

1. 古い書き方がdeprecationになっていないか

今回まず気にしたいのは、古いけれど動いていた書き方です。

特に確認が必要なケースは次のあたりです。

  • バッククォート演算子を使ってシェル実行している箇所
  • (boolean)や(integer)のような非標準寄りのキャスト表記
  • caseの末尾を:ではなく;にしているswitch
  • nullを配列オフセットとして使っている箇所
  • 非数値文字列に++している箇所

上記については、将来の更新コストを上げやすいので、8.5に上げるタイミングで一緒に修正しておいた方が楽です。 特に++$strで"A"や"ZZ"を進めるようなコードや(boolean)によるキャスト表記は、5~10年位前に作成された案件で実際にあったのを確認したため注意が必要です。

2. warningに変わる挙動を甘く見ない

8.5では、今まで問題なかったものがwarningになるケースがあります。
これが厄介なのは、処理自体は継続しても、ログ監視や例外化方針によっては本番運用に影響することです。

主に次の箇所を確認します。

  • floatやfloatっぽい文字列をintにキャストする箇所
  • NANを別型へキャストする箇所
  • 配列でない値をlist()や[]で分割代入している箇所

特に(int) $valueをとりあえず当てている箇所が多いプロジェクトでは、一度検索して使用しているか確認しておく方が安全です。もし該当する箇所があればこの機会に直すのが良いかと思います。

3. disable_classes依存がないか

PHP8.5ではdisable_classesが削除されています。
この設定を積極的に使っているケースは多くないと思いますが、要確認です。

アプリコードそのものより、以下のような場所にないか確認が必要です。

  • php.ini
  • Dockerイメージ内の独自ini
  • ECS / Fargate / VMの起動設定
  • 古いAnsible / Chef / shell script

4. PDOを使っているならfetch周りを確認する

PDOは8.5で微妙に挙動差が出る箇所があります。
業務アプリでは、ORMを使っていても周辺ツールや特殊クエリだけPDOを直接使っていることがあるので注意が必要です。

特に次の箇所を確認します。

  • PDO::FETCH_CLASSを使っている箇所
  • コンストラクタ引数を伴うfetch
  • fetch中に特殊なモード変更をしている箇所

また、PDO自体にもdeprecationが追加されています。

  • uri: DSNスキームはdeprecated
  • PDOクラス上のドライバ固有定数はdeprecated
  • PDOクラス上のドライバ固有メソッドはdeprecated

特にuri: DSNスキームについては、リモートURIに起因するDSNのセキュリティ懸念が理由とされているため、古い接続コードや設定値を使い回している案件では一度確認しておいた方が安全です。

また、PDOクラスで定義されていたドライバ固有の定数・メソッドも、各ドライバ専用クラスへ寄せる形に変わっています。
普段の業務でよく遭遇しやすそうなものを挙げると、例えば次のようなものです。

  • PDO::MYSQL_ATTR_USE_BUFFERED_QUERY => Pdo\Mysql::ATTR_USE_BUFFERED_QUERY
  • PDO::MYSQL_ATTR_LOCAL_INFILE => Pdo\Mysql::ATTR_LOCAL_INFILE
  • PDO::MYSQL_ATTR_INIT_COMMAND => Pdo\Mysql::ATTR_INIT_COMMAND
  • PDO::MYSQL_ATTR_SSL_CA => Pdo\Mysql::ATTR_SSL_CA
  • PDO::PGSQL_ATTR_DISABLE_PREPARES => Pdo\Pgsql::ATTR_DISABLE_PREPARES
  • PDO::SQLITE_ATTR_EXTENDED_RESULT_CODES => Pdo\Sqlite::ATTR_EXTENDED_RESULT_CODES
  • PDO::pgsqlCopyFromFile() => Pdo\Pgsql::copyFromFile()
  • PDO::pgsqlGetNotify() => Pdo\Pgsql::getNotify()
  • PDO::sqliteCreateFunction() => Pdo\Sqlite::createFunction()

MySQL / PostgreSQL / SQLiteを直接触っているユーティリティコードや、古いサンプル実装をベースにした社内基盤ではこの手の書き方が残っていることがあります。
使用しているドライバに合わせて、次の文字列をgrepなどで検索すると確認しやすくなります。

  • PDO::MYSQL_ATTR_
  • PDO::PGSQL_
  • PDO::SQLITE_
  • PDO::pgsql
  • PDO::sqlite

5. trait / attribute周りを確認する

PHP8.5はtraitの束縛順やattributeの検証タイミングに関する変更があります。

たとえば次のようなコードであれば注意が必要です。

  • attributeをDIやルーティングに多用している
  • traitをかなり複雑に重ねている
  • reflectionを使う独自フレームワーク・社内基盤がある

6. Composer依存関係の注意

PHP本体の差分より、Composer制約で止まる場合にも注意が必要です。

たとえば、次の順で対応状況が問題になりやすいです。

  1. フレームワーク本体が8.5対応前
  2. テストライブラリが未対応
  3. 静的解析ツールが未対応
  4. 開発用ツールだけが8.5を許可していない

そのため、コードを直す前に、以下も併せて確認した方がよいです。

  • composer.jsonのPHP制約
  • composer.lockに入っている主要パッケージのPHP対応状況
  • CIで使うPHPバージョン
  • Dockerfileのベースイメージ

コード修正は問題なくても、CIや開発環境が8.4のままだと確認漏れが増えます。

まとめ

次の4点は先に見ておくと進めやすいです。

  • 古い書き方のdeprecation
  • 型変換や分割代入まわりのwarning
  • disable_classesなどの環境設定差分
  • PDO / trait / attributeなど、少し挙動差が出やすい箇所

コードに加えて、CI、Docker、php.ini、ログ監視まで含めて確認する必要があります。

公式ドキュメント

前後の記事

関連記事

技術(バックエンド) 2026/4/2

Laravel12から13へ上げるときの注意点と確認項目

2026年3月17日にリリースされたLaravel13へ、Laravel12から上げる際に先に見ておきたいポイントを実務寄りに整理する。

技術(バックエンド) 2026/4/6

PHP 8系の新機能を整理する。trait・enum・パイプ演算子は何が違うのか

PHP 8系で注目したい機能を、PHP 7系以下との違いがわかる具体的なコード付きで整理する。traitの位置づけ、enum、match、Attributes、そしてPHP 8.5で追加されたパイプ演算子までまとめて紹介。

技術(バックエンド) 2026/4/14

フレームワークや言語のアップデートを行うことで設計やロジックの勉強になる

簡単だと思われたり、避けられたりしがちな言語やフレームワークのアップデート。実務で取り組むと、設計やロジックを学ぶ機会になる。