はじめに
前回までの記事で、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 | スクリプト全体の実行を終了する | 関数の範囲を超えて、プログラム全体を停止させる、より強力な構文 |
よくある落とし穴(注意点)
return以降のコードは完全に到達不能になるreturnの直後に書かれたコードは、どんな状況でも実行されません。多くの静的解析ツールやIDEは、この「到達不能コード(Unreachable code)」を警告してくれますが、リファクタリング時にうっかり残してしまうことがあるため注意しましょう。- クロージャ・無名関数内の
returnは、その内部だけに影響するarray_map()のコールバック関数内でreturnしても、それは外側の関数全体を終了させるわけではなく、あくまでそのクロージャ自体の戻り値を決めるだけです(例6を参照)。入れ子になった関数構造では、どのreturnがどの関数に対応するのかを正確に把握する必要があります。 - 戻り値の型を明示することで、意図しない
nullの混入を防げる PHP 7.0以降、関数の戻り値の型を宣言できます(: int、: ?arrayなど)。型を明示しておくことで、関数内のどこかでreturnを書き忘れた場合にTypeErrorとして早期に検知でき、バグの温床になりがちな「暗黙のnull返却」を防げます。 - 早期リターンの使いすぎで、関数の出口が多くなりすぎることがある 早期リターンはネストを減らす有効な手法ですが、1つの関数内に
returnが非常に多く散らばると、「結局この関数は最終的に何を返すのか」を追うのが難しくなることがあります。関数の複雑さに応じて、適切なバランスを意識しましょう。 void型の関数で値付きのreturnをすると型エラーになる 戻り値の型をvoidと宣言した関数の中でreturn 値;のように値を返そうとすると、TypeErrorが発生します。void関数内では、値を伴わないreturn;(または何も書かずに関数末尾まで到達する)のみが許可されます(例3を参照)。
まとめ
| 観点 | まとめ |
|---|---|
| 何をする構文か | 関数・メソッドの実行を即座に終了させ、必要に応じて呼び出し元に値を返す |
| 主な用途 | 計算結果の返却、早期リターンによるガード節、メソッドチェーンの実現($thisの返却) |
| 戻り値なし | return;または関数末尾への到達で、暗黙的にnullが返る(void型はこれが前提) |
| ループとの違い | break/continueはループ内にとどまるが、returnは関数全体を終了させる |
| 注意点 | return後の到達不能コード、クロージャ内のreturnのスコープ、void型との整合性 |
return は、PHPの関数が結果を呼び出し元に伝えるための、最も基本的で中心的な構文です。早期リターンによるガード節パターンを適切に使うことで、ネストの浅い読みやすいコードを書ける一方、戻り値の型宣言と組み合わせることで、バグを未然に防ぐ堅牢な関数設計にもつながります。
