【PHP8.x】bindToメソッドの使い方

Copy
1<?php
2
3class PlayerCharacter
4{
5    private string $name;
6
7    public function __construct(string $name)
8    {
9        $this->name = $name;
10    }
11
12    /**
13     * このPlayerCharacterインスタンスの$thisにバインドされたクロージャを返します。
14     * クロージャ内では$this->nameにアクセスできます。
15     */
16    public function getInfoClosure(): Closure
17    {
18        return function () {
19            return "プレイヤー名: " . $this->name;
20        };
21    }
22}
23
24class NonPlayerCharacter
25{
26    private string $name;
27    private int $level;
28
29    public function __construct(string $name, int $level)
30    {
31        $this->name = $name;
32        $this->level = $level;
33    }
34
35    public function getLevel(): int
36    {
37        return $this->level;
38    }
39}
40
41// 1. PlayerCharacterインスタンスを作成し、そこからクロージャを取得します。
42$hero = new PlayerCharacter("勇者アルス");
43$heroInfoClosure = $hero->getInfoClosure();
44
45echo "--- 元のクロージャの実行 (PlayerCharacter) ---\n";
46// クロージャは$heroオブジェクトにバインドされているため、$this->nameは"勇者アルス"になります。
47echo $heroInfoClosure() . "\n\n";
48
49// 2. NonPlayerCharacterインスタンスを作成します。
50$goblin = new NonPlayerCharacter("ゴブリン", 5);
51
52// 3. Closure::bindTo を使用して、クロージャの $this (参照元オブジェクト) とスコープを変更します。
53//    - 第一引数 ($newThis): 新しい$thisとなるオブジェクトを指定します。ここでは$goblin。
54//    - 第二引数 ($newScope): 新しいスコープを指定します。
55//      文字列でクラス名 ('NonPlayerCharacter') を指定することで、
56//      クロージャはそのクラスのprivate/protectedメンバーにアクセスできるようになります。
57//      オブジェクト ($goblin) を指定しても同じ効果が得られます。
58//    元のクロージャ ($heroInfoClosure) が参照していた $this->name は、
59//    新しいオブジェクト ($goblin) の $name プロパティを参照するようになります。
60//    NonPlayerCharacterクラスも $name プロパティを持つため、正しく動作します。
61$goblinInfoClosure = $heroInfoClosure->bindTo($goblin, 'NonPlayerCharacter');
62
63echo "--- bindTo 後のクロージャの実行 (NonPlayerCharacter) ---\n";
64// クロージャは$goblinオブジェクトにバインドされ、NonPlayerCharacterのスコープで実行されるため、
65// $this->nameは"ゴブリン"になります。
66echo $goblinInfoClosure() . "\n";
67
68// 4. bindTo の第一引数に null を渡すと、$this が存在しないクロージャになります。
69//    その場合、クロージャ内で $this を参照しようとするとエラーが発生します。
70$detachedClosure = $heroInfoClosure->bindTo(null);
71echo "\n--- \$this が null のクロージャの実行 ---\n";
72try {
73    echo $detachedClosure() . "\n";
74} catch (Error $e) {
75    echo "エラー: " . $e->getMessage() . "\n"; // 例: Using $this when not in object context
76}
77

PHPのClosure::bindToメソッドは、既存のクロージャが参照する$thisオブジェクトと、そのクロージャがアクセスできるスコープ（privateやprotectedメンバーなど）を動的に変更するために使用されます。

このメソッドの第一引数$newThisには、クロージャが新たに参照するオブジェクトを指定します。ここにnullを渡すと、クロージャはどのオブジェクトにもバインドされなくなり、クロージャ内で$thisを参照するとエラーが発生します。第二引数$newScopeには、クロージャが実行される際の新しいスコープを指定します。クラス名を示す文字列、またはそのクラスのオブジェクトを指定することで、クロージャはそのクラスのprivateやprotectedメンバーにアクセスできるようになります。このメソッドは、$newThisと$newScopeが適用された新しいClosureオブジェクトを返します。

サンプルコードでは、まずPlayerCharacterオブジェクトにバインドされたクロージャを作成し、「勇者アルス」というプレイヤー名を表示しています。次に、NonPlayerCharacterオブジェクトの「ゴブリン」を作成し、既存のクロージャをbindToメソッドを使って「ゴブリン」オブジェクトにバインドし直しました。これにより、同じクロージャを実行しても、「ゴブリン」の$this->nameが参照され、「ゴブリン」という名前が表示されます。bindToの第二引数にクラス名'NonPlayerCharacter'を指定することで、クロージャはNonPlayerCharacterのprivateプロパティにもアクセス可能になっています。このようにbindToは、クロージャの実行コンテキストを柔軟に切り替える際に役立つ機能です。