7.9.6 Création de get_module
Cette fonction est particulière à tous les modules dynamiquement
chargeables. Tout d'abord, jetez un oeil à la création via
ZEND_GET_MODULE :
#if COMPILE_DL_FIRSTMOD
ZEND_GET_MODULE(firstmod)
#endif
L'implémentation de la fonction est encadrée par une
commande conditionnelle de compilation. Cela est nécessaire
car la fonction get_module est uniquement
nécessaire si votre module est compilé comme extension dynamique.
En spécifiant une définition de COMPILE_DL_FIRSTMOD
dans la commande du compilateur (voir ci-dessus pour une présentation
des instructions de compilation nécessaires aux extensions dynamiques),
vous pouvez indiquer à votre module si vous allez le compiler
comme module dynamique, ou bien comme module intégré. Si vous
en faites un module intégré, l'implémentation de
get_module est simplement ignorée.
get_module est appelé par lors du chargement
du module. Vous pouvez le considérer comme appelé par la fonction
dl dans votre script. Son objet est de
passer les informatoins de bloc de module à Zend, pour qu'il informe
le Zend Engin du contenu du module.
Si vous n'implémentez pas une fonction get_module dans
votre module dynamiquement chargeable, Zend vous gratifiera d'un message
d'erreur lorsque vous essaierez d'y accéder.
|