中級

Cannot access private property の原因と直し方

privateで宣言したプロパティにクラスの外からアクセスしようとすると、致命的エラーになります。外部に公開したい値はpublicにするか、getterメソッド経由で提供する必要があります。

エラーメッセージの読み方

Fatal error: Uncaught Error: Cannot access private property Account::$balance in main.php:6

main.php

ファイル名

6

行番号 — 実際にクラッシュした行

Error

例外クラス — 何が起きたか。ここを検索するのが最短です

Cannot access private property Account::$balance

内容 — どの値が問題だったか

このエラーが出る典型パターン

 1  <?php
 2  class Account {
 3      private   float $balance = 0.0;
            ^
 4  }
 5  $acc = new Account();
 6  echo $acc->balance;

 1  <?php
 2  class User {
 3      private   string $email = "a@example.com";
            ^
 4  }
 5  $u = new User();
 6  echo $u->email;

 1  <?php
 2  class Product {
 3      private   int $price = 500;
            ^
 4  }
 5  $p = new Product();
 6  echo $p->price;

 1  <?php
 2  class Invoice {
 3      private   float $amount = 0.0;
            ^
 4  }
 5  $inv = new Invoice();
 6  echo $inv->amount;

 1  <?php
 2  class Ticket {
 3      private   string $code = "X1";
            ^
 4  }
 5  $t = new Ticket();
 6  echo $t->code;

よくある誤解

「プロパティは宣言さえすればどこからでも読めるはず」という思い込みは誤りです。privateはクラスの外からのアクセスを言語レベルで禁止するもので、回避する手段はgetterを用意することだけです。

実務での勘所

PHPには、getterやsetterをすべて手で書く代わりに、__get($name)と__set($name, $value)というマジックメソッドを使う方法もあります。これらを定義しておくと、存在しない、あるいはアクセスできないプロパティにアクセスしようとした瞬間にPHPが自動的に呼び出してくれるため、動的にプロパティのようなインターフェースを提供できます。LaravelのEloquentモデルなど、多くのPHPフレームワークがデータベースの列を「プロパティのように」扱えるようにしているのは、この仕組みを応用したものです。

演習をはじめる

関連するエラー

• Call to a member function on null の原因と直し方nullが入った変数に対してメソッドを呼び出そうとしたときに出るエラーです。
• Cannot instantiate abstract class の原因と直し方abstractを付けたクラスは、そのままnewしてインスタンス化することができません。