PHPのArgumentCountErrorとは？発生原因と対処法を実例付きで解説

はじめに

PHPでは、ユーザー定義関数やメソッドを呼び出す際に渡す引数の数が、関数定義で宣言されている数よりも少ない場合、「ArgumentCountError」がスローされます。ArgumentCountErrorクラスはTypeErrorクラスを継承しており、PHP 7.1以降で導入された例外です。

ArgumentCountErrorの基本的な例

次の例では、2つの引数を受け取るユーザー定義関数add()を定義しています。しかし、呼び出し時に必要な数より少ない引数しか渡さないとArgumentCountErrorが発生するため、try-catchブロックで捕捉して適切に処理します。

コード例

<?php
function add($x, $y){
    return $x+$y;
}
try{
    echo add(10);
}
catch (ArgumentCountError $e){
    echo $e->getMessage();
}
?>

実行結果

上記のコードを実行すると、次のような結果が出力されます。

Too few arguments to function add(), 1 passed in C:\xampp\php\test.php on line 6 and exactly 2 expected

エラーメッセージには、実際に渡された引数が1つであること、そして正確に2つの引数が必要であることが示されています。

クラスのメソッドで発生する例

次の例では、myclassクラスのsetdata()メソッドが2つの仮引数を持つように定義されています。このメソッドを引数を指定せずに呼び出すと、ArgumentCountErrorがスローされます。

コード例

<?php
class myclass{
    private $name;
    private $age;
    function setdata($name, $age){
        $this->name=$name;
        $this->age=$age;
    }
}
try{
    $obj=new myclass();
    $obj->setdata();
}
catch (ArgumentCountError $e){
    echo $e->getMessage();
}
?>

実行結果

上記のコードを実行すると、次のような結果が出力されます。

Too few arguments to function myclass::setdata(), 0 passed in C:\xampp\php\test.php on line 15 and exactly 2 expected

組み込み関数で発生する例

ArgumentCountErrorは、組み込み関数に対して不適切な数の引数を渡した場合にもスローされます。ただしこの場合、strict_typesモードを有効にしておく必要がある点に注意してください。

コード例

<?php
declare(strict_types = 1);
try{
    echo strlen("Hello", "World");
}
catch (ArgumentCountError $e){
    echo $e->getMessage();
}
?>

実行結果

上記のコードを実行すると、次のような結果が出力されます。

strlen() expects exactly 1 parameter, 2 given

ArgumentCountErrorを防ぐためのポイント

• デフォルト引数値を設定する：function add($x, $y = 0) のように初期値を指定すれば、引数を省略してもエラーになりません。
• 可変長引数を活用する：function sum(...$nums) のように可変長引数を使えば、任意の個数の引数を受け取れる柔軟な関数を作成できます。
• strict_typesモードの挙動を理解する：型の厳密チェックを有効にしている場合は、組み込み関数への余分な引数もエラーとなるため、呼び出し側の引数を必ず確認しましょう。