PHPの連想配列を実務で使う方法！ユーザー情報・商品データの管理例

新人と先輩の会話形式で理解しよう

新人

「連想配列を学ぶとき、サンプルを写すだけで終わらないようにしたいです。」

先輩

「それなら、一覧データを加工して表示する処理という具体例に置き換えて考えるといいですよ。使う値、処理、表示結果が見えると理解しやすくなります。」

新人

「コードのどこを変えれば応用できるかも知りたいです。」

先輩

「では、foreachを中心に、入力チェック、表示、関数化、ログまで順番に見ていきましょう。」

1. 一覧データを加工して表示する処理の元データを配列で用意する

連想配列は、用語だけを見ると難しく感じますが、実際には「どの値を受け取り、どの形へ整えて、どこへ表示または保存するか」を決める作業です。この記事では一覧データを加工して表示する処理を題材に、手を動かしながら流れを確認します。


<?php
$items = ["PHP基礎", "フォーム処理", "DB連携"];

foreach ($items as $item) {
    echo htmlspecialchars($item, ENT_QUOTES, "UTF-8") . "<br>";
}
?>

2. foreachで連想配列する処理を組み立てる

まずは最小コードで動きを見ます。大きな機能にする前に、foreach の役割、入力値、出力結果を小さく確認しておくと、あとでエラーが出たときにも原因を追いやすくなります。


<?php
$value = trim($_POST["value"] ?? "");
$errors = [];

if ($value === "") {
    $errors[] = "値を入力してください。";
}
if (mb_strlen($value, "UTF-8") > 100) {
    $errors[] = "100文字以内で入力してください。";
}

if ($errors) {
    foreach ($errors as $error) {
        echo htmlspecialchars($error, ENT_QUOTES, "UTF-8") . "<br>";
    }
}
?>

3. 件数・合計・平均など集計値を同時に作る

実務では、入力値が空だったり、想定外の文字列が入ったりします。ここを先にチェックしておくと、画面崩れ、DBエラー、意図しない処理をかなり減らせます。


<?php
function escapeHtml(string $value): string
{
    return htmlspecialchars($value, ENT_QUOTES, "UTF-8");
}

$rows = [
    ["title" => "PHPサンプル", "status" => "公開"],
    ["title" => "入力チェック", "status" => "確認中"],
];
?>

<table>
<?php foreach ($rows as $row): ?>
    <tr>
        <td><?php echo escapeHtml($row["title"]); ?></td>
        <td><?php echo escapeHtml($row["status"]); ?></td>
    </tr>
<?php endforeach; ?>
</table>

4. 空データや未分類を落とさない初期値の考え方

PHPで画面へ出す値は、基本的に表示直前でエスケープします。自分で用意した配列でも、将来フォームやDBから来る値へ変わる可能性があるため、安全な表示を習慣にします。


<?php
function normalizeText(?string $value): string
{
    $value = trim($value ?? "");
    return mb_convert_kana($value, "s", "UTF-8");
}

$keyword = normalizeText($_GET["keyword"] ?? "");
echo htmlspecialchars($keyword, ENT_QUOTES, "UTF-8");
?>

5. 加工した配列をHTMLテーブルに安全に表示する

同じ処理が2回以上出てきたら、関数化を考えます。短い関数へ切り出すと、名前から目的が分かり、テストや修正もしやすくなります。


<?php
try {
    $result = ["ok" => true, "message" => "処理が完了しました。"];
    if (!$result["ok"]) {
        throw new RuntimeException($result["message"]);
    }
} catch (Throwable $e) {
    error_log($e->getMessage());
    echo "エラーが発生しました。";
}
?>

6. array_reduceやusortで別の書き方も試す

エラー対策では、利用者へ見せるメッセージと、開発者が調査するログを分けます。画面にはやさしい文言、ログには日時やURLなど調査に必要な情報を残すと運用しやすくなります。


<?php
$log = [
    "time" => date("Y-m-d H:i:s"),
    "uri" => $_SERVER["REQUEST_URI"] ?? "",
    "ip" => $_SERVER["REMOTE_ADDR"] ?? "",
];

error_log(json_encode($log, JSON_UNESCAPED_UNICODE));
?>