PHPで関数を小さく分ける方法！保守しやすい処理分割の基本

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

新人

「関数を小さく分ける方法を学ぶとき、サンプルを写すだけで終わらないようにしたいです。」

先輩

「それなら、繰り返す処理を小さな関数へ分ける練習という具体例に置き換えて考えるといいですよ。使う値、処理、表示結果が見えると理解しやすくなります。」

新人

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

先輩

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

1. 繰り返す処理を小さな関数へ分ける練習で関数に分ける処理を見つける

関数を小さく分ける方法は、用語だけを見ると難しく感じますが、実際には「どの値を受け取り、どの形へ整えて、どこへ表示または保存するか」を決める作業です。この記事では繰り返す処理を小さな関数へ分ける練習を題材に、手を動かしながら流れを確認します。


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

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

2. PHPを使った小さな関数の基本形

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


<?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. 例外を投げる関数と結果を返す関数を分ける

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


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

6. コールバックや再帰を使う場面を見極める

エラー対策では、利用者へ見せるメッセージと、開発者が調査するログを分けます。画面にはやさしい文言、ログには日時や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));
?>