PHPクラスのプロパティとは？宣言方法とアクセス方法をわかりやすく解説

はじめに

クラスの中で宣言されたデータメンバーは「プロパティ」と呼ばれます。プロパティは「属性（アトリビュート）」や「フィールド」という名称で参照されることもあります。

PHPでは、プロパティは必ず public、private、protected のいずれかのアクセス修飾子キーワードを付けて宣言します。プロパティ名には、PHPで有効な任意のラベルを使用できます。また、プロパティの値はクラスの各インスタンスごとに異なる値を持つことができるため、「インスタンス変数」と呼ばれることもあります。

任意のインスタンスメソッドの中では、疑似変数 $this として利用できるオブジェクトのコンテキストを通じてプロパティへアクセスします。public として宣言されたプロパティは、アロー演算子 -> を使ってオブジェクトからアクセスできます。一方、static キーワードを付けて定義されたプロパティは、その値がクラスの全オブジェクト間で共有され、スコープ定義演算子 :: とクラス名を使ってアクセスします。

プロパティの宣言とアクセス

次の例は、プロパティの定義方法とアクセス方法を示したものです。

コード例

<?php
class myclass{
    private $fname = "Kiran";
    public $mname = "Pratap";
    static $lname = "Singh";

    function dispdata(){
        echo "$this->fname\n";
        echo "$this->mname\n";
        echo myclass::$lname;
    }
}
$obj = new myclass();
$obj->dispdata();
?>

出力結果

上記コードの出力は以下のとおりです。

Kiran
Pratap
Singh

クラスの外部からは、public として宣言されたインスタンスプロパティにはオブジェクト経由でアクセスできますが、private プロパティにはアクセスできません。

以前のバージョンのPHPでは、var キーワードによるプロパティ宣言が使われていました。現在では非推奨（deprecated）となっていますが、後方互換性のために引き続き利用可能であり、public 宣言として扱われます。

型付きプロパティ（PHP 7.4以降）

PHP 7.4からは、プロパティ変数に対する型宣言が導入されました。これにより、プロパティに格納できる値の型を明示的に指定できるようになり、より安全で読みやすいコードを書けるようになりました。

コード例

<?php
class myclass{
    private string $name;
    private int $age;

    function setdata(string $x, int $y){
        $this->name = $x;
        $this->age = $y;
    }

    function dispdata(){
        echo $this->name . "\n";
        echo $this->age . "\n";
    }
}
$obj = new myclass();
$obj->setdata("Kiran", 20);
$obj->dispdata();
?>

出力結果

Kiran
20

なお、PHP 8.1では一度値を代入すると変更できない readonly（読み取り専用）プロパティも導入されており、イミュータブルなデータを持つクラス設計に役立ちます。また、プロパティのデフォルト値として指定できるのは定数式のみである点にも注意してください。