InstallationPré-requis&php; 5 avec magic_quotes_gpc et register_globals à offLe support LDAP dans &php; (paquet php5-ldap dans Debian)Le support mhash dans &php; (paquet php5-mhash dans Debian Lenny, intégré à php5-common dans Debian Squeeze)Le support json dans &php; (pear install pecl/json sur RedHat, intégré au paquet php5-common dans Debian)&netldap; (paquet php-net-ldap2 dans Debian ou pear install net_ldap2)&smarty; (paquet smarty dans Debian)L'utisateur exécutant le serveur web doit avoir les droits d'écriture sur le dossier 'tmp'. En cas d'installation à partir du paquet Debian, ce dossier est remplacé par un lien symbolique vers le dossier /var/cache/ldapsaisie/.La librairie &netldap; oblige le fait que la racine DSE de
l'annuaire soit lisible en anonyme sinon la connexion à l'annuaire échouera
systématiquement.Cette documentation est écrite à l'aide du langage Docbook.
Les mécanismes d'exportation de celle-ci requiert un certain nombre de programmes
et librairies :
make (paquet make dans Debian)la feuille de style html XSL de Norman Walsh pour Docbook (fichier /usr/share/xml/docbook/stylesheet/nwalsh/html/docbook.xsl fournis par le paquet docbook-xsl dans Debian)xmllint (validation XML) (paquet libxml2-utils dans Debian)jw (exportation PDF) (paquet docbook-utils dans Debian)dbtoepub (exportation EPUB) (paquet dbtoepub dans Debian)TéléchargementA partir du paquet DebianL'installation à partir du paquet Debian peut être réalisée soit en
téléchargeant manuellement le paquet, soit en déclarant le dépôt APT suivant
dans votre fichier /etc/apt/sources.list :
deb http://ldapsaisie.easter-eggs.org/debian stable main
Il ne vous restera ensuite plus qu'a installer le paquet ldapsaisie
avec la commande suivante :
apt-get install ldapsaisie
Le fichier /etc/ldapsaisie/apache.conf est un example de
configuration du serveur web Apache. La configuration du logiciel ce fera ensuite
dans le dossier /etc/ldapsaisie/local/.
A partir de GitLe dépôt Git peut être récupéré anonymement en utilisant la
commande suivante :
git clone git://git.labs.libre-entreprise.org/ldapsaisie.git
La racine web de l'application se trouvera alors dans le dossier
/ldapsaisie/public_html/.
A partir des snapshotToutes les nuits, un snapshot de l'arbre Git est réalisé et est
téléchargeable au format tar.gz à l'adresse suivante :
http://ldapsaisie.easter-eggs.org/download/ldapsaisie-snapshoot.tar.gz
&install-arbo;
Tutoriel d'installationCette section décrit les différentes étapes de l'installation de
LdapSaisie. Deux méthodes d'installation sont présentées ici, l'une à
partir des sources du projet et l'autre à partir du paquet Debian.Dans ce tutoriel, nous partirons du principe que vous avez
pleinement la main sur votre serveur (installation de nouveau paquet et
configuration de votre serveur web) et que l'installation à partir des sources
se fera dans le dossier /var/www/ldapsaisie. Nous partons
également du principe que votre annuaire LDAP est déjà en place. Nous
utiliserons pour cette exemple de mise ne oeuvre l'annuaire correspondant
au schéma et à la configuration présente dans les sources du projet dans
le dossier lsexample.La première étape consiste à installer le locigiel en tant que tel.
Pour une installation à partir du paquet Debian référez vous au chapitre
Téléchargement. Une fois le paquet
Debian, la configuration du logiciel se fera dans le dossier
/etc/ldapsaisie/local/. Les fichiers placés dans ce
dossier prévaleront toujours aux fichiers fournis par le paquet Debian,
vous permettant facilement de modifier un composant existant ou dans écrire
de nouveaux. Ainsi, pour modifier un fichier CSS par exemple, il vous
suffira de le placer dans le dossier
/etc/ldapsaisie/local/css/.Pour une installation à partir du code source, il vous faut
cloner le repos Git. Pour cela il vous faut avoir installés les outils de Git
contenu, dans Debian, dans le paquet git-core. Le
dépôt Git doit ensuite être récupéré anonymement en utilisant la
commande suivante :
git clone git://git.labs.libre-entreprise.org/ldapsaisie.gitPour que cette commande se déroule correctement, vous devez avoir
accès au port TCP 9418 du serveur git.labs.libre-entreprise.org. En cas de problème
vérifiez votre firewalling.
La suite des opérations se déroulera donc maintenant dans le dossier
/var/www/ldapsaisie. Pour avoir plus de détails sur
les élements qu'on retrouve dans ce dossier, vous pouvez consulter
la section concernée. Nous allons
nous instérésser plus particulièrement :
au script upgradeFromGit.sh
permettant la mise à jour de votre repos tout en concervant les adaptations
que nous ferons pour l'usage d'LdapSaisie adapté à notre annuaire ;au dossier config.local dans
lequel seront stockés vos fichiers et vos adaptations de l'application ;
au dossier public_html qui
correspond à la futur racine du site web de l'application.
Le principe de l'adaptation est ici de mettre vos fichiers personnalisés
dans le dossier config.local, de les déclarer dans
votre fichier config.local/local.sh contenant la liste
des fichiers devant être installés. Le fichier local.sh
est la source de configuration du script upgradeFromGit.sh.
Il faut donc dans un premier temps créer votre fichier
local.sh en copiant le fichier d'example
local.sh.example. Ce fichier est un script bash
déclarant les variables de configurations suivantes :
LOCAL_FILESLa liste des chemins des fichiers à installer dans l'arboressence
du site. Cette élément doivent être séparés par des espaces ou des
retour à la liste. Exemple :public_html/conf/config.inc.php
public_html/lang/fr_FR.UTF8/lang.phpLOG_FILENom du fichier de log des mises à jour.THEMELe nom du theme à installer (facultatif et non traité dans
ce tutoriel).BUILD_DOCVariable booléene définissant si la documentation doit être
compiler en utilisant le script buildDocExports.sh.
Ceci ne sera pas expliqué dans ce tutoriel et nous partirons donc du
principe que cette variable est à 0.D'autres variables sont présentes dans ce fichier et
concerne uniquement la compilation de la documentation. Elle peuvent
être ignorée à partir du moment ou la variable
BUILD_DOC vaut 0.Il est possible d'utiliser dans ce fichier de configuration
la variable bash $ROOT_DIR correspondant au chemin
du dossier d'installation, c'est à dire dans notre exemple
/var/www/ldapsaisie.La deuxième étape concerne la configuration globale
de l'application : Cette partie est principalement contenue dans le
fichier conf/config.inc.php (ou
/etc/ldapsaisie/local/conf/config.inc.php en cas
d'installation à partir du paquet Debian). En cas d'installation à partir
du code source, il faut donc dans un premier temps copier ce fichier dans
le dossier config.local et le déclarer dans la liste
des fichiers à déployer lors des mises à jour
(variable LOCAL_FILES dans le fichier
local.sh). Il s'agit en particulier dans ce fichier
de configurer la connexion à votre annuaire. Vous pouvez vous inspirer
du fichier d'exemple fourni et pour plus de détails, reportez-vous à
la section concernée.
Notez qu'il est possible de passer l'application en mode
debug ce qui peut être utile par la suite.La troisième étape concerne la configuration des
types de &LSobjects; : Chaque type d'objet manipulé par LdapSaisie doit
correspondre avec un type de LSobject.Création du fichier de classe : Ce fichier contient la
déclaration de la classe PHP correspondant au type de LSobject. Cette classe
étend la classe LSldapObject qui contient pour ainsi dire
toute les méthodes et proprités nécessaires pour les types de LSobject simples
(sans &LSrelation;). Les fichiers des classes sont contenus dans le dossier
/includes/class/ et portent les noms composés de la
manière suivante :
class.LSobjects.[nom du type d'LSobject].php
Le plus simple pour cette étape est de copier un des fichiers d'exemple afin
de l'adapter en changeant le nom du type d'objet dans l'ensemble du fichier.
Pour cela, le fichier de classe du type LSpeople est le
plus simple car il ne contient que le strict minimum. Pour un fichier de classe
ayant des &LSrelations; à gérer, le fichier de classe LSgroup
contient déjà les méthodes nécéssaires pour gérer ces cas.
Configurer vos LSobject : Cette partie est certainement la
plus longue et consiste à déclarer l'ensemble des informations relatives aux
types des objets LDAP manipulés. Les fichiers d'exemples fournis vous seront
alors d'une aide précieuse. basé vous sur l'un de pour créer le votre. Pour
cela le fichier de configuration du type d'LSobjet LSpeople
est le plus complet et est un bon point de départ. Pour plus de détails sur les
élements de configuration de ce fichier, reportez-vous à
la section concernée.Configurer si nécessaire les relations entre les objets
appelés &LSrelations;. Cette opération consiste dans un premier temps à écrire
les méthodes PHP nécessaires pour gérer ces relations : pour cela regardez le
fichier de classe du type LSgroup. Il faudra ensuite
déclarer ces relations dans la configuration des types d'LSobjects : Pour plus
de détails, reportez-vous à la
section concernée.En cas d'installation à partir du code source, pensez à déclarer
les fichiers que vous venez de créer dans la variable LOCAL_FILES
du fichier local.sh. Exemple pour le type d'LSobjet portant comme
nom LSexample :public_html/conf/LSobjects/config.LSobjects.LSexample.php
public_html/includes/class/class.LSobjects.LSexample.phpVous pouvez également personnaliser l'interface : Il est
possible de personnaliser à votre goût l'interface en écrivant votre
template ou en modifiant simplement les fichiers CSS. Une partie de
cette documentation concernera bientôt cette problématique. Patience...
En cas d'installation à partir du code source, une dernière
étape à ce niveau consiste à lancer le script upgradeFromGit.sh
pour qu'il installe les fichiers que vous venez de créer. Ce script est conçu pour
dire tout ce qu'il fait donc en cas de problème vous devriez rapidement comprendre
où cela coince. Dans tout les cas, n'hésitez pas à poser vos questions à la
communauté sur la liste ldapsaisie-users@lists.labs.libre-entreprise.org.