phpオブジェクト指向のコンストラクタ

Question

phpでオブジェクト指向の学習をしています

よく初学者向けのブログや書籍でコンストラクタを説明するコードで

<?php

class Staff {

public $name;
public $age;

public function __construct($name,$age) {
  $this->name = $name;
  $this->age = $age;
}
}

$tanaka = new Staff("tanaka",59);       
echo $tanaka->name;
echo $tanaka->age;

?>

こういったのを見るのですが
$nameと$ageが多くていささか混乱しています。
自分なりの解釈では

class Staff {
 
 public $name;
 public $age;

 public function __construct(**$name**,$age) {
   $this->name = **$name**;
   $this->age = $age;
 }

アスタリスクで囲われた&meiペアが同じもので
$this->nameと
public $name;
のペアが同じものなのかと思い
下記のようなコードに変えてみたらエラーなく出力ができました。
*$ageは割愛

<?php
class Staff {

  
  public $name;     //とりあえずクラス内に変数を作っただけ
  public $age;

  public function __construct($mei,$toshi) {
    $this->name = $mei;         //新しくインスタンス作ったときに（引数）の中の値を変数$meiに格納してインスタンス田中の変数nameに代入
    $this->age = $toshi;
  }
}

$tanaka = new Staff("tanaka",59);       //設計図スタッフから田中っていう変数2つ持ったインスタンス生成(引数で$meiと$toshiに渡す)

echo $tanaka->name;      //田中の変数name呼び出し
echo $tanaka->age;        //田中の変数age呼び出し
//tanaka59が表示
?>

この自分の解釈は間違っているでしょうか？
またもし合っていたとして
初学者向けの参考所でこのような混乱をきたすような書き方をされる理由など
なにかあると思うのですが
単に作法的なものなのか
クラスのプロパティ名とコンストラクタの引数名が
同じじゃないといけないみたいな理由があるのでしょうか？

またコメントアウトで自分用のメモとして解釈を書き加えたのですが
このメモの解釈で合っていますでしょうか？
よろしければ回答ください

Answer 1

これはクラスじゃなくて単なる関数の場合でも、ですが、同じじゃなければいけない理由はないです。
aとかbとかでも良いです。数さえ合ってれば。
ただ、コメントでも書かれているようにクラスは設計書、ですが、
あくまで機能を提供するだけなのでどこからどう使われるかどうか知りません。渡された情報を正直に設計通りに処理をしているだけです。
つまり、外から来る情報が何かは知らないわけですね。１番目に何を渡してね、２番目に何を渡してね、とはしていますが。
ということは受け取った情報をプロパティと同じ名称にしておいた方が設計書における混乱が少ないわけです。

変数名とは言っても英単語や日本語ローマ字として意味があるわけではなく単なるアルファベットと数字の羅列です。一字でも違ったら(大文字小文字すらも)それは別物として扱われるのがプログラミングの世界なので、合わせておくのが妥当です。

蛇足。
初心者向けの書籍で出版や対象バージョンが古ければ載っていないかもしれませんが、「型宣言」というものがあり、引数や返り値の型をチェックする機能もあります。←はわりかし新しい機能ですが、
結構古くからある「デフォルト引数」という機能もあります。

先に書きましたようにクラス側、メソッド側は「どう使われるか知らない」ので、こういった機能を使ってより厳格な設計、コーディングを心がけると良いと思います。

Comments

[maisumakun]

本題ではありませんが、PHPは「関数名の大文字小文字は区別しない」「定数は、作成時に大文字小文字を区別するか選べる」など、大文字小文字の区別に関して一貫しない仕様となっています。

https://qiita.com/tadsan/items/6c6329eeb43929271119

もっとも、「区別されるつもりだったけど実は区別されなかった」で困るパターンが「大文字小文字の違いだけで同じ名前を作ろうとしていた場合」程度なので、区別されることを前提に動けば大問題にならないとは思います。

[m.ts10806]

そうなんですよね。そこで動いてしまうところが怖いところで、
「関数名が関係なく出来るから変数も大丈夫だろ」でやってしまう初心者がそれなりにいそうに思います。
そういう仕様はそろそろ滅びればいいのに・・・と思い続けて何年も経ってます。
「定義したものはコピペで使いましょう」を徹底するのが最も間違いないと思ってます。

Answer 2

理解はあっていると思います。

こう書くのは、変数はその内容を適切に表現する英語で表記するのが普通だからです。日本語の例で考えたとき、meiではなくseiとしたとき姓か性かわからなくなります。
実用上、むしろ同じ名前にしたほうが便利だと思うのですが。