8.8.6 Création de la fonction get_module

Cette fonction est spéciale à tous les modules dynamiques. Etudiez donc sa création via la macro ZEND_GET_MODULE :

#if COMPILE_DL_FIRSTMOD
     ZEND_GET_MODULE(firstmod) 
#endif

L'implémentation de la fonction est encadrée par des commandes de compilation conditionnelle. C'est nécessaire car la fonction get_module n'est utile que si votrem odule est compilé comme extension dynamique. En spécifiant la définition de COMPILE_DL_FIRSTMOD dans la commande de compilateur, (voir ci-dessus la présentation de la complation sous forme d'extension dynamique), vous pouvez indiquer au module si vous allez le compiler comme extension dynamique, ou comme module statique. Si vous voulez un module statique, l'implémentation de la fonction get_module est simplement ignorée.

get_module est appelée par Zend au moment du chargement du module. Vous pouvez la considérer comme étant appelée par la fonction dl , dans le script PHP. Son objectif et de passer les informations du bloc de module à Zend, afin de lui présenter le contenu.

Si vous n'implémentz pas la fonction get_module dans vos modules dynamiques, Zend vous gratifiera d'un message d'erreur lorsque vous essayez d'y accéder.