Chapitre 2
A propos de la fonction de publication Web personnalisée avec PHP
La publication Web personnalisée avec PHP vous permet d’utiliser le langage de script PHP pour intégrer des données issues des bases de données FileMaker à vos modèles de page Web personnalisés. La publication Web personnalisée avec PHP fournit l’API FileMaker pour PHP, qui est une classe PHP créée par FileMaker qui accède aux bases de données hébergées par
FileMaker Server. Cette classe PHP se connecte au moteur de publication Web de FileMaker
Server et rend les données disponibles pour le moteur PHP du serveur Web.
Fonctions clés de la publication Web personnalisée avec PHP
1
Créez des applications Web qui utilisent le langage de script PHP Open Source. Utilisez la version de PHP 5 prise en charge par FileMaker Server ou votre propre version de PHP 5.
(Si vous décidez d’utiliser votre propre version de PHP, reportez-vous à la section « Installation manuelle de l’API FileMaker pour PHP », page 13.)
1
Hébergez des bases de données sur FileMaker Server. FileMaker Pro n’est pas requis pour la publication Web personnalisée car FileMaker Server héberge les bases de données.
1
Rédigez un code PHP permettant de créer, de supprimer, d’éditer et de dupliquer les enregistrements d’une base de données FileMaker hébergée. Votre code peut procéder à la validation des rubriques et des enregistrements avant de valider les modifications dans la base de données hébergée.
1
Rédigez un code PHP permettant d’accéder aux modèles, aux tables externes, aux listes de valeurs et aux rubriques liées. Comme dans FileMaker Pro, l’accès aux données, aux modèles et aux rubriques est basé sur les paramètres de compte d’utilisateur définis dans les privilèges d’accès de la base de données. Le moteur de publication Web présente également plusieurs
autres améliorations en matière de sécurité. Consultez la section « Protection de vos bases de données publiées », page 16.
1
Rédigez un code PHP permettant d’exécuter des scripts complexes comportant plusieurs actions. FileMaker prend en charge plus de 65 actions de script dans la publication Web
personnalisée. Consultez la section « Scripts FileMaker et Publication Web personnalisée », page 21.
1
Rédigez un code PHP permettant d’effectuer des requêtes complexes.
Chapitre 2 | A propos de la fonction de publication Web personnalisée avec PHP 12
Configuration de la publication Web personnalisée
Cette section décrit la configuration requise pour développer une solution de Publication Web personnalisée à l’aide de PHP, ce dont les utilisateurs Web ont besoin pour accéder à une solution de Publication Web personnalisée, ainsi que l’impact possible de l’hébergement d’une solution de publication Web sur votre serveur.
Configuration requise pour la publication d’une base de données à l’aide de la
Publication Web personnalisée
Pour publier des bases de données à l’aide de la fonction de publication Web personnalisée avec
PHP, il vous faut :
1
un déploiement FileMaker Server, comprenant trois composants ;
1
un serveur Web, Microsoft IIS (Windows) ou Apache (Mac OS) (le module de serveur Web
FileMaker est installé sur le serveur Web) ;
1
le moteur de publication Web FileMaker ;
1
le serveur de bases de données FileMaker.
1
PHP installé sur le serveur Web. FileMaker Server peut installer la version prise en charge de PHP 5 ou vous pouvez utiliser votre propre version. La version minimale requise de PHP sous Mac OS X v10.6 est PHP 5.3.3. La version minimale requise de PHP sous Windows est PHP 5.3.5. Pour plus d’informations sur PHP, consultez le site http://php.net. La version de PHP installée sur le serveur Web doit prendre en charge les fonctions cURL (bibliothèques d’URL du client). Pour plus d’informations sur cURL, consultez le site http://php.net/curl.
Important
Lorsque vous installez la version de PHP 5 prise en charge par FileMaker Server, elle n’apparaît pas dans l’outil Server Admin de Mac OS X ; elle n’est pas supposée le faire.
Si vous utilisez l’outil Server Admin de Mac OS X pour activer PHP, vous désactivez la version de PHP 5 prise en charge par FileMaker Server et activez votre propre version de PHP.
1
une ou plusieurs bases de données FileMaker Pro hébergées par FileMaker Server ;
1
l’adresse IP ou le nom de domaine de l’hôte exécutant le serveur Web ;
1
un navigateur Web et un accès au serveur Web pour développer et tester la solution de publication Web personnalisée.
Pour plus d’informations, consultez le Guide de démarrage de FileMaker Server.
Eléments devant être employés par les utilisateurs Web pour accéder à une solution de publication Web personnalisée
Pour accéder à une solution de publication Web personnalisée utilisant le langage PHP, les utilisateurs Web doivent posséder :
1
un navigateur Web ;
1
un accès à Internet ou à un intranet, ainsi qu’un accès au serveur Web ;
1
l’adresse IP ou le nom de domaine de l’hôte exécutant le serveur Web.
Si la base de données est protégée par un mot de passe, les utilisateurs Web doivent également saisir un nom d’utilisateur et un mot de passe pour accéder au compte de la base de données.
Chapitre 2 | A propos de la fonction de publication Web personnalisée avec PHP 13
Connexion à Internet ou à un intranet
Lorsque vous publiez des bases de données sur Internet ou sur un intranet, l’ordinateur hôte doit exécuter FileMaker Server et les bases de données que vous souhaitez partager doivent être hébergées et accessibles. En outre :
1
Publiez votre base de données sur un ordinateur possédant une connexion permanente à
Internet ou à un intranet. En effet, si la connexion n’est pas permanente, les utilisateurs Web doivent attendre que l’hôte se connecte à Internet ou à un intranet pour accéder à la base de données.
1
L’ordinateur hôte du serveur Web, partie intégrante du déploiement FileMaker Server, doit posséder une adresse IP statique (permanente) dédiée ou un nom de domaine. Si vous vous connectez à Internet par le biais d’un fournisseur d’accès Internet (FAI), votre adresse IP est généralement attribuée de façon dynamique (elle est donc différente à chaque fois que vous vous connectez). Le cas échéant, les utilisateurs Web auront plus de difficultés à localiser une base de données. Si vous ne savez pas de quel type d’accès vous disposez, contactez votre fournisseur d’accès à Internet ou l’administrateur du réseau.
Installation manuelle de l’API FileMaker pour PHP
Lorsque vous installez FileMaker Server, vous avez la possibilité d’installer la version de PHP prise en charge par FileMaker (PHP 5). Si un moteur PHP est déjà installé et configuré et que vous souhaitez uniquement ajouter l’API FileMaker pour PHP, installez manuellement la classe API
FileMaker pour PHP pour qu’elle soit disponible dans vos scripts PHP.
Si vous n’avez pas installé la version de PHP prise en charge par FileMaker, veillez à effectuer les tâches de configuration suivantes dans votre version du moteur PHP :
1
Activez le module cURL dans php.ini.
1
Indiquez l’emplacement de l’API FileMaker pour PHP dans la variable include_path de php.ini.
1
Si vous accédez à des bases de données contenant des dates et des heures, installez le package Pear de date. Pour plus d’informations, consultez la rubrique : http://pear.php.net/package/date/
Remarque
FileMaker Server a été testé avec la version 5.3.3 de PHP pour Mac OS X v10.6 et avec la version 5.3.5 de PHP pour Windows. Pour des résultats optimums, utilisez la version de
PHP appropriée.
Pour que l’API FileMaker pour PHP soit accessible dans vos scripts PHP
Lorsque vous avez installé FileMaker Server, l’API FileMaker pour PHP a été incluse sous la forme d’un fichier .zip à l’emplacement suivant :
1
Pour IIS (Windows) :
<disque>:\Program Files\FileMaker\FileMaker Server\Web
Publishing\FM_API_for_PHP_Standalone.zip où <disque> correspond au disque sur lequel réside le composant Serveur Web de votre déploiement FileMaker Server.
1
Pour Apache (Mac OS) :
/Bibliothèque/FileMaker Server/Web
Publishing/FM_API_for_PHP_Standalone.zip
Chapitre 2 | A propos de la fonction de publication Web personnalisée avec PHP 14
Le fichier FM_API_for_PHP_Standalone.zip contient un fichier nommé FileMaker.php et un dossier nommé FileMaker. Décompressez ce fichier et copiez le fichier FileMaker.php ainsi que le dossier FileMaker dans l’un des emplacements suivants :
1
le dossier racine du serveur Web dans lequel résident vos scripts PHP ;
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
1
l’un des répertoires include_path de votre installation de PHP. L’emplacement par défaut sous Mac
OS X est /usr/lib/php.
Etape suivante
Voici quelques suggestions pour commencer à développer des solutions de publication Web personnalisée :
1
Utilisez l’Admin Console de FileMaker Server pour activer la publication Web personnalisée.
Reportez-vous à l’aide de FileMaker Server et au Guide de démarrage de FileMaker Server.
1
Dans FileMaker Pro, ouvrez les bases de données FileMaker à publier et assurez-vous que chacune d’entre elles dispose du ou des privilèges d’accès étendus pour la Publication Web
personnalisée. Consultez la section « Activation de la publication Web personnalisée avec
PHP pour les bases de données », page 15.
1
Pour savoir comment accéder aux données des bases de données FileMaker à l’aide de l’API
FileMaker pour PHP, reportez-vous au chapitre 5, « Utilisation de l’API FileMaker pour PHP ».
