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 17).
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 Utilisez PHP Site Assistant pour créer le code PHP d’un site Web qui accède aux données d’une base
de données FileMaker hébergée. Consultez la section « Utilisation de FileMaker PHP Site Assistant pour
générer des sites Web PHP », page 29
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 20
1 Rédigez un code PHP permettant d’exécuter des scripts complexes comportant plusieurs actions.
FileMaker prend en charge plus de 75 actions de script dans la publication Web personnalisée.
Consultez la section « Scripts FileMaker et Publication Web personnalisée », page 23
1 Rédigez un code PHP permettant d’effectuer des requêtes complexes.
Configuration pour la publication Web
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. 16 Publication Web personnalisée de FileMaker Server avec PHP
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 Windows et sous
Mac OS X v10.5 est PHP 5.2.11. La version minimale requise de PHP sous Mac OS X v10.6 est
PHP 5.3.0. 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.
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.Chapitre 2 | A propos de la fonction de publication Web personnalisée avec PHP 17
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 le site : http://pear.php.net/package/date/
Remarque FileMaker Server a été testé avec la version 5.2.11 de PHP sous Windows et sous Mac OS X v10.5,
ainsi qu’avec la version 5.3.0 sous Mac OS X v10.6. Pour des résultats optimums, utilisez la version
appropriée de PHP.
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
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. 18 Publication Web personnalisée de FileMaker Server avec 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 19
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 ».
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 17).
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 Utilisez PHP Site Assistant pour créer le code PHP d’un site Web qui accède aux données d’une base
de données FileMaker hébergée. Consultez la section « Utilisation de FileMaker PHP Site Assistant pour
générer des sites Web PHP », page 29
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 20
1 Rédigez un code PHP permettant d’exécuter des scripts complexes comportant plusieurs actions.
FileMaker prend en charge plus de 75 actions de script dans la publication Web personnalisée.
Consultez la section « Scripts FileMaker et Publication Web personnalisée », page 23
1 Rédigez un code PHP permettant d’effectuer des requêtes complexes.
Configuration pour la publication Web
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. 16 Publication Web personnalisée de FileMaker Server avec PHP
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 Windows et sous
Mac OS X v10.5 est PHP 5.2.11. La version minimale requise de PHP sous Mac OS X v10.6 est
PHP 5.3.0. 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.
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.Chapitre 2 | A propos de la fonction de publication Web personnalisée avec PHP 17
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 le site : http://pear.php.net/package/date/
Remarque FileMaker Server a été testé avec la version 5.2.11 de PHP sous Windows et sous Mac OS X v10.5,
ainsi qu’avec la version 5.3.0 sous Mac OS X v10.6. Pour des résultats optimums, utilisez la version
appropriée de PHP.
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
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. 18 Publication Web personnalisée de FileMaker Server avec 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 19
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 ».
