エラー

PHP 8.1で発生する暗黙の型変換警告「implicit conversion from float x to int loses precision」について解説

2025-04-15更新日: 2025-04-15

PHP 8.1以降、int型を期待する関数へfloat型や小数点を含む文字列を渡した際に、暗黙の型変換が行われ精度が失われる場合があります。

この記事では、警告「php implicit conversion from float x to int loses precision」が発生する原因と、その対策方法について分かりやすく解説します。

目次から探す

警告発生の背景
- 型変換の仕組み
- PHP 8.1以降の変更点
警告が発生するケース
- 関数への渡し方と型の不一致
- 出力例と精度の低下
対策方法
- 明示的な型キャストの導入
- コードによる動作確認
実務での適用注意事項
- 型管理の徹底
- バージョンアップ時の確認事項
まとめ

警告発生の背景

型変換の仕組み

PHPにおける暗黙の型変換の特徴

PHPでは、変数の型を明示的に指定しなくても動作するため、必要に応じて内部で自動的に型が変換される仕組みが備わっています。

たとえば、数値型の変数と文字列型の変数が混在する演算を行うと、PHPは適切な形に変換しながら処理を進めます。

その結果、開発者が意識しないうちに暗黙の型変換が行われ、動作に予期せぬ影響を与える場合があります。

数値型と文字列型の違い

PHPでは、数値型として主にint(整数型)やfloat(浮動小数点型)が利用され、これらは扱うデータの性質が異なります。

整数型は小数点を含まない数値を対象としており、浮動小数点型は小数点以下の情報も含んだ数値を取り扱います。

一方、文字列型は数値情報も含む場合がありますが、計算等の処理では自動的に数値型に変換されます。

このとき、たとえば"1.5"のような文字列を整数型として扱おうとすると、細かい数値の情報が欠落する可能性が生じます。

PHP 8.1以降の変更点

floatからintへの変換ルールの変更

PHP 8.1では、floatからintへの暗黙の変換が明示的に警告として通知されるようになりました。

以前は、浮動小数点数を整数型として扱う際に問題なく変換が行われていたため、意図しない精度の低下に気づかない場合が多くありました。

新しいバージョンでは、変換処理が暗黙的に行われる際、数値の精度が失われるリスクを開発者に明確に示すため、警告が表示されるようになっています。

警告メッセージの内容

警告メッセージは、実際にfloatや数値形式の文字列をint型の引数として渡した場合に表示されます。

たとえば、1.5のような値を整数型として扱おうとすると、以下のような警告が発生します。

Deprecated: Implicit conversion from float 1.5 to int loses precision

このメッセージは、変換過程で小数点以下の情報が失われるため、予期しない誤差が生じる可能性があることを示しています。

警告が発生するケース

関数への渡し方と型の不一致

int型引数にint以外の値を渡した場合

関数の引数にint型を指定している場合、int以外の型(たとえばfloatや数値形式の文字列)を渡すと、PHPは暗黙の型変換を行います。

しかし、このときに精度の低下が発生する可能性があるため、PHP 8.1以降では警告が表示されます。

以下は、その挙動を確認するためのシンプルな例です。

<?php
// int型を受け取る関数
function getIntNum(int $num) {
    return $num;
}
// 正常なケース: int型の値を渡す
echo getIntNum(10) . "\n";
// 警告が発生するケース: float型の値を渡す
echo getIntNum(1.5) . "\n";
?>

10
Deprecated: Implicit conversion from float 1.5 to int loses precision in ... on line ...
1

float型および数値形式の文字列の場合

float型の値に加え、たとえば"1.5"のような数値形式の文字列も、int型に変換される際に同様の警告が発生する可能性があります。

文字列の場合は、数値としての評価が先に行われ、その結果に対して暗黙的な変換が適用されるため、意図しない精度の損失が起こることがあります。

<?php
// 数値形式の文字列を渡すケース
echo getIntNum("1.5") . "\n";
?>

Deprecated: Implicit conversion from float-string "1.5" to int loses precision in ... on line ...
1

出力例と精度の低下

警告発生時のエラーメッセージ例

前述の例で示した通り、PHP 8.1以降では、floatまたは数値形式の文字列をintに変換する際に以下のような警告が出力されます。

Deprecated: Implicit conversion from float 1.5 to int loses precision
Deprecated: Implicit conversion from float-string "1.5" to int loses precision

これらのメッセージは、実行回数が少なくとも一度は開発環境で確認することができ、どの箇所で変換が起こっているかの特定に役立ちます。

数値変換で失われる精度

float型からint型への変換が行われる際、小数点以下の値は切り捨てられます。

たとえば、1.5は1に変換され、3.99は3となるため、変換の過程で数値の精度が失われることになります。

この現象は、計算結果やデータの正確性に直接的な影響を及ぼす可能性があるため、開発の際には注意が必要です。

$1.5 \to 1, 3.99 \to 3$

対策方法

明示的な型キャストの導入

floatからintへのキャスト方法

意図しない精度の損失を避けるためには、変換を明示的に行う方法が有効です。

float型の値をint型に変換する場合、キャスト演算子(int)を用いることで、開発者自身が変換の意思を明示できます。

以下は具体例です。

<?php
// float型の値を明示的にint型へ変換する例
$floatValue = 1.5; // 小数点以下が存在するfloat型
$intValue = (int) $floatValue; // 明示的にキャスト
echo $intValue . "\n";
?>

文字列からintへの変換方法

同様に、数値形式の文字列を整数として扱いたい場合も明示的なキャストが有効です。

文字列型の値に対しても、(int)を用いることで意図した型変換を行えます。

<?php
// 数値形式の文字列からint型への明示的な変換例
$stringValue = "1.5"; // 数値としても扱える文字列
$intValue = (int) $stringValue; // 明示的にキャストすることで警告回避
echo $intValue . "\n";
?>

コードによる動作確認

サンプルコードの構成

明示的なキャストを採用した場合と、暗黙の型変換で警告が発生する場合の両方を試すことで、実際の挙動を確認することができます。

以下は、getIntNum関数を用いたサンプルコードの構成例です。

<?php
// int型を引数にとる関数
function getIntNum(int $num) {
    return $num;
}
// 暗黙の型変換による警告発生例
echo "暗黙の変換：\n";
echo getIntNum(1.5) . "\n"; // float型を渡す場合
// 明示的なキャストを用いた解決例
echo "明示的なキャスト：\n";
echo getIntNum((int) 1.5) . "\n"; // 明示的にキャストすることで警告を回避
// 数値形式の文字列をテスト
echo "文字列によるテスト(暗黙の変換)：\n";
echo getIntNum("1.5") . "\n"; // こちらは警告が発生する場合もある
echo "文字列によるテスト(明示的キャスト)：\n";
echo getIntNum((int) "1.5") . "\n"; // 明示的にキャストする
?>

出力結果と注意点

上記のサンプルコードを実行すると、以下のような出力結果が得られます。

暗黙の型変換を利用した場合と、明示的なキャストを行った場合の違いを確認してください。

暗黙の変換：
Deprecated: Implicit conversion from float 1.5 to int loses precision in ... on line ...
1
明示的なキャスト：
1
文字列によるテスト(暗黙の変換)：
Deprecated: Implicit conversion from float-string "1.5" to int loses precision in ... on line ...
1
文字列によるテスト(明示的キャスト)：
1

なお、環境によっては警告レベルの設定により表示方法が異なる場合がありますが、キャストを明示することで警告を回避できる点に注意してください。