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 base 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 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 base de données.
1
Le serveur de base 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 FileMaker Server Admin Console. Reportez-vous au Guide de
démarrage de FileMaker Server.
2. A l'aide de FileMaker Pro, ouvrez chaque base de données FileMaker que vous publiez et assurez-vous que le privilège étendu fmphp des bases de données est activé pour la publication Web personnalisée avec PHP. Consultez
le 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 é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.
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 rubrique « Utilisation de FileMaker PHP
Site Assistant pour générer des sites Web PHP » page 24.
24
Publication Web personnalisée FileMaker Server avec PHP
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 lui-mê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 rubrique « Publication du contenu des rubriques Multimédia sur le Web » page 19.
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é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 FileMaker Server Admin Console 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.
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 ;
Chapitre 4
|
Présentation de la publication Web personnalisée avec PHP
25
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 au chapitre 3, « Préparation des bases de données pour la publication Web personnalisée ».
2. A l'aide de FileMaker Server Admin Console, 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 équivalent à celui que vous attribueriez aux utilisateurs Web. Pour plus d'informations sur les comptes et les jeux de privilèges, 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.
Pour lancer PHP Site Assistant
1. Ouvrez la page Outils de publication Web FileMaker Server de l'une des façons suivantes :
1
Démarrez un navigateur Web et accédez à http://<serveur>:16000/ tools où <serveur> est l'ordinateur maître de votre déploiement FileMaker Server.
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 l'autorisation étendue fmphp est activée. Choisissez le menu
Outils > Lancer PHP Site Assistant.
2. Sur la page Outils de publication Web FileMaker Server, cliquez sur Lancer PHP Site Assistant.
FileMaker Server télécharge les fichiers nécessaires sur l'ordinateur.
3. (Mac OS) Cliquez sur Faire confiance pour continuer.
4. 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.
5. 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.
26
Publication Web personnalisée FileMaker Server avec PHP
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 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.
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 le 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 ».
