導入
PHPでの開発において、関数の戻り値は通常1つだけです。しかし、実務では「処理の成否（真偽値）」を戻り値として返しつつ、同時に「エラーメッセージ」や「詳細な計算結果」といった別の情報も取得したい場面が多々あります。このような課題を解決するために、PHPでは参照渡しを利用するのが非常に効果的です。本記事では、この手法の実装方法と、現場で役立つ活用テクニックを解説します。
基礎知識
通常、PHPの関数に引数を渡すと、その値はコピーされて関数内で扱われます。これを「値渡し」と呼びます。一方、変数の前に「&」を付けることで、その変数のメモリ上の場所（参照）を直接渡すことができます。これを「参照渡し」と呼びます。参照渡しを用いると、関数内で行った変数への変更が、関数外の元の変数にも直接反映されるため、複数の値を出力したい場合に非常に便利です。
実装/解決策
具体的な実装では、関数の引数リストにおいて「&$変数名」と記述します。また、実務的なポイントとして、不要な場合にエラーにならないよう「デフォルト値（nullなど）」を設定しておくことが重要です。これにより、呼び出し側は結果を受け取りたい時だけ引数を指定すればよくなり、コードの柔軟性が向上します。
サンプルプログラム
以下のコードは、APIのレスポンスやバリデーション処理を想定した、実務でよく使われるパターンです。
/
function validateUser(string $username, ?string &$error = null): bool
{
if (empty($username)) {
// 参照渡しした変数に値を代入
$error = ‘ユーザー名が空です。’;
return false;
}
if (strlen($username) < 3) { $error = 'ユーザー名は3文字以上必要です。'; return false; } return true; } // 呼び出し例1: エラー内容も受け取る場合 $user = 'a'; if (!validateUser($user, $errorMessage)) { echo "バリデーション失敗: " . $errorMessage . PHP_EOL; } // 呼び出し例2: 結果の真偽値だけが必要な場合（第2引数を省略） if (validateUser('taro')) { echo "バリデーション成功" . PHP_EOL; } ?>
応用・注意点
参照渡しは非常に強力ですが、乱用には注意が必要です。コードの可読性を保つための注意点を以下にまとめました。
1. 副作用への注意: 参照渡しは関数の外側の変数を書き換えるため、どこで値が変わったのか追跡が難しくなることがあります。多用しすぎるとスパゲッティコードの原因になります。
2. 戻り値との使い分け: 複数の値を返したい場合、現代的なPHPでは「配列」や「データクラス（DTO）」を戻り値として返す方が、コードの意図が明確になることも多いです。
3. デフォルト値の指定: サンプルコードのように「&$error = null」とすることで、関数呼び出し時に引数を省略できるため、APIの互換性を保ちやすくなります。
「どの変数に結果を格納するか」を呼び出し側が決定できるこの設計パターンは、ライブラリ開発や複雑なバリデーション処理などで非常に有用ですので、ぜひ活用してみてください。