Il existe 2 types d'organisation des dossiers possible pour utiliser de manière idéale le framework Flampy.
Les Layouts
Flampy vous propose l'utilisation de 2 layouts:
- Flat
- Hierarchical
Le layout Flat
Ce layout est destiné à ceux qui dispose de seulement un nom de domaine (le plus souvent un hébergement gratuit).
L'url mis à disposition par l'hébergeur pointe directement sur la racine des répertoires accessible par FTP.
Les répertoires YourApplication et Flampy doivent être protégés pour empêcher leur consultation depuis un navigateur web (par exemple avec un fichier .htaccess).
Le répertoire service sera accessible avec cette url yourDomain.com/service
Le répertoire schema sera accessible avec cette url yourDomain.com/schema
Le répertoire test sera accessible avec cette url yourDomain.com/test
Le contrôleur principal de votre application sera accessible avec cette url yourDomain.com
Le layout Hierarchical
Ce layout est destiné à ceux qui dispose d'un hébergement permettant la création de plusieurs sous-domaine et permettant de cacher (de l'extérieur) le répertoire principal (le plus souvent un hébergement payant).
Chaque sous-domaine doit être configuré pour pointer sur un réperoire ou un sous répertoire.
Il suffit de placer les répertoires YourApplication et Flampy à la racine et de ne pas créer de sous-domaine pointant sur la racine de votre répertoire pour empêcher leur consultation depuis un navigateur web.
Le répertoire service sera accessible avec cette url service.yourDomain.com
Le répertoire schema sera accessible avec cette url schema.yourDomain.com
Le répertoire test sera accessible avec cette url test.yourDomain.com
Le contrôleur principal de votre application sera accessible avec cette url yourDomain.com et devra être placé dans un répertoire séparé (www dans l'exemple)
Zoom sur le contenu des dossiers
Le répertoire Emukina
Emukina doit être remplacé par le nom de votre application.
Il contient tous les fichiers spécifiques à votre application:
- cache: contient les fichier de configuration cachés générés par l'application
- config: les fichiers de configuration de l'application voir ici
- dao: vos daos éventuellement surchargés
- manager: vos manager éventuellement surchargés
- services: les classes de traitement de vos services web
- bootstrap.php et
- close.php: fichier de démarrage à modifier voir ici
Le répertoire Flampy
Il contient le framework Flampy, vous n'avez pas besoin de le modifier.
Le répertoire schema
Il contient le ou les schemas XML des objets métiers de votre application, selon vos souhaits il peut contenir les schéma XML du framework Flampy pour éviter
des problèmes de version.
Le répertoire service
Il contient les fichiers suivants:
- .htaccess: le fichier de configuration du répertoire d'Apache
- crossdomain.xml: le fichier de configuration pour les applications multi-domaines
- index.php: le fichier faisant appel au framework Flampy, il gére un paramètre nommé service qui prend le nom du service web à appeler
- .wsdl: les fichiers de description des services web
Le répertoire test
Ce répertoire contient vos fichiers de tests unitaires.
Bientôt Flampy proposera une gestion pertinente des ces tests unitaires.
