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
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 le contexte de classe peut,
lui, être changé.
Cette fonction 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:
Si vous voulez seulement dupliquer la fonction anonyme, vous pouvez 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 determine 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;
function __construct($val) {
$this->val = $val;
}
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 à :