PHPのreturnステートメント（return文）の使い方を徹底解説

はじめに

PHPにおけるreturn文の目的は、プログラムの実行制御を呼び出し元の環境へ返すことです。returnが実行されると、関数やモジュールを呼び出していた式の次から処理が再開されます。

return文が関数の内部で実行されると、その時点で現在の関数の実行は終了し、制御は呼び出し元の環境へ引き渡されます。また、return文には式をオプションとして指定できます。この場合、制御とともにその式の評価結果（値）も呼び出し元へ返されます。

includeなどで読み込まれたスクリプト内でreturn文に到達すると、そのスクリプトの実行は直ちに終了し、制御はインクルード元のスクリプトへ戻ります。一方、トップレベルのスクリプト自体にreturn文がある場合は、実行がそこで終了し、制御はOSへ返されます。

関数内でのreturn

以下の例は、関数内でのreturn文の基本的な動作を示しています。

例

<?php
function SayHello(){
   echo "Hello World!\n";
}
echo "before calling SayHello() function\n";
SayHello();
echo "after returning from SayHello() function";
?>

出力結果

このコードを実行すると、次のような結果になります。

before calling SayHello() function
Hello World!
after returning from SayHello() function

値を返すreturn

次の例では、関数が式の値をreturn文で返しています。引数として受け取った数値の2乗を計算して呼び出し元に渡します。

例

<?php
function square($x){
   return $x**2;
}
$num=(int)readline("enter a number: ");
echo "calling function with argument $num\n";
$result=square($num);
echo "function returns square of $num = $result";
?>

出力結果

入力として「0」を与えた場合の出力例です。

calling function with argument 0
function returns square of 0 = 0

インクルードされたファイルでのreturn

return文はincludeで読み込まれたファイル内でも有効です。次の例では、test.php内のreturn文によって処理が中断され、制御がメインスクリプトへ戻ります。return以降のコードは実行されません。

例

//main script
<?php
echo "inside main script\n";
echo "now calling test.php script\n";
include "test.php";
echo "returns from test.php";
?>
//test.php included
<?php
echo "inside included script\n";
return;
echo "this is never executed";
?>

出力結果

メインスクリプトをコマンドラインから実行すると、次のようになります。

inside main script
now calling test.php script
inside included script
returns from test.php

インクルードファイルから値を返す

インクルードされるファイルでも、return文の前に式を置くことができます。次の例では、test.phpが文字列をメインスクリプトへ返し、メイン側ではincludeの戻り値を受け取って表示しています。

例

//main script
<?php
echo "inside main script\n";
echo "now calling test.php script\n";
$result=include "test.php";
echo $result;
echo "returns from test.php";
?>
//test.php included
<?php
$var="from inside included script\n";
return $var;
?>

出力結果

実行すると、次のような結果が得られます。

inside main script
now calling test.php script
from inside included script
returns from test.php

まとめ

return文は、関数の実行を終了して値を返すだけでなく、includeされたファイルの処理を途中で打ち切り、制御を呼び出し元へ戻す役割も担います。設定ファイルや設定配列をincludeで読み込み、returnで返すパターンはPHPの実務でも広く使われているため、しっかり理解しておきましょう。