【PHP】全ボクが実務で泣いた「値渡し」と「参照渡し」を完！全！理！解！

#はじめに
**先日、仕事（PHPでのWebアプリ開発）で連想配列の中身を加工していたのですが30分程全然うまく行かなかったので、先輩に聞いたら<font color='red'>3分</font>くらいで解決しました。**

結論、解決方法としては**「値渡しではなく<font color='red'>"参照渡し"</font>を使う」**でした。

これまで何となく聞いたことがあったけど「絶対ムズイからイヤッ！！！:persevere:」と目を背けていた**"参照渡し"**について、これを機にちゃんと理解しようと思ったのでまとめます。
（てかそろそろ理解しておかないとヤバイという危機感w）

~~あと...
<font color='blue'>**「これ、参照渡ししてあげるとオッケーですよ」**</font>
ってスマートに言えたらカッコよくないですか？~~

↑カッコ良いですけど、参照渡し自体はむやみに使わない方が良いので一応取り消し（笑）
（正しくはコメントをいただいたので削除しました）

というわけで書きます。

#この記事でわかること

- **値渡し**
- **参照渡し**

特に僕と同じように**「参照渡しから目を背けてきた方」**や、**「そもそも参照渡しってなーに？」**って方に読んで欲しいですね。

読めば絶対に理解できます！！！

#直面した問題
仕事のコードをそのまま使うことはできないので、簡単に再現してみます。

以下のコードをご覧ください。

```php
<?php

// 配列を2つ定義
$members = [
    'Aさんの好きな果物' => [
        'りんご' => 'apple',
        'ぶどう' => 'grape',
        'バナナ' => 'banana',
    ],
    'Bさんの好きな果物' => [
        'マンゴー' => 'mango',
        'パイナップル' => 'pineapple',
        'ドラゴンフルーツ' => 'dragon fruit',
    ],
];
$fruits = [
    'ざくろ' => 'pomegranate',
    'オレンジ' => 'orange',
    'もも' => 'peach',
];

// $membersに$fruitsの要素を追加
foreach ($members as $member) {
    $member['ざくろ'] = $fruits['ざくろ'];
    $member['もも'] = $fruits['もも'];
}

// 配列を出力
var_dump($members);
```
AさんとBさんについてそれぞれ好きな果物を`$members`に定義しています。
Bさんは多分、多分なんですけど沖縄の方な気がしてます。

そして、`$fruits`という果物を3つ入れた連想配列も定義。

次に、`foreach`の中でAさん、Bさんの好きな果物に`$fruits`から2つ追加しています。

それでは、`var_dump`した時の出力結果がどうなっているのかというと

```php
array(2) {
  ["Aさんの好きな果物"]=>
  array(3) {
    ["りんご"]=>
    string(5) "apple"
    ["ぶどう"]=>
    string(5) "grape"
    ["バナナ"]=>
    string(6) "banana"
  }
  ["Bさんの好きな果物"]=>
  array(3) {
    ["マンゴー"]=>
    string(5) "mango"
    ["パイナップル"]=>
    string(9) "pineapple"
    ["ドラゴンフルーツ"]=>
    string(12) "dragon fruit"
  }
}
```
あれ？
...定義した時の`$members`のままなんですよね。

Bさんは相変わらず沖縄の人。（多分ですけどね）

本当はこうなって欲しい。

```php
array(2) {
  ["Aさんの好きな果物"]=>
  array(5) {
    ["りんご"]=>
    string(5) "apple"
    ["ぶどう"]=>
    string(5) "grape"
    ["バナナ"]=>
    string(6) "banana"
    ["ざくろ"]=>
    string(11) "pomegranate"
    ["もも"]=>
    string(5) "peach"
  }
  ["Bさんの好きな果物"]=>
  array(5) {
    ["マンゴー"]=>
    string(5) "mango"
    ["パイナップル"]=>
    string(9) "pineapple"
    ["ドラゴンフルーツ"]=>
    string(12) "dragon fruit"
    ["ざくろ"]=>
    string(11) "pomegranate"
    ["もも"]=>
    string(5) "peach"
  }
}
```

仕事では連想配列に要素が追加できず、必須に**タイポ**がないかめっちゃ探してました。
が、原因は全然違うところにあったのです...

どうすればいいのかというとコチラ！ドン！

```php
<?php

// 配列を2つ定義
$members = [
    'Aさんの好きな果物' => [
        'りんご' => 'apple',
        'ぶどう' => 'grape',
        'バナナ' => 'banana',
    ],
    'Bさんの好きな果物' => [
        'マンゴー' => 'mango',
        'パイナップル' => 'pineapple',
        'ドラゴンフルーツ' => 'dragon fruit',
    ],
];
$fruits = [
    'ざくろ' => 'pomegranate',
    'オレンジ' => 'orange',
    'もも' => 'peach',
];

// $membersに$fruitsの要素を追加
// $memberの前に&をつける→参照渡しにする
foreach ($members as &$member) {
    $member['ざくろ'] = $fruits['ざくろ'];
    $member['もも'] = $fruits['もも'];
}

// 配列を出力
var_dump($members);
```

どこを変えたかというとコチラ！ドン！

```php
// $membersに$fruitsの要素を追加
// $memberの前に&をつける→参照渡しにする
foreach ($members as &$member) {
    $member['ざくろ'] = $fruits['ざくろ'];
    $member['もも'] = $fruits['もも'];
}
```

`$member`の前に`&`をつけて`&$member`にしてあげると参照渡しになり、問題解決なのです...

ちなみに実際に出力結果はコチラ！ドン！

```php
array(2) {
  ["Aさんの好きな果物"]=>
  array(5) {
    ["りんご"]=>
    string(5) "apple"
    ["ぶどう"]=>
    string(5) "grape"
    ["バナナ"]=>
    string(6) "banana"
    ["ざくろ"]=>
    string(11) "pomegranate"
    ["もも"]=>
    string(5) "peach"
  }
  ["Bさんの好きな果物"]=>
  &array(5) {
    ["マンゴー"]=>
    string(5) "mango"
    ["パイナップル"]=>
    string(9) "pineapple"
    ["ドラゴンフルーツ"]=>
    string(12) "dragon fruit"
    ["ざくろ"]=>
    string(11) "pomegranate"
    ["もも"]=>
    string(5) "peach"
  }
}
```

ちゃんとAとBさんの要素に2つの要素（ざくろ、もも）が追加されていますね。
これでBさんの沖縄感も少し薄まりましたね。

（てかざくろって英語で`pomegranate`なんだ。読み方わかんない）

ここまで来たけど

「というか！！何！！**参照渡し**って！？」って話。

ハイ、詳しく見ていきましょう。

#値渡し
値渡しは関数の引数や変数を扱う上で**デフォルト**の考え方です。
何もしない（＝参照渡しに変更しない）場合は、値渡しになります。 

適当に書いてみましょう。

```php
<?php

//変数を定義
$number = 1;

//関数を定義
function addNumber($num) {
    $num += 99;
    echo $num;
}

//関数を実行
addNumber($number);

//変数を出力
var_dump($number);
```

ハイ、こちらの結果はこうなります。

```
//addNumber()の中のechoの出力
100
//var_dumpの出力
int(1)
```

ですよね。
（`var_dump`で出力した場合はデータの型も表示されます。今回だと数字なので（int）型）

まあハイハイ、って感じですよね。

これが値渡しです。

これ、どういう流れで処理を行っているかというと

![値渡し.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/512695/25dab6f4-391e-ac1e-a4fa-18177153a10e.jpeg)


```php

addNumber($number)
```

で、`addNumber`関数の仮引数として設定した`$num`に`$number`を渡していますが、渡しているのは

```php
$number = 1;
```
の`1`という数字の値だけってこと。**値**だけを**渡す**から<font color='red'>**値渡し**</font>。ナルホド。

（僕、今書きながら改めてナルホド！ってなってます）

なので

```php
//関数を定義
function addNumber($num) {
    $num += 99;
    echo $num;
}
```

で99を足しているけど、渡しているのは1という数字だけだから、その後の

```php
var_dump($number);
```

では**定義した時の1**がそのまま出力されるってことですね。完！全！理！解！

#参照渡し
参照渡しについて公式ドキュメントを見てみましょう。

>リファレンスにより関数に変数を渡すことが可能です。この場合、関数内で その引数を修正可能になります。構文は次のようになります。

引用元：[リファレンス渡し](https://www.php.net/manual/ja/language.references.pass.php)

ハイ、意味不明。

じゃあさっき**値渡し**の説明で使ったコードで参照渡ししてみましょう。

```php
<?php

//変数を定義
$number = 1;

//関数を定義
//仮引数$numの前に&をつける
function addNumber(&$num) {
    $num += 99;
    echo $num;
}

//関数を実行
addNumber($number);

//変数を出力
var_dump($number);
```

では出力結果！ドン！

```
//addNumber()の中のechoの出力
100
//var_dumpの出力
int(100)
```

つまり

`var_dump`した出力結果が`int(100)`、つまり**100**になっちゃってるってことですね。

ということでここで詳しく理解していきます。

まず、どういう流れで処理を行っているかというと

![参照渡し.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/512695/538e8840-82f5-d000-ef77-9106525d7da0.jpeg)

こんな感じです。
（正式にはちょっと違うのかもしれませんがわかりやすくまとめました）

値渡しは**「変数の値（文字列、数字など）を仮引数に渡す」**ことでしたが、参照渡しは<font color='red'>**「変数自体を渡す」**</font>ことです。

（ググったら**「変数のメモリ番地を渡す渡し方」**と書いてましたが、多くの方にとってはちょっと難しい言い回しかと）

一応リンクだと貼っておきます。
[値渡しと参照渡しの違いを理解する](https://magazine.rubyist.net/articles/0032/0032-CallByValueAndCallByReference.html#:~:text=%E3%80%8C%E5%80%A4%E6%B8%A1%E3%81%97%E3%80%8D%E3%81%A8%E3%80%8C%E5%8F%82%E7%85%A7,%E3%82%88%E3%81%86%E3%81%AA%E6%B8%A1%E3%81%97%E6%96%B9%E3%81%A7%E3%81%99%E3%80%82)

値渡しと同じ手順ですが、

```php

addNumber($number)
```

で、`addNumber`関数の仮引数として設定した`$num`に`$number`を渡していますが、渡しているのは

```php
$number = 1;
```
の`$number = 1`自体、つまり**「numberという変数が数字の1という値を持っていますよ〜」**という情報を渡しているんですね。

なので

```php
//関数を定義
function addNumber(&$num) {
    $num += 99;
    echo $num;
}
```

で99を足しているのは`$number`に格納されている数字です。
つまり、`$number`の値が`100`に上書きされているっていうことになります。

というわけで

```php
var_dump($number);
```

では1に99を足した**100**が出力されるわけですね。完！全！理！解！

#以上をふまえて
値渡しと参照渡しを理解した上で最初のコードに戻ります。

```php
// 配列を2つ定義
$members = [
    'Aさんの好きな果物' => [
        'りんご' => 'apple',
        'ぶどう' => 'grape',
        'バナナ' => 'banana',
    ],
    'Bさんの好きな果物' => [
        'マンゴー' => 'mango',
        'パイナップル' => 'pineapple',
        'ドラゴンフルーツ' => 'dragon fruit',
    ],
];
$fruits = [
    'ざくろ' => 'pomegranate',
    'オレンジ' => 'orange',
    'もも' => 'peach',
];

// $membersに$fruitsの要素を追加
// $memberの前に&をつける→参照渡しにする
foreach ($members as &$member) {
    $member['ざくろ'] = $fruits['ざくろ'];
    $member['もも'] = $fruits['もも'];
}

// 配列を出力
var_dump($members);
```

つまりこんなことが起こってる。（画質悪くてスミマセン）
![参照渡し-2.jpg](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/512695/d5c9dddc-7201-82bf-4d3c-d4b2046de261.jpeg)

```php
foreach ($members as &$member) {
```

の`&$member`には`$members`の各要素が入るので、

1回目は

```php
'Aさんの好きな果物' => [
    'りんご' => 'apple',
    'ぶどう' => 'grape',
    'バナナ' => 'banana',
]
```

2回目は

```php
'Bさんの好きな果物' => [
    'マンゴー' => 'mango',
    'パイナップル' => 'pineapple',
    'ドラゴンフルーツ' => 'dragon fruit',
]
```
になりますよね。

その**各要素（連想配列）自体の情報が格納されるので好きな果物にざくろとももが追加（＝上書き）されて`var_dump`で追加された状態で出力することができる**ってわけですね。ふむふむ。

#おわり

値渡しと参照渡しのそれぞれの考え方を説明しました。
僕なりに初学者にもわかりやすくまとめることができたんじゃないかと思います。

※明らかにおかしいところあればぜひコメントをいただけると幸いですm(__)m

「内容がよかった！」と思っていただけましたら***<font color="green">LGTM</font>***をしてくださると嬉しいです:sob:


以上です。

P.S.
この記事を書いている途中に別の先輩から**参照渡しをせずに連想配列の中身を書き換えるワザ**を教えてもらったので、別の記事にまとめます。
~~投稿したらここにリンク貼ります。~~

投稿しました↓
[【PHP】リファレンスの使用（≒参照渡し）をせずに配列の中身をイジろう](https://qiita.com/shimotaroo/items/c4648d5c0a3cfad59792)

（というか参照渡し使ってたらその後の処理が上手くいかず最終的に上記の方法で実装しました）

なお、コメント欄を見ていただけるとわかりますが、**参照渡し自体はできれば使わない方がいい**みたいです。理由についてもコメントに書いていただいているので参照くださいm(__)m