配列

PHPのarray_map関数による配列操作の基本と応用について解説

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

PHP の array_map関数は、配列の各要素に同じ処理を適用し、新たな配列を生成する機能を提供します。

コールバック関数を指定することで、各要素の変換やフィルタリングが簡潔に実現でき、コードの可読性向上にも寄与します。

この記事では、基本的な使い方や具体的な実例を通して、array_map の便利な活用方法を解説します。

目次から探す

PHP array_map関数の基本構文
- パラメータの役割
- シンプルな使用例
複数配列の処理方法
- 複数引数の入力方法
- 並列処理の実例
配列変換の実例
- 文字列配列の変換例
- 数値データの変換例
エラー処理と検証方法
- コールバック関数のエラーチェック
- 開発環境での動作確認
まとめ

PHP array_map関数の基本構文

パラメータの役割

コールバック関数の設定方法

array_map関数では、最初の引数にコールバック関数を指定します。

このコールバック関数は、配列の各要素に対して行う処理を記述するためのものです。

無名関数や、既に定義された関数名(文字列)を指定することが可能です。

例えば、無名関数を用いる場合、以下のように記述できます。

<?php
$input = [1, 2, 3]; // 入力配列
$output = array_map(function($value) {
    // 各要素を2倍にする処理
    return $value * 2;
}, $input);
echo implode(', ', $output);  // 結果をカンマ区切りで表示
?>

2, 4, 6

対象配列の指定方法

array_map関数の第二引数以降には、操作したい対象の配列を指定します。

指定された配列の全要素が、コールバック関数に渡されて処理されます。

複数の配列を渡す場合、各配列の同じ位置にある要素を同時に処理して結果を返します。

シンプルな使用例

無名関数を使った例

無名関数を用いる例では、配列の各要素に対して動的に処理を実行することができます。

以下は、入力配列の要素を2倍にする例です。

<?php
// 入力配列
$numbers = [1, 2, 3, 4];
// 各要素に2倍する無名関数を使用
$doubledNumbers = array_map(function($num) {
    return $num * 2;
}, $numbers);
// 結果を表示
echo implode(', ', $doubledNumbers);
?>

2, 4, 6, 8

定義済み関数を用いた例

既存の関数を利用して処理を行う場合、関数名を直接指定することで同様の処理が可能です。

以下は、ユーザー定義関数を使って配列の各要素を2倍にする例です。

<?php
// 2倍にする関数を定義
function multiplyByTwo($value) {
    return $value * 2;
}
// 入力配列
$numbers = [5, 10, 15];
// 定義済み関数を指定して配列を処理
$result = array_map('multiplyByTwo', $numbers);
// 結果を表示
echo implode(', ', $result);
?>

10, 20, 30

複数配列の処理方法

複数引数の入力方法

戻り値の配列構造の詳細

array_map関数は、複数の配列を入力として受け取ることができます。

コールバック関数は各配列の同位置にある要素を引数として受け取ります。

戻り値は、最初の配列と同じキーを持つ配列として返されます。

以下は、2つの配列の要素を足し合わせる例です。

<?php
// 複数の入力配列
$array1 = [1, 2, 3];
$array2 = [10, 20, 30];
// 配列の同位置の要素を足し合わせる処理
$result = array_map(function($a, $b) {
    return $a + $b;
}, $array1, $array2);
// 結果を表示
echo implode(', ', $result);
?>

11, 22, 33

並列処理の実例

配列間の対応付け方法

複数配列を同時に処理する場合、同じインデックスの値が自動的に対応付けられてコールバック関数に渡されます。

以下の例では、名前の配列と年齢の配列を組み合わせ、各要素をフォーマットして表示します。

<?php
// 名前と年齢の入力配列
$names = ['Alice', 'Bob', 'Charlie'];
$ages  = [25, 30, 35];
// 同じインデックスの要素を結合する処理
$combined = array_map(function($name, $age) {
    return $name . ' (' . $age . ')';
}, $names, $ages);
// 結果を表示
echo implode(' | ', $combined);
?>

Alice (25) | Bob (30) | Charlie (35)

配列変換の実例

文字列配列の変換例

文字列操作を組み込んだ例

文字列に対して、例えば最初の文字を大文字に変換するような処理を行うことが可能です。

以下は、各文字列の先頭文字を大文字化する例です。

<?php
// 入力となる文字列配列
$fruits = ['apple', 'banana', 'cherry'];
// 各文字列の先頭文字を大文字に変換する処理
$capitalizedFruits = array_map(function($fruit) {
    return ucfirst($fruit);
}, $fruits);
// 結果を表示
echo implode(', ', $capitalizedFruits);
?>

Apple, Banana, Cherry

数値データの変換例

演算処理を加えた例

数値データに対して計算処理を加える場合、配列の各要素に対して数式を適用することができます。

例えば、各要素の平方を求める例は以下の通りです。

<?php
// 入力となる数値配列
$numbers = [3, 6, 9];
// 各数値の平方を求める処理
$squaredNumbers = array_map(function($num) {
    // \( num^2 \) の計算を行う
    return $num ** 2;
}, $numbers);
// 結果を表示
echo implode(', ', $squaredNumbers);
?>

9, 36, 81

エラー処理と検証方法

コールバック関数のエラーチェック

例外発生時の対応方法

コールバック関数内で不正な値や意図しない値が渡された場合、例外を発生させることが可能です。

例外処理を利用することで、エラー発生時に適切な処理を行うことができます。

以下の例では、ゼロが入力された場合に例外を発生させる処理を実装しています。

<?php
try {
    // 入力となる配列(ゼロが含まれる)
    $values = [1, 2, 0, 4];
    // ゼロの場合に例外を発生させる処理を実行
    $results = array_map(function($value) {
        if ($value === 0) {
            throw new Exception('ゼロは処理できません');
        }
        return 10 / $value;
    }, $values);
    print_r($results);
} catch (Exception $e) {
    // エラーメッセージを表示
    echo 'エラーが発生しました: ' . $e->getMessage();
}
?>

エラーが発生しました: ゼロは処理できません

開発環境での動作確認

注意すべきポイント

開発環境では、エラーメッセージや警告が表示されるように設定して、意図しない動作を早期に発見できるようにすることが重要です。

PHPのエラー報告設定を調整するために、以下のサンプルコードのように設定を行うとよいでしょう。

<?php
// 全てのエラーを表示する設定
error_reporting(E_ALL);
ini_set('display_errors', 1);
// 動作確認のためのサンプル処理
$data = [2, 4];
$result = array_map('strval', $data); // 数値を文字列へ変換
print_r($result);
?>