【PHP】【初心者】値渡しと参照渡し

##値渡しってなんぞ
関数を呼ぶとき、引数って使いますよね。
このとき、呼び出した先に渡された値は、呼び出し元の変数をコピーして使っています。
つまり、呼び出し先の関数でこの引数を変更しても、呼び出し元にはまったく影響がないということです。

public function start()
{
	$number = 10;

	// 上記の変数を使って関数を呼びます
	$this->oneUp($number);

	echo '3:' , $number, ' 関数の後、呼び出し元の値', PHP_EOL;
}

private function oneUp(int $number)
{
	echo '1:', $number, ' これが関数に渡された値', PHP_EOL;

	$number += 1;

	echo '2:', $number, ' 引数に１を足した値', PHP_EOL;
}

実行結果

1:10 これが関数に渡された値
2:11 引数に１を足した値
3:10 関数の後、呼び出し元の値

「3:」の値が変化していないことから、コピーであることがわかります。
これを値渡しと言います。

##値渡しで進める通常の処理
せっかく関数で増やしたんだから呼び出し元でも使いたいよ、というとき、
人は呼び出し元で「別の変数」として受け取ります。

public function start()
{
	$number = 10;

	// 左辺で別変数を指定する
	$oneUpNumber = $this->oneUp($number);

	echo '3:' , $oneUpNumber, ' 関数の後、呼び出し元で受け取った値', PHP_EOL;
}

private function oneUp(int $number)
{
	echo '1:', $number, ' これが関数に渡された値', PHP_EOL;

	$number += 1;

	echo '2:', $number, ' 引数に１を足した値', PHP_EOL;

	// 呼び出し先でもreturnで値を返す
	return $number;
}

実行結果

1:10 これが関数に渡された値
2:11 引数に１を足した値
3:11 関数の後、呼び出し元で受け取った値

こんな感じで、通常は処理を進めます。

##参照渡し
ところが、こういった手順を踏まなくても、
呼び出し先で、呼び出し元の値を書き換えてしまう渡し方があります。
それが参照渡しです。

public function start()
{
	$number = 10;

	// 上記の変数を使って関数を呼びます
	$this->oneUp($number);

	echo '3:' , $number, ' 関数の後、呼び出し元の値', PHP_EOL;
}

// 受け取った引数の頭に&をつける
private function oneUp(int &$number)
{
	echo '1:', $number, ' これが関数に渡された値', PHP_EOL;

	$number += 1;

	echo '2:', $number, ' 引数に１を足した値', PHP_EOL;
}

実行結果

1:10 これが関数に渡された値
2:11 引数に１を足した値
3:11 関数の後、呼び出し元の値

関数で受け取った引数の頭に「&」をつけたことで「3:」の値が変化しました。
呼び出し先の関数でも呼び出し元の変数(メモリアドレス)を「参照」しているからです。

##ここが大事な注意点
ところが、ソースの中でこういった参照渡しが存在すると、
「あれ、変数の値が途中でいつの間にか変わってる？？？」
という混乱の元になります。
同じ名前の変数が処理の前後で値が変わっていてしまうと、
そのことに大変気付きにくいので、大災害の火種になりかねません。

関数で値を変えて、それを使いたいのであれば別の変数として受け取りましょう。

ちなみにPHPではオブジェクトはデフォルトで参照渡しです。これも注意しましょう。
追記
デフォルトで参照渡しというのは間違いです。こちらの記事参照。
同じ方の&(リファレンス)の使い方の記事も参考になりました。