PHP Fatal error: Uncaught Error: Call to a member function on null の原因と解決方法

Fatal error: Uncaught Error: Call to a member function on null とは

このエラーは、PHPでnull値の変数に対してオブジェクトのメソッドを呼び出そうとしたときに発生します。つまり、期待するオブジェクトが実際には存在せず、代わりにnullが代入されている状態です。この問題を解決するには、変数がnullでないことを確認してからメソッドを呼び出す必要があります。

エラーの発生パターン

このエラーは主に以下のようなケースで発生します。

パターン1: オブジェクトが初期化されていない

<?php
class User {
    public function getName() {
        return 'John Doe';
    }
}

$user = null; // または初期化されていない
$name = $user->getName(); // Fatal error: Call to a member function on null

$user変数がオブジェクトとして初期化されていない、または明示的にnullが代入されている状態で、その変数に対してgetName()メソッドを呼び出そうとしています。オブジェクトが生成されていないため、メソッドは存在せずエラーとなります。

<?php
class User {
    public function getName() {
        return 'John Doe';
    }
}

$user = new User(); // オブジェクトを正しく初期化
$name = $user->getName();
echo $name; // 出力: John Doe

パターン2: 関数やメソッドがnullを返したことを確認していない

<?php
class UserRepository {
    public function findById(int $id): ?User {
        // IDが100でなければnullを返す
        if ($id === 100) {
            return new User();
        }
        return null;
    }
}

class User {
    public function getName() {
        return 'Jane Doe';
    }
}

$repo = new UserRepository();
$user = $repo->findById(101); // nullが返される
$name = $user->getName(); // Fatal error: Call to a member function on null

findById()メソッドがID ‘101’に対してnullを返していますが、その戻り値がnullであるかどうかのチェックをせずにgetName()メソッドを呼び出しているためエラーが発生します。メソッドがnullを返す可能性がある場合は、必ず呼び出し元で確認が必要です。

<?php
class UserRepository {
    public function findById(int $id): ?User {
        if ($id === 100) {
            return new User();
        }
        return null;
    }
}

class User {
    public function getName() {
        return 'Jane Doe';
    }
}

$repo = new UserRepository();
$user = $repo->findById(101);

if ($user !== null) { // nullチェックを追加
    $name = $user->getName();
    echo $name;
} else {
    echo "User not found."; // nullの場合の処理
}

パターン3: 条件分岐のロジックミス

<?php
class Config {
    private $data = [];
    public function __construct(array $data) {
        $this->data = $data;
    }
    public function get(string $key): ?string {
        return $this->data[$key] ?? null;
    }
}

$config = new Config(['app_name' => 'My App']);

// 存在しないキーにアクセスし、nullを返す
$env = $config->get('environment');

// この条件は常にtrueになり、nullに対してメソッドを呼び出そうとする
if (isset($config)) {
    // $envはnullだが、Configオブジェクトは存在するためこのブロックに入る
    // ここで$envはnullなのでエラーになる
    // $env->toLowerCase(); // 例: 文字列メソッドを呼び出すとエラーになる可能性
}
// PHPでは文字列に直接メソッドはないが、以下のようなケースで発生する
// $someObject = $config->get('non_existent_object');
// $someObject->doSomething(); // Fatal error

if (isset($config))は$configオブジェクト自体が存在するかどうかをチェックしており、$config->get('environment')の戻り値である$envがnullであるかどうかをチェックしていません。結果として、$envがnullのまま処理が続行され、nullに対してメソッドを呼び出そうとしてエラーになります。

<?php
class Config {
    private $data = [];
    public function __construct(array $data) {
        $this->data = $data;
    }
    public function get(string $key): ?string {
        return $this->data[$key] ?? null;
    }
}

$config = new Config(['app_name' => 'My App']);

$env = $config->get('environment');

// $env変数がnullでないことを確認してから使用
if ($env !== null) {
    // $envが文字列として存在する場合の処理
    echo "Environment: " . $env; // 'environment'キーは存在しないので出力されない
}

// もしオブジェクトを返すメソッドの場合
// $someObject = $config->get('non_existent_object'); // nullを返す
// if ($someObject !== null) {
//     $someObject->doSomething(); // nullではない場合のみ呼び出す
// }

根本原因の特定方法

エラーが発生した行の直前で、疑わしい変数に対してvar_dump()を使用し、その時点での値と型を確認します。これにより、変数がオブジェクトではなくnullになっている瞬間を特定できます。また、isset()関数を使って変数が設定されているかどうかも確認すると良いでしょう。

<?php
// ... (エラーが発生する可能性のあるコード)

var_dump($user); // $userがnullでないか確認
// var_dump(isset($user)); // true/falseで存在を確認

// $user->getName(); // この行でエラーが発生する

防止策とベストプラクティス

変数がnullになる可能性のある箇所では、必ずnullチェックを行う習慣をつけましょう。PHP 7.0以降では、Null合体演算子 (??) や型宣言を利用することで、より安全で簡潔なコードを書くことができます。これにより、意図しないnull値でのメソッド呼び出しを防げます。

<?php
// Null合体演算子 (??) を使用
$user = getUserFromDB() ?? new GuestUser(); // nullならデフォルトオブジェクトを代入
$name = $user->getName();

// Null安全演算子 (PHP 8.0以降) を使用
// $name = $user?->getName(); // $userがnullならnullを返し、エラーにならない

// 型宣言とnullチェック
function processUser(?User $user) {
    if ($user !== null) {
        echo $user->getName();
    } else {
        echo "No user provided.";
    }
}

よくある質問（FAQ）