[PHP]returnとは?関数から値を返し実行を終了する構文を徹底解説

PHP

はじめに

前回までの記事で、break と continue というループ制御構文を解説し、その比較の中で「return はループだけでなく関数全体を終了させる、より強い制御構文」という形で何度か触れてきました。今回は、この return を正面から取り上げます。

return は、関数やメソッドの実行をその場で終了させ、必要であれば呼び出し元に値を返すための構文です。PHPのほぼすべての関数定義で使われる、最も基本的でありながら、設計次第でコードの読みやすさを大きく左右する重要な構文でもあります。早期リターンによるガード節パターン、複数の戻り値(配列や分割代入との組み合わせ)、void 型宣言との関係など、押さえておくべきポイントが数多くあります。本記事では基本的な使い方から、実践的な活用パターンまで詳しく解説します。


構文概要

項目内容
構文名return
種別制御構造(言語構文)
基本構文return; または return 値;
戻り値なしreturn;(値を省略)または関数の末尾まで到達すると、暗黙的にnullを返す
使用場所関数・メソッド・クロージャ・無名関数の内部
実行後の挙動それ以降のコードは一切実行されず、即座に呼び出し元に制御が戻る
対応バージョンPHP 4以前から存在する最古参の構文の一つ

returnの基本動作(イメージ図)

  function add(int $a, int $b): int
  {
      $result = $a + $b;
      return $result;   ← ここで即座に関数の実行が終了する
      echo 'この行は絶対に実行されない'; ← 到達不能コード
  }

  $sum = add(3, 5);
              │
              ▼
  ┌───────────────────────────┐
  │ returnの時点で関数の実行が打ち切られ、    │
  │ 指定した値(この場合8)が                │
  │ 呼び出し元の式($sum = ...)に           │
  │ そのまま渡される                        │
  └───────────────────────────┘

ポイントは、return が実行された時点で、それ以降に続くコードは一切実行されないという点です。関数内のどこに書かれていても、return に到達した瞬間に関数の実行は終了します。


実践サンプル7選

例1:基本的な使い方

<?php

function multiply(int $a, int $b): int
{
    return $a * $b;
}

echo multiply(4, 5) . PHP_EOL; // 20

例2:早期リターンによるガード節パターン

<?php

function calculateDiscount(?int $price, bool $isMember): int
{
    /**
     * elseを使わず、条件に合致しない場合は早期リターンすることで
     * ネストを浅く保ち、コードの見通しを良くする
     */
    if ($price === null) {
        return 0;
    }

    if (!$isMember) {
        return $price;
    }

    return (int) ($price * 0.9);
}

echo calculateDiscount(1000, true) . PHP_EOL;  // 900
echo calculateDiscount(null, true) . PHP_EOL;  // 0

例3:値を返さないvoid型の関数

<?php

function logMessage(string $message): void
{
    echo '[LOG] ' . $message . PHP_EOL;

    if (empty($message)) {
        return; // 値を伴わないreturnで、処理をここで終了させる
    }

    echo '処理完了' . PHP_EOL;
}

logMessage('テストメッセージ');
logMessage('');

例4:配列を返して複数の値をまとめて渡す

<?php

function divideWithRemainder(int $dividend, int $divisor): array
{
    return [
        'quotient'  => intdiv($dividend, $divisor),
        'remainder' => $dividend % $divisor,
    ];
}

['quotient' => $q, 'remainder' => $r] = divideWithRemainder(17, 5);
echo "商: {$q}, 余り: {$r}" . PHP_EOL;

例5:ループ内の検索結果を見つけた時点で即座にreturnする

<?php

class UserRepository
{
    private array $users = [
        ['id' => 1, 'name' => '太郎'],
        ['id' => 2, 'name' => '花子'],
    ];

    /**
     * breakしてから変数を返すのではなく、
     * 見つかった時点で直接returnする方がシンプルになる
     */
    public function findById(int $id): ?array
    {
        foreach ($this->users as $user) {
            if ($user['id'] === $id) {
                return $user; // 見つかった時点で即座に関数を終了する
            }
        }

        return null; // 見つからなければnullを返す
    }
}

$repo = new UserRepository();
print_r($repo->findById(2));
var_dump($repo->findById(99));

例6:クロージャ内でのreturnは外側の関数に影響しない

<?php

function processItems(array $items): array
{
    $results = array_map(function (int $item) {
        if ($item < 0) {
            return 0; // これはクロージャ自体のreturn。processItems()は終了しない
        }
        return $item * 2;
    }, $items);

    return $results;
}

print_r(processItems([1, -2, 3, -4]));

例7:参照渡しで返すジェネレーター的な使い分け(通常の値返却との対比)

<?php

class StaticCounter
{
    private static int $count = 0;

    /**
     * メソッドチェーンを可能にするため、
     * 自分自身($this)を返すfluentインターフェースパターン
     */
    public function increment(): static
    {
        self::$count++;
        return $this; // 自分自身を返すことでメソッドチェーンが可能になる
    }

    public function getCount(): int
    {
        return self::$count;
    }
}

$counter = new StaticCounter();
echo $counter->increment()->increment()->increment()->getCount() . PHP_EOL; // 3

関連機能との比較

機能役割returnとの違い
return関数・メソッドの実行を終了し、値を返す本記事の対象。関数全体の制御フローを終わらせる
breakループやswitchを即座に抜ける関数全体ではなく、ループなどの範囲内にとどまる制御(別記事で解説済み)
continue現在の繰り返しをスキップし、次に進む関数を終了させず、ループの中で動作する点が異なる(別記事で解説済み)
yield(ジェネレーター)値を1つずつ順番に返す関数の実行を完全には終了させず、一時停止して値を返す点が大きく異なる
exit / dieスクリプト全体の実行を終了する関数の範囲を超えて、プログラム全体を停止させる、より強力な構文

よくある落とし穴(注意点)

  1. return以降のコードは完全に到達不能になる return の直後に書かれたコードは、どんな状況でも実行されません。多くの静的解析ツールやIDEは、この「到達不能コード(Unreachable code)」を警告してくれますが、リファクタリング時にうっかり残してしまうことがあるため注意しましょう。
  2. クロージャ・無名関数内のreturnは、その内部だけに影響する array_map() のコールバック関数内で return しても、それは外側の関数全体を終了させるわけではなく、あくまでそのクロージャ自体の戻り値を決めるだけです(例6を参照)。入れ子になった関数構造では、どの return がどの関数に対応するのかを正確に把握する必要があります。
  3. 戻り値の型を明示することで、意図しないnullの混入を防げる PHP 7.0以降、関数の戻り値の型を宣言できます(: int、: ?array など)。型を明示しておくことで、関数内のどこかで return を書き忘れた場合に TypeError として早期に検知でき、バグの温床になりがちな「暗黙のnull返却」を防げます。
  4. 早期リターンの使いすぎで、関数の出口が多くなりすぎることがある 早期リターンはネストを減らす有効な手法ですが、1つの関数内に return が非常に多く散らばると、「結局この関数は最終的に何を返すのか」を追うのが難しくなることがあります。関数の複雑さに応じて、適切なバランスを意識しましょう。
  5. void型の関数で値付きのreturnをすると型エラーになる 戻り値の型を void と宣言した関数の中で return 値; のように値を返そうとすると、TypeError が発生します。void 関数内では、値を伴わない return;(または何も書かずに関数末尾まで到達する)のみが許可されます(例3を参照)。

まとめ

観点まとめ
何をする構文か関数・メソッドの実行を即座に終了させ、必要に応じて呼び出し元に値を返す
主な用途計算結果の返却、早期リターンによるガード節、メソッドチェーンの実現($thisの返却)
戻り値なしreturn;または関数末尾への到達で、暗黙的にnullが返る(void型はこれが前提)
ループとの違いbreak/continueはループ内にとどまるが、returnは関数全体を終了させる
注意点return後の到達不能コード、クロージャ内のreturnのスコープ、void型との整合性

return は、PHPの関数が結果を呼び出し元に伝えるための、最も基本的で中心的な構文です。早期リターンによるガード節パターンを適切に使うことで、ネストの浅い読みやすいコードを書ける一方、戻り値の型宣言と組み合わせることで、バグを未然に防ぐ堅牢な関数設計にもつながります。

タイトルとURLをコピーしました