Closure::bindTo

(PHP 5 >= 5.4.0, PHP 7, PHP 8)

Closure::bindTo — Duplique la fermeture avec un nouvel objet lié et un nouveau contexte de classe.

Description

public Closure::bindTo(?object $newThis, object|string|null $newScope = "static"): ?Closure

Crée et retourne une nouvelle fonction anonyme avec le même corps et les mêmes variables liées que l'originale, mais avec un objet lié qui peut être différent, et un nouveau contexte de classe.

L'objet lié détermine la valeur que $this aura dans le corps de la fonction, et le contexte de classe représente une classe qui détermine à quels membres privés et protégés la fonction anonyme aura accès. Autrement dit, les propriétés qui seront visibles seront les mêmes que si la fonction anonyme était une méthode de la classe passée via le paramètre newScope.

Les fermetures statiques ne peuvent pas avoir d'objet lié (la valeur du paramètre newThis devrait être null), mais cette méthode peut néanmoins être utilisée pour changer leur portée de classe.

Cette méthode va vérifier qu'une fermeture non-statique à laquelle on passe un contexte d'objet deviendra liée à cet objet (et ne sera donc plus non-statique), et vice-versa. Dans ce but, les fermetures non-statiques auxquelles on passe un contexte de classe mais null comme contexte objet seront rendues statiques, et inversement.

Note:
Pour simplement dupliquer la fonction anonyme, il est possible d'utiliser le clonage à la place.

Liste de paramètres

newThis: L'objet auquel lier la fonction anonyme, ou null pour une fermeture statique.
newScope: Le contexte de classe à associer à la fermeture, ou 'static' pour conserver le contexte actuel. Si un objet est passé, son type sera utilisé. Ceci détermine la visibilité des méthodes protégées et privées de l'objet lié. Il n'est pas autorisé de passer (un objet d') une classe interne pour ce paramètre.

Valeurs de retour

Retourne la nouvelle fermeture sous la forme d'un objet Closure, ou null en cas d'erreur.

Exemples

Exemple #1 Exemple Closure::bindTo()

<?php

class A
{
    private $val;

    public function __construct($val)
    {
        $this->val = $val;
    }

    public function getClosure()
    {
        // Retourne une fermeture liée à cet objet et ce contexte
        return function() {
            return $this->val;
        };
    }
}

$ob1 = new A(1);
$ob2 = new A(2);

$cl = $ob1->getClosure();
echo $cl(), "\n";

$cl = $cl->bindTo($ob2);
echo $cl(), "\n";

?>

Résultat de l'exemple ci-dessus est similaire à :

1
2

Voir aussi

Fonctions anonymes
Closure::bind() - Duplique une fermeture avec un nouvel objet lié et un nouveau contexte de classe.