Chapitre 4
Présentation de la Publication Web personnalisée avec PHP
L’API FileMaker pour PHP permet d’intégrer des données à partir de bases de données FileMaker Pro dans des solutions PHP. Ce chapitre décrit le fonctionnement de PHP avec le moteur de publication Web personnalisé de FileMaker Server et présente un outil permettant de commencer à créer des solutions PHP
: FileMaker PHP Site Assistant. Pour plus d’informations sur l’API FileMaker pour PHP, reportez-vous au
chapitre 5, « Utilisation de l’API FileMaker pour PHP ».
Fonctionnement du moteur de publication Web avec les solutions PHP
FileMaker Server se compose de trois éléments : un serveur Web, le moteur de publication Web et le serveur de bases de données. (Ces éléments peuvent être déployés sur un, deux ou trois ordinateurs. Pour plus d’informations, consultez le Guide de démarrage de FileMaker Server.) FileMaker Server héberge la solution PHP lorsque vous placez les fichiers PHP sur le serveur Web d’installation du moteur PHP.
1
Lorsqu’un utilisateur Web ouvre une solution PHP, le serveur Web achemine la demande vers le moteur
PHP, qui traite le code PHP.
1
Si le code PHP contient des appels vers l’API FileMaker pour PHP, ces appels sont interprétés et envoyés sous la forme de requêtes vers le moteur de publication Web.
1
Le moteur de publication Web recherche les données dans les bases de données hébergées par le serveur de bases de données.
1
Le serveur de bases de données envoie les données demandées au moteur de publication Web.
1
Le moteur de publication Web envoie les données au moteur PHP sur le serveur Web en réponse à l’appel d’API.
1
La solution PHP traite les données et les affiche pour l’utilisateur Web.
Etapes générales de la publication Web personnalisée avec PHP
La présente section récapitule la procédure d’utilisation de la publication Web personnalisée avec PHP :
1. Vérifiez que la Publication PHP est activée dans l’Admin Console. Reportez-vous au Guide de démarrage
de FileMaker Server
.
2. Dans l’Admin Console, choisissez le volet Bases de données et veillez à ce que le privilège étendu fmphp soit activé pour la Publication Web personnalisée avec PHP et ce, pour chaque base de données FileMaker que vous publiez.
Si nécessaire, utilisez FileMaker Pro pour activer la Publication Web personnalisée pour une base de
données. Consultez la section chapitre 3, « Préparation des bases de données pour la Publication Web personnalisée ».
Remarque
Lors de la création de solutions PHP destinées à un utilisateur final, prenez soin d’utiliser des jeux de privilèges d’accès équivalents dans la base de données FileMaker. Dans le cas contraire, vous pouvez avoir accès à des modèles et des fonctions de la base de données FileMaker qui ne seront pas accessibles à l’utilisateur final, ce qui risque d’entraîner des problèmes de fonctionnement.
28 Publication Web personnalisée de FileMaker Server avec PHP
3. Utilisez les outils de création PHP pour créer votre solution PHP.
FileMaker PHP Site Assistant vous permet de créer le code PHP de base pour votre site. Vous pouvez utiliser le code généré sans le modifier ou l’utiliser comme base pour développer un site plus sophistiqué.
Le code PHP généré par PHP Site Assistant contient toutes les conditions préalables et fonctions nécessaires pour accéder aux informations de la base de données FileMaker Pro. Consultez la section
« Utilisation de FileMaker PHP Site Assistant pour générer des sites Web PHP », page 29.
4. Copiez ou déplacez la structure et les fichiers de répertoire de votre site vers le dossier racine du serveur
Web.
1
Pour IIS (Windows) : <disque>:\Inetpub\wwwroot où <disque> est le disque sur lequel réside le composant Moteur de publication Web de votre déploiement de serveur FileMaker.
1
Pour Apache (Mac OS) : /Bibliothèque/WebServer/Documents
5. Si une rubrique de base de données Multimédia stocke une référence à un fichier et non le fichier luimême, l’objet multimédia référencé doit alors être stocké dans le dossier FileMaker Pro Web lorsque l’enregistrement est créé ou modifié. Vous devez copier ou déplacer l’objet dans un dossier possédant le même emplacement relatif dans le dossier racine du logiciel de serveur Web.
Consultez la section « Publication du contenu des rubriques Multimédia sur le Web », page 22.
6. Assurez-vous que les mécanismes de sécurité pour votre site ou votre programme sont mis en œuvre.
7. Testez votre site en utilisant les comptes et les privilèges d’accès définis pour les utilisateurs Web.
8. Mettez le site à la disposition des utilisateurs. L’URL saisie par l’utilisateur Web utilise le format suivant : http://<serveur>/<chemin_site>
1
<serveur> est l’ordinateur sur lequel se trouve FileMaker Server
1
<chemin_site> est le chemin d’accès relatif vers la page d’accueil de votre site, déterminé par la
structure de répertoire que vous avez utilisée à l’étape 4 ci-dessus.
Par exemple, si l’adresse de votre serveur Web est 192.168.123.101 et que la page d’accueil de votre site se trouve sur le serveur Web à l’emplacement c:\Inetpub\wwwroot\customers\index.php, l’utilisateur
Web doit saisir l’URL suivante : http://192.168.123.101/customers/index.php
Remarque
PHP 4 et PHP 5 utilisent le codage Latin-1 (ISO-8859-1). FileMaker Server renvoie des données
Unicode (UTF-8). Utilisez l’Admin Console de FileMaker Server pour spécifier le codage de caractères par défaut de votre site. Pour les sites PHP, vous pouvez spécifier le codage UTF-8 ou ISO-8859-1. Indiquez le même paramètre pour l’attribut charset dans la section <HEAD> des fichiers PHP de votre site.
Chapitre 4
|
Présentation de la Publication Web personnalisée avec PHP 29
Utilisation de FileMaker PHP Site Assistant pour générer des sites
Web PHP
PHP Site Assistant peut vous aider à créer un site Web PHP de base vous permettant d’accéder à, de manipuler et d’afficher les données d’une base de données FileMaker Pro hébergée sur FileMaker Server.
PHP Site Assistant vous guide dans la conception et la configuration de votre site et génère un code PHP basé sur vos saisies. PHP Site Assistant intègre des thèmes préconfigurés afin de définir le style de votre site.
Une fois le code PHP de votre site généré, vous pouvez le personnaliser en utilisant un outil de composition dans le format texte brut ou PHP. Vous pouvez également utiliser PHP Site Assistant pour vous familiariser avec les
éléments de base d’API FileMaker pour PHP et les bases de la publication Web personnalisée avec PHP.
En fonction des options que vous spécifiez, vous pouvez générer des pages permettant aux utilisateurs Web :
1
de parcourir un enregistrement à la fois ;
1
d’afficher une liste de tous les enregistrements de la base de données ;
1
d’effectuer des recherches dans la base de données et de visualiser les résultats dans une liste ;
1
de trier les enregistrements ;
1
d’ajouter des enregistrements ;
1
de modifier et de dupliquer les enregistrements ;
1
de supprimer des enregistrements ;
1
d’afficher un rapport récapitulatif.
Vous pouvez également générer une page d’accueil liée aux autres pages de site Web générées. Pour plus d’informations, reportez-vous à l’Aide de PHP Site Assistant.
Avant d’utiliser PHP Site Assistant
Avant d’utiliser PHP Site Assistant pour créer votre site, effectuez les tâches suivantes :
1. Suivez toutes les étapes exposées dans chapitre 3, « Préparation des bases de données pour la Publication
Web personnalisée ».
2. A l’aide de l’Admin Console de FileMaker Server, vérifiez que le serveur Web et le moteur de publication Web fonctionnent. Pour obtenir des instructions, consultez l’aide de FileMaker Server.
3. Activez la publication Web personnalisée avec PHP dans le moteur de publication Web que vous utiliserez pour exécuter et tester le code PHP. Pour obtenir des instructions, consultez l’aide de FileMaker Server.
4. Lors de la connexion à une base de données à partir de PHP Site Assistant, utilisez un compte avec un jeu de privilèges d’accès équivalent à celui que vous attribueriez aux utilisateurs Web. Pour plus d’informations sur les comptes et les jeux de privilèges d’accès, consultez l’Aide de FileMaker Pro.
Pour plus d’informations sur la connexion à la base de données, consultez l’Aide de PHP Site Assistant.
Démarrage de PHP Site Assistant
PHP Site Assistant est installé sur la machine maître du déploiement FileMaker Server. Vous pouvez utiliser le logiciel depuis tout ordinateur relié en réseau à la machine maître. Au démarrage de PHP Site Assistant,
FileMaker Server utilise la technologie Java Web Start pour télécharger l’application sur l’ordinateur client.
PHP Site Assistant est exécuté sur l’ordinateur client et se connecte à FileMaker Server uniquement lorsqu’un accès à la base de données est nécessaire.
30 Publication Web personnalisée de FileMaker Server avec PHP
Pour lancer PHP Site Assistant
1. Lancez PHP Site Assistant de l’une des façons suivantes :
1
Ouvrez un navigateur Web, puis accédez à la page des outils de publication Web FileMaker Server : http://<hôte>:16000/tools où <hôte> correspond à l’ordinateur maître de votre déploiement
FileMaker Server. Sur la page Outils, cliquez sur Lancer PHP Site Assistant.
1
Dans FileMaker Pro Advanced, sélectionnez le menu Fichier > Ouvrir distant pour ouvrir une base de données hébergée sur FileMaker Server dont le privilège étendu fmphp est activé. Choisissez le menu
Outils > Lancer PHP Assistant.
1
Dans l’Admin Console FileMaker Server, sélectionnez le menu Serveur > Lancer PHP Site Assistant.
Vous pouvez également cliquer sur l’icône PHP Site Assistant dans la barre d’outils de l’Admin Console
FileMaker Server pour lancer PHP Site Assistant.
FileMaker Server télécharge les fichiers nécessaires à votre ordinateur.
2. (Mac OS) Cliquez sur Faire confiance pour continuer.
3. Dans la boîte de dialogue de création des raccourcis, cliquez sur Oui pour créer un raccourci vers PHP
Site Assistant sur l’ordinateur.
Windows : Le raccourci est enregistré sur le bureau.
Mac OS : Indiquez un nom et un emplacement pour le raccourci puis cliquez sur Enregistrer.
4. Vous pouvez désormais utiliser PHP Site Assistant. Pour des instructions complètes sur la création et la génération de votre site, consultez l’Aide de PHP Site Assistant.
Fenêtre PHP Site Assistant
Chapitre 4
|
Présentation de la Publication Web personnalisée avec PHP 31
Remarques
1
Pour démarrer PHP Site Assistant à partir de FileMaker Pro Advanced, vous devez héberger le fichier de base de données actif sur FileMaker Server, puis activer le privilège étendu fmphp dans un jeu de privilèges d’accès pour au moins un compte.
1
Le raccourci n’est plus valable en cas de modification de l’adresse IP de la machine maître du déploiement FileMaker Server. Suivez la procédure ci-dessus pour créer de nouveaux raccourcis.
1
Vous pouvez exécuter PHP Site Assistant si la publication Web est désactivée. Toutefois, sachez que si vous tentez de vous connecter à un serveur pour lequel la publication Web est désactivée, vous obtenez un message d’erreur indiquant l’échec de la connexion.
Utilisation des sites générés par PHP Site Assistant
Vous pouvez utiliser le code PHP généré par PHP Site Assistant sans le modifier, ou bien vous pouvez utiliser vos propres outils de composition PHP ou d’édition de texte pour ajouter des fonctionnalités et du contenu au site généré. Vous pouvez également développer votre site sans utiliser PHP Site Assistant, en intégrant les fonctions de l’API FileMaker à votre code PHP pour accéder à vos données FileMaker.
Consultez la section chapitre 5, « Utilisation de l’API FileMaker pour PHP ».
Pour plus d’informations sur le déploiement et l’utilisation du site généré par PHP Site Assistant, reportez-
vous au chapitre 6, « Stockage, test et suivi d’un site ».
32 Publication Web personnalisée de FileMaker Server avec PHP
