PHPのarray_mapを使って配列内オブジェクトのメソッドを呼び出す方法

PHPでは、array_map関数を利用することで、配列に格納された各オブジェクトに対して一括でメソッドを呼び出すことができます。この記事では、PHPのバージョン別の実装方法と、パフォーマンスに関する注意点、さらに応用例について解説します。

PHP 5.3以降：無名関数（クロージャ）を使う方法

PHP 5.3以降では、無名関数（クロージャ）をarray_mapのコールバックとして直接渡せるため、簡潔に記述できます。

$props = array_map(function($obj){ return $obj->getProp(); }, $objs);

このコードは、配列$objs内のすべてのオブジェクトに対してgetProp()メソッドを実行し、その戻り値を新しい配列$propsとして取得します。

パフォーマンスに関する注意点

array_mapは配列の各要素ごとに関数呼び出しが発生するため、単純なforループと比較すると処理速度は若干遅くなります。

function map($obj) {
    return $obj->getProperty();
}
$props = array_map('map', $objs);

大量のデータを扱う場合やパフォーマンスが重視される場面では、通常のループ処理との使い分けを検討するとよいでしょう。

PHP 5.3未満：名前付き関数を使う方法

古いバージョンのPHPでは無名関数が使えないため、あらかじめ定義した名前付き関数をコールバックとして指定します。

function map($obj) {
    return $obj->getProperty();
}
$props = array_map('map', $objs);

この場合も、配列内の全オブジェクトに対してgetProperty()が呼び出され、目的のプロパティ値をまとめて取得できます。

応用例：再帰的にUTF-8エンコードを行う

array_mapは多次元配列にも応用できます。以下の例では、関数内で自身を再帰的に呼び出すことで、ネストされた配列のすべての値をUTF-8エンコードしています。

function encode_data($val){
    if(is_array($val)){
        return $val = array_map('encode_data', $val);
    } else {
        return utf8_encode($val);
    }
}
$value = array_map('encode_data', $value);
print_r($value);

このコードを実行すると、配列内のすべての文字列値がUTF-8エンコードされた状態で表示されます。APIレスポンスの整形など、マルチバイト文字を扱う場面で特に有用です。

まとめ

array_mapを使えば、配列内のオブジェクトメソッドの呼び出しや値の変換を簡潔に記述できます。PHP 5.3以降なら無名関数でスッキリ書け、それ以前のバージョンでも名前付き関数で同様の処理が可能です。ただし、要素ごとの関数呼び出しによるオーバーヘッドがあるため、大規模データではパフォーマンスへの配慮も忘れないようにしましょう。