func_get_args

関数の概要

PHPの func_get_args は、関数の中で渡されたすべての引数を配列として取得できる関数です。可変長引数のように、引数の数が不特定の場合に便利で、関数定義で直接可変長引数を利用しない場合でも引数をまとめて扱うことができます。

パラメータの説明

  • なし：func_get_args には引数はありません。関数の中で呼び出された際には、その関数に渡された引数を取得します。

戻り値

func_get_args は、現在の関数に渡された全ての引数を順番通りに含む配列を返します。引数が一つもなければ空の配列を返します。

使用例

基本的な使い方

function test() {
    $args = func_get_args();
    print_r($args);
}

test(1, 'apple', true);

この例では、test 関数に渡された引数がすべて配列として取得され、画面に表示されます。

引数の数を気にせず合計値を求める

function sumAll() {
    $args = func_get_args();
    $sum = 0;
    foreach ($args as $num) {
        $sum += $num;
    }
    return $sum;
}

echo sumAll(1, 2, 3, 4); // 出力: 10

引数の個数が決まっていなくても対応でき、全引数の合計を計算しています。

複数のデータ型の引数を受け取る例

function describe() {
    $args = func_get_args();
    foreach ($args as $arg) {
        echo '型: ' . gettype($arg) . ', 値: ' . var_export($arg, true) . "<br>";
    }
}

describe(42, 'hello', [1, 2, 3], null);

引数の型と値を順に出力し、可変長引数のデータをわかりやすく確認できます。

関連する関数

  • func_num_args() – 現在の関数に渡された引数の数を取得します。
  • func_get_arg($index) – 指定した位置にある引数を取得します。
  • PHP7以降の ...$args（スプレッド演算子）を使う方法 – よりモダンな可変長引数の取り扱い。

まとめ

func_get_args はPHPで可変長引数を簡単に取得するための便利な関数です。特に関数定義時に引数の個数が決まらない場合や、複数の引数をまとめて配列として扱いたいときに有効です。PHP7以降は可変長引数（スプレッド演算子）によるより簡潔な方法もありますが、レガシーコードのメンテナンスや特殊な場面でfunc_get_argsはまだ活躍しています。

スポンサーリンク