8 Développer PHP 4.0
Manuel PHP
. Introduction
. Possibilités d'extension
->Source Layout
. Le système de squelette automatique de PHP
. Créer une extension
. Utiliser des extensions
. Résolution de problèmes
. Présentation des sources
. Gestion des arguments
. Créer des variables
. Duplique le contenu d'une variable : le bâtisseur de copie.
. Retourner des valeurs
. Afficher des informations
. Fonctions de démarrage et d'extinction
. Appeler des fonctions utilisateurs
. Support du fichier d'initialisation File Support
. Par oł continuer?
. Référence : quelques macros de configuration
. API Macros
|
8.3 Source Layout
| Note | |
Avant de progresser dans ce chpaitre, nous vous conseillons de récupérer
une version propre et non polluée des sources de votre serveur web préféré.
Nous travaillerons avec Apache (disponible à
http://www.apache.org/ )
et, bien entendu, avec PHP (disponbile à
http://www.php.net/ -
est-il vraiment besoin de le préciser?).
Assurez vous que vous pouvez compiler PHP par vous même. Nous ne traiterons
par cet aspect du problème ici, car vous devriez être deja en mesure
de le faire avant de vous plonger dans ce chapitre.
|
Avant que nous ne commençions à discuter du code lui-même, vous
devez vous familiariser avec l'arbre des sources PHP, pour que
vous puissiez naviguer rapidement dans les fichiers. C'est une
compétence nécessaire pour implémenter et déboguer des modules.
La table suivante décrit le contenu des dossiers les plus importants :
| Dossier |
Contenu |
|
php4
|
Le dossier principal de PHP, ses sources et fichiers d'entêtes.
Vous trouverez la toutes les définitions des API PHP, les macros,
etc... Tout se trouve rangé dans ce dossier.
Ce dossier est important.
|
|
php4/ext
|
Dépôt des modules, statiques ou dynamiquement chargés. Par défaut
ce sont les modules PHP 'officiels' qui sont intégrés dans la
distribution principale. Depuis PHP 4.0, il est possible de compiler
ces extensions standards comme module dynamiquement chargeable
(tout au moins, ceux qui le supportent).
|
|
php4/main
|
Ce dossier contient les principales macros PHP, et leur définition.
Ce dossier est important.
|
|
php4/pear
|
Dossier du Reposoir à Extensions et Applications de PHP (alias PEAR en anglais,
PHP Extension and Application Repository). Ce dossier contient les fichiers
de base de PEAR.
|
|
php4/sapi
|
Contient le code pour les différentes interfaces avec les serveurs HTTP.
|
|
php4/TSRM
|
DOssier du "Thread Safe Resource Manager" (TSRM) pour Zend
et PHP.
|
|
php4/Zend
|
Dossier du moteur Zend. Vous y trouverez notamment les définitions
des macros et de l'API.
Ce dossier est important.
|
Détailler tous les fichiers inclus dans les sources PHP dépasse le cadre de ce
chapitre. Cependant, nous allons en observer certains :
-
php4/main/php.h
, situé dans le dossier principal de PHP.
Ce fichier contient la plupart des définitions de macros et API de PHP.
-
php4/Zend/zend.h
, situé dans le dossier principal Zend.
Ce fichier contient la plupart des définitions de macros et API de Zend.
-
php4/Zend/zend_API.h
, est aussi situé dans le dossier
Zend, et définit les API Zend.
Nous vous recommandons aussi d'étudier les sous-inclusions de ces
fichiers. Par exemple, celles qui sont liées à l'exécuteur Zend,
au fichier d'initilisation de PHP, etc... Après avoir lu ces
fichiers, prenez un moment pour naviger dans les sources, pour
étudier les inter dépendances des fichiers et modules : comment ils
sont lieés, et particulièrement, comment ils s'utilisent mutuellement.
Cela vous aidera à vous adapter au style de codage de PHP. Pour
ajouter des fonctionnalités à PHP, il vous faudra vous adapter à
ce style.
Sommaire :
|