Charger un Kit de librairie
L'archive de webappkit devrait être décompressée à la racine de votre site. Avant d'inclure un kit, placez la ligne suivant dans votre code (une seule fois par execution) :
// inclusion des librairies de base de webappkit
include('webappkit/include-me.php');
Lorsque vous avez besoin d'un kit de librairie, par exemple example
,
chargez le avec :
// chargement des librairies du kit "example"
webappkit::loadKit('example');
Webappkit autorise l'imbrication de kits et utilise une syntaxe pointée pour accéder aux kits imbriqués. Si vous avez seulement besoin d'une partie du kit (subkit), par exemple hello au sein de example, chargez la avec :
// chargement des librairies du sous-kit "hello" du kit "example"
webappkit::loadKit('example.hello');
Dans cet exemple, example.hello
requiert example.base
.
Mais vous n'avez pas à vous en soucier, grâce à la gestion interne des dépendances.
Le mécanisme
Lorsque vous chargez un kit, webappkit va chercher dans le repertoire des kits (généralement webappkit/
) un dossier du même nom terminé par .wak
,
et lire dans ce dossier un fichier nommé wak.ini
. Ce fichier liste les dépendances du kit, qui seront incluses, puis les fichiers du kit à charger.
Si vous ciblez un sous-kit, webappkit va parcourir l'arborescence physique des kits jusqu'à trouver le kit ciblé. Par exemple, example.hello.world
fait référence au dossier de kit example.wak/hello.wak/world.wak/
.