		1)Avertissement
		---------------
La cl prive marchand et le code Siret sont strictement confidentiels car ils sont sensibles pour le commerant. Les commerants sont responsables de leur diffusion. Les pages html et PHP sont donnes  titre d'exemple mais elles sont oprationnelles


		2)Contenu de l'archive
		----------------------
Ce kit marchand est gnrique, il est fonctionnel mais correpond  un site de dmonstration (nomm Ma boutique 1)
Pour tre utilis sur votre site vous devez modifier certaines informations comme indiqu dans le paragraphe "configuration et tests".

L'archive contient les sources du kit marchand, des scripts de compilation (configure et makefile),des fichiers de test (rpertoire test).

Vous y trouverez galement un ensemble d'images (rpertoire logos_SPPLUS) et d'exemples que vous pouvez utiliser dans les pages de votre site afin de signaler l'utilisation du paiement scuris SP+. Leur utilisation est fortement recommande et toute drogation doit tre justifie.


		3)Installation et compilation
		--------------
Avant tout chose, le package PHP "php-devel" doit tre install sur votre serveur. Ce package permet de compiler des extensions PHP.

Vous devez extraire l'archive dans un rpertoire temporaire comme indiqu ci dessous (dans le cas d'une machine sous Unix ou linux):

machine user$ cp spplus-1.2.tar.gz /tmp
machine user$ cd /tmp
machine tmp$ tar xvzf spplus-1.2.tar.gz
machine tmp$ cd spplus-1.2
machine kit_php$ autoconf
machine kit_php$ ./configure
machine kit_php$ make

Si vous n'avez pas le programme php-config dans votre PATH, Vous devez utiliser les commandes suivantes :
machine user$ cp spplus-1.2.tar.gz /tmp
machine user$ cd /tmp
machine tmp$ tar xvzf spplus-1.2.tar.gz
machine tmp$ cd spplus-1.2
machine kit_php$ autoconf
machine kit_php$ ./configure -with-php-config=[PATH]
machine kit_php$ make


Si toutes les tapes sont droules correctement, il suffit de placer le fichier "php_spplus.so" dans le rpertoire des extensions PHP (directive extension_dir dans le php.ini) et de dclarer l'extension au niveau du php.ini. (ajout d'une ligne extension=php_spplus.so)
Une fois que vous aurez redmarr le service httpd, le module SP PLUS devrait tre charg sur le serveur et apparatre dans le php info.

Si vous ne souhaitez pas charger cette librairie au niveau du serveur, il est possible d'utiliser la fonction "dl(PATH_EXTENSION);" dans votre script PHP pour charger dynamiquement l'extension SP PLUS uniquement au moment de son utilisation. Pour cela, il est ncessaire que la directive PHP "enable_dl" soit active sur votre serveur. Vous pouvez consulter le php info de votre serveur pour connatre l'tat de cette directive.

Le module hmac SPPLUS est maintenant install et de nouvelles fonctions sont accessible aux utilisateurs du langage.
Le fichier Makefile est donn  titre d'exemple, les includes PHP doivent tre modifis suivant l'installation de PHP sur votre serveur. 
Le compilateur utilis est gcc.


		4) Configuration et Test
		-------------
Les fichiers de tests doivent tre modifis. Pour cela, la valeur des variables suivantes doit tre remplace par les informations propre a votre site.

$clent="58 6d fc 9c 34 91 9b 86 3f fd 64 63 c9 13 4a 26 ba 29 74 1e c7 e9 80 79";
cette information est fournie par le service intgration, Si vous ne l'avez pas reue, vous devez la demander par mail.

$codesiret="00000000000001-001";
il s'agit du code siret de votre entreprise suivi du numro de site (en gnral c'est 01).
Si vous ne la connaissez pas, Le service intgration peut vous communiquer cette information.


Le programme appel_spplus_php.php permet de tester le bon fonctionnement de la librairie php_spplus.so tapez commande suivante :
>php tests/appel_spplus_php.php.


		5)Problmes connus
		------------------
- Certains systmes Unix dfinissent les types ulong, uint, uchar. Si vous rencontrez des problmes de compilation dus a la redfinition de ces types, ditez le fichier common.h et mettez en commentaire la ligne concerne.

- Si des erreurs concernant le fichier  aclocal.m4  apparaissent lors de la compilation, nous vous conseillons de supprimer les lignes 813, 814, 815, 816 et 817 de ce fichier. Si les problmes persistent, vous pouvez remplacer la commande autoconf par phpize.

- Voici diffrentes procdures de compilation  prendre en compte suivant votre distribution Linux : 
  o Diffrentes distributions linux : 
    Problme : erreur lors de l'excution de la commande autoconf sur le fichier aclocal.m4
    Solution : 
       . Modification du fichier aclocal.m4 : suppression des lignes 813, 814, 815, 816 et 817
       . Excuter la commande autoconf
       . Excuter la commande ./configure --target=i386-pc-linux-gnu
       . Excuter la commande make
    Le paramtre target doit tre renseign en fonction des informations propres  votre serveur.

  o Distribution FreeBSD
    Problme : erreur lors de l'excution de la commande autoconf sur le fichier aclocal.m4
    Solution : 
       . Modification du fichier aclocal.m4 : suppression des lignes 813, 814, 815, 816 et 817
       . Excuter la commande autoconf
       . Excuter la commande ./configure --target= freebsd
       . Excuter la commande make


  o Distribution Fedora Core 2 ou 3
    Problme : erreur lors de l'excution de la commande autoconf sur le fichier aclocal.m4
    Solution : 
       . Modification du fichier aclocal.m4 : suppression des lignes 813, 814, 815, 816 et 817
       . Modification du fichier php_spplus.c : Suppression des lignes 22 et 24
       . Excuter la commande autoconf
       . Excuter la commande ./configure --target=i386-pc-linux-gnu
       . Excuter la commande make
    Le paramtre target doit tre renseign en fonction des informations propres  votre serveur.

  o Distribution Fedora Core 4 - architecture 32 bits
    Problme : erreur lors de l'excution de la commande ./configure sur le fichier libtool ou la commande ltconfig.
    Solution : 
       . Modification du fichier aclocal.m4 : suppression des lignes 813, 814, 815, 816 et 817
       . Modification du fichier php_spplus.c : suppression des lignes 22 et 24
       . Excuter la commande autoconf
       . Excuter la commande ./configure --target=i686-redhat-linux-gnu
       . Excuter la commande make

  o Distribution Fedora Core 4 - architecture 64 bits
    Problme : erreur  la ligne 105 du fichier aclocal
    Solution : 
       . Tlcharger le package http://kits.spplus.net/integration/kits/install_fedora_core_4.tar.gz
         Il contient 2 fichiers : configure et libtool
       . Copier le fichier configure du package install_fedora_core_4.tar.gz vers le rpertoire spplus-1.2
       . Excuter la commande ./configure --target=x86_64-redhat-linux-gnu
       . Copier le fichier libtool du package install_fedora_core_4.tar.gz vers le rpertoire spplus-1.2
       . Excuter la commande make


		6)Remarques
		-----------
Le nom de l'archive peut tre diffrent.
Les fichiers sources sont crits en C ANSI. Ils peuvent donc tre facilement compils sur d'autres plates-formes

Un documentation plus complte est disponible. Vous pouvez la demander auprs du service intgration.

