［PHP］__call()とは？未定義メソッド呼び出しを動的に処理する方法を徹底解説

PHP

はじめに

これまでの記事で、オブジェクトの生成・破棄という基本的なライフサイクルを扱う __construct() と __destruct() を解説してきました。今回取り上げる __call() は少し毛色が異なり、クラスに定義されていないメソッドが呼び出された際に、それを動的にキャッチして処理するための、より高度なマジックメソッドです。

$obj->undefinedMethod() のように、実際にはクラス内で定義されていないメソッドを呼び出すと、通常は致命的なエラーになります。しかし、クラスに __call() が定義されていると、その未定義メソッド呼び出しが自動的に __call() に転送され、開発者が自由にその挙動を制御できます。これは、フルエントインターフェース、プロキシパターン、デコレーターパターンなど、多くのデザインパターンやライブラリの内部実装で活用されている強力な仕組みです。本記事では基本的な使い方から実践的な活用例まで詳しく解説します。

メソッド概要

項目内容
メソッド名__call()
種別マジックメソッド
シグネチャpublic function __call(string $name, array $arguments): mixed
引数1$name — 呼び出されたメソッド名
引数2$arguments — 呼び出し時に渡された引数の配列
呼び出しタイミングアクセス可能な範囲内に定義がないメソッドが、オブジェクトのコンテキストから呼び出された時
戻り値任意（呼び出し元に返したい値を返す）
対応バージョンPHP 5.0以降
関連するマジックメソッド__callStatic()（静的メソッド版）

呼び出しの仕組み（イメージ図）

  $obj->someUndefinedMethod('引数1', '引数2');
              │
              ▼
  ┌───────────────────────────┐
  │ PHPがクラス内にsomeUndefinedMethod()  │
  │ というメソッドが定義されているか確認    │
  └───────────┬───────────────┘
              ▼
   ┌──────────┴──────────────┐
   │ 定義されている              │ 定義されていない
   ▼                          ▼
  通常通りそのメソッドを実行       __call('someUndefinedMethod', ['引数1', '引数2'])
                                が自動的に呼び出される
                                ★この記事の対象

ポイントは、__call() がメソッド名と引数を、それぞれ文字列と配列として受け取るという点です。これにより、$name の値に応じて処理を分岐させたり、$arguments を使って動的に別のメソッドへ処理を委譲したりする、非常に柔軟な実装が可能になります。

実践サンプル7選

例1：基本的な使い方

<?php

class BasicCallDemo
{
    public function __call(string $name, array $arguments): mixed
    {
        // 呼び出されたメソッド名と引数をそのまま確認する
        $argsString = implode(', ', $arguments);
        return "未定義メソッド '{$name}' が引数({$argsString})で呼ばれました";
    }
}

$demo = new BasicCallDemo();
echo $demo->doSomething('a', 'b') . PHP_EOL;
echo $demo->anotherMethod(123) . PHP_EOL;

例2：プロパティへのアクセサを動的に生成するクラス

<?php

class DynamicAccessor
{
    private array $data = [];

    /**
     * getXxx() / setXxx() というメソッド名の規則から、
     * 対応するプロパティへのアクセスを動的に処理する
     */
    public function __call(string $name, array $arguments): mixed
    {
        if (str_starts_with($name, 'get')) {
            $property = lcfirst(substr($name, 3));
            return $this->data[$property] ?? null;
        }

        if (str_starts_with($name, 'set')) {
            $property = lcfirst(substr($name, 3));
            $this->data[$property] = $arguments[0] ?? null;
            return $this;
        }

        throw new BadMethodCallException("メソッド '{$name}' は存在しません");
    }
}

$accessor = new DynamicAccessor();
$accessor->setName('太郎')->setAge(30);
echo $accessor->getName() . ' / ' . $accessor->getAge() . PHP_EOL;

例3：メソッド呼び出しを別のオブジェクトに委譲するプロキシパターン

<?php

class RealService
{
    public function fetchData(int $id): string
    {
        return "ID {$id} のデータ";
    }

    public function calculate(int $a, int $b): int
    {
        return $a + $b;
    }
}

class LoggingProxy
{
    public function __construct(private RealService $service)
    {
    }

    /**
     * すべてのメソッド呼び出しを、ログを挟んでから
     * 実際のサービスオブジェクトに委譲する
     */
    public function __call(string $name, array $arguments): mixed
    {
        echo "[LOG] {$name}() を呼び出します" . PHP_EOL;
        $result = $this->service->$name(...$arguments);
        echo "[LOG] {$name}() が完了しました" . PHP_EOL;

        return $result;
    }
}

$proxy = new LoggingProxy(new RealService());
echo $proxy->fetchData(42) . PHP_EOL;
echo $proxy->calculate(3, 5) . PHP_EOL;

例4：フルエントなクエリビルダーを実装するクラス

<?php

class QueryBuilder
{
    private array $conditions = [];

    /**
     * whereXxx() という形式のメソッド呼び出しを、
     * "Xxx = 値" という条件式に変換する
     */
    public function __call(string $name, array $arguments): static
    {
        if (str_starts_with($name, 'where')) {
            $field = lcfirst(substr($name, 5));
            $this->conditions[] = "{$field} = '{$arguments[0]}'";
        }

        return $this;
    }

    public function toSql(): string
    {
        return 'WHERE ' . implode(' AND ', $this->conditions);
    }
}

$query = new QueryBuilder();
echo $query->whereName('太郎')->whereStatus('active')->toSql() . PHP_EOL;

例5：存在しないメソッド呼び出しに対して明確な例外をスローする

<?php

class StrictBehaviorDemo
{
    public function knownMethod(): string
    {
        return '既知のメソッドです';
    }

    /**
     * 未定義メソッドを単に無視するのではなく、
     * BadMethodCallExceptionで明確にエラーを通知する
     */
    public function __call(string $name, array $arguments): never
    {
        throw new BadMethodCallException(
            sprintf('メソッド %s::%s() は存在しません', static::class, $name)
        );
    }
}

$demo = new StrictBehaviorDemo();
echo $demo->knownMethod() . PHP_EOL;

try {
    $demo->unknownMethod();
} catch (BadMethodCallException $e) {
    echo 'エラー: ' . $e->getMessage() . PHP_EOL;
}

例6：レガシーAPIとの後方互換性を保つアダプタークラス

<?php

class ModernApi
{
    public function fetchUserData(int $id): array
    {
        return ['id' => $id, 'name' => 'サンプルユーザー'];
    }
}

class LegacyCompatAdapter
{
    private array $methodMap = [
        'getUserInfo' => 'fetchUserData', // 旧メソッド名 => 新メソッド名
    ];

    public function __construct(private ModernApi $api)
    {
    }

    /**
     * 廃止予定の古いメソッド名での呼び出しを、
     * 新しいAPIのメソッドに変換して転送する
     */
    public function __call(string $name, array $arguments): mixed
    {
        if (isset($this->methodMap[$name])) {
            trigger_error("{$name}()は非推奨です。" . $this->methodMap[$name] . "()を使用してください。", E_USER_DEPRECATED);
            $newMethod = $this->methodMap[$name];
            return $this->api->$newMethod(...$arguments);
        }

        throw new BadMethodCallException("メソッド '{$name}' は存在しません");
    }
}

$adapter = new LegacyCompatAdapter(new ModernApi());
print_r($adapter->getUserInfo(1)); // 古いメソッド名で呼び出しても動作する

例7：アクセス制御によって__call()が発動するケースを確認する

<?php

class VisibilityDemo
{
    private function secretMethod(): string
    {
        return 'プライベートメソッドの内容';
    }

    /**
     * クラス外部からアクセス不能な(private/protected)メソッドを
     * 外部から呼び出そうとした場合にも__call()が発動する
     */
    public function __call(string $name, array $arguments): string
    {
        return "'{$name}' はアクセスできないか、存在しません（外部からの呼び出し）";
    }

    public function callSecretInternally(): string
    {
        // クラス内部からは通常通りprivateメソッドを呼び出せる
        return $this->secretMethod();
    }
}

$demo = new VisibilityDemo();
echo $demo->callSecretInternally() . PHP_EOL; // 通常の呼び出し
echo $demo->secretMethod() . PHP_EOL;          // __call()が発動する

関連機能との比較

機能役割__call()との違い
__call()インスタンスメソッドとしての未定義呼び出しを処理本記事の対象。$obj->method()形式の呼び出しが対象
__callStatic()静的メソッドとしての未定義呼び出しを処理ClassName::method()形式の静的呼び出しが対象
__get() / __set()未定義プロパティへのアクセスを処理メソッド呼び出しではなく、プロパティアクセスを対象とする
__invoke()オブジェクトを関数のように呼び出した際に実行メソッド名を伴わない、オブジェクト自体の呼び出しを対象とする
インターフェース + 明示的な実装決められたメソッドを型安全に実装する動的な処理ではなく、コンパイル時（静的解析時）に検証可能な設計

よくある落とし穴（注意点）

  1. IDEの補完やコード解析ツールが効きにくくなる __call() によって動的に生成されるメソッドは、実際にはクラス定義上に存在しないため、多くのIDEやコード補完ツールがこれを認識できません。開発体験を損なわないよう、PHPDocの @method アノテーションを使って補完情報を補う工夫が推奨されます。
  2. パフォーマンスへの影響 __call() を経由する呼び出しは、通常の直接的なメソッド呼び出しよりもわずかにオーバーヘッドが大きくなります。頻繁に呼び出される処理のホットパスで多用すると、パフォーマンスに影響する可能性があります。
  3. 存在しないメソッド呼び出しをサイレントに無視してしまう __call() 内でエラーハンドリングを行わず、単に null を返すような実装にしてしまうと、本来はタイプミスによるバグであるはずの呼び出しが、エラーにならずに静かに失敗してしまいます。明確な例外をスローする設計が望ましいです（例5を参照）。
  4. private/protectedメソッドへの外部アクセスでも発動することを理解する __call() は、単に「メソッドが存在しない」場合だけでなく、「アクセス可能な範囲外のメソッドが外部から呼ばれた」場合にも発動します。この挙動を意図せず利用してしまうと、アクセス制御の意図が分かりにくくなることがあります（例7を参照）。
  5. デバッグの難易度が上がる 動的なメソッド呼び出しの転送や変換ロジックが複雑になると、スタックトレースを追ってもどこで何が起きているのか分かりにくくなります。__call() を多用する設計は、可読性とのバランスを考慮して採用しましょう。

まとめ

観点まとめ
何をするメソッドかクラスに定義されていない、またはアクセスできないメソッドが呼び出された際に動的に処理する
主な用途動的なgetter/setter、プロキシパターン、フルエントインターフェース、レガシーAPIとの互換性維持
引数呼び出されたメソッド名（文字列）と、渡された引数（配列）
対になるメソッド__callStatic()（静的メソッド版）
注意点IDE補完の効きにくさ、パフォーマンスへの影響、エラーハンドリングの明確化の必要性

__call() は、PHPのオブジェクト指向機能の中でも特に柔軟性の高い仕組みであり、多くのフレームワークやライブラリの内部で活用されています。強力な機能である一方、乱用するとコードの追跡が困難になるため、その特性を理解した上で、適切な場面（プロキシ、動的アクセサ、後方互換性の維持など）に絞って活用することが重要です。

タイトルとURLをコピーしました