PHPのmin()関数とは？使い方と具体例を徹底解説

min()関数の定義と使い方

min()関数は、配列に含まれる要素の中で最も小さい値、あるいは2つ以上のカンマ区切りで指定された引数の中で最小の値を返す組み込み関数です。数値だけでなく文字列なども比較でき、PHPプログラミングにおいて非常に頻繁に利用される基本的な関数の一つです。

構文

配列を引数として渡す場合：

min(array $values): mixed

複数の値を直接渡す場合：

min(mixed $value1 [, mixed $... ]): mixed

パラメータ

戻り値

min()関数は、配列または引数リストの中から最小値を返します。比較には標準的な比較演算子が使用されます。異なる型の複数の値が等しいと評価された場合（例：0 と 'PHP'）、関数に最初に渡された引数が返されます。

対応するPHPバージョン

この関数はPHP 4.x、PHP 5.x、PHP 7.xのすべてのバージョンで利用可能です。

使用例1：数値配列から最小値を取得

次の例では、数値のみを含む配列から最小値を取得しています。

<?php
   $arg = array(23, 5.55, 142, 56, 99);
   echo "array=";
   foreach ($arg as $i) echo $i . ",";
   echo "\n";
   echo "min = " . min($arg);
?>

実行結果：

array=23,5.55,142,56,99,
min = 5.55

使用例2：文字列配列から最小値を取得

文字列の配列に対してもmin()関数を使用できます。文字列の場合は辞書順（アルファベット順）で比較されます。

<?php
   $arg = array("Java", "Angular", "PHP", "C", "Kotlin");
   echo "array=";
   foreach ($arg as $i) echo $i . ",";
   echo "\n";
   echo "min = " . min($arg);
?>

実行結果：

array=Java,Angular,PHP,C,Kotlin,
min = Angular

使用例3：複数の文字列引数から最小値を取得

次の例では、配列ではなく個別の文字列値をmin()関数に直接渡しています。

<?php
   $val1 = "Java";
   $val2 = "Angular";
   $val3 = "PHP";
   $val4 = "C";
   $val5 = "Kotlin";
   echo "values=" . $val1 . "," . $val2 . "," . $val3 . "," . $val4 . "," . $val5 . "\n";
   echo "min = " . min($val1, $val2, $val3, $val4, $val5);
?>

実行結果：

values=Java,Angular,PHP,C,Kotlin
min = Angular

使用例4：異なるデータ型が混在する配列

次の例では、数値と文字列が混在する配列をmin()関数に渡しています。

<?php
   $arg = array(23, "Java", 142, 1e2, 99);
   echo "array=";
   foreach ($arg as $i) echo $i . ",";
   echo "\n";
   echo "min = " . min($arg);
?>

実行結果：

array=23,Java,142,100,99,
min = Java

このように、数値と文字列が混在する場合、PHPの型比較ルールに従って比較が行われるため、直感と異なる結果になることがあります。意図しない動作を避けるためには、比較対象のデータ型を揃えておくことが推奨されます。