Que signifie démarrer une fonction PHP avec une esperluette?

J'utilise la bibliothèque Facebook avec ce code:

class FacebookRestClient {
...
    public function &users_hasAppPermission($ext_perm, $uid=null) {
        return $this->call_method('facebook.users.hasAppPermission', 
        array('ext_perm' => $ext_perm, 'uid' => $uid));
    }
...
}

Que signifie le & au début de la définition de la fonction, et comment utiliser une bibliothèque comme celle-ci (dans un exemple simple)

Une esperluette avant un nom de fonction signifie que la fonction renverra une référence à une variable au lieu de la valeur.

Le retour par référence est utile lorsque vous souhaitez utiliser une fonction pour trouver à quelle variable une référence doit être liée. N'utilisez pas le retour par référence pour augmenter les performances. Le moteur optimisera automatiquement cela de lui-même. Ne renvoyez les références que si vous avez une raison technique valable de le faire.

Voir Renvoyer les références .

Il renvoie une référence, comme déjà mentionné. En PHP 4, les objets étaient attribués par valeur, comme toute autre valeur. Ceci est très peu intuitif et contraire au fonctionnement de la plupart des autres langages.

Pour contourner le problème, des références ont été utilisées pour les variables qui pointaient vers des objets. En PHP 5, les références sont très rarement utilisées. Je suppose que c'est du code hérité ou du code essayant de préserver la compatibilité ascendante avec PHP 4.

Ceci est souvent connu en PHP comme Renvoi de référence ou Renvoi par référence .

Le retour par référence est utile lorsque vous souhaitez utiliser une fonction pour trouver à quelle variable une référence doit être liée. N'utilisez pas le retour par référence pour augmenter les performances. Le moteur optimisera automatiquement cela de lui-même. Ne renvoyez les références que si vous avez une raison technique valable de le faire.

Documentation PHP sur le renvoi de référence

Une référence en PHP est simplement un autre nom attribué au contenu d'une variable. Les références PHP ne sont pas comme des pointeurs dans la programmation C , ce ne sont pas des adresses mémoire réelles, elles ne peuvent donc pas être utilisées pour l'arithmétique des pointeurs.

Le concept de renvoyer des références peut être très déroutant, en particulier pour les débutants, un exemple sera donc utile.

$populationCount = 120;

function &getPopulationCount() {
  global $populationCount;
  return $populationCount;
}

$countryPopulation =& getPopulationCount();
$countryPopulation++;
echo "\$populationCount = $populationCount\n"; // Output: $populationCount = 121 
echo "\$countryPopulation = $countryPopulation\n"; //Output: $countryPopulation = 121 

La fonction getPopulationCount()définie avec un précédent &, retourne la référence au contenu ou à la valeur de $populationCount. Donc, incrémenter $countryPopulation, incrémente également $populationCount.