Prise en charge des modules PHP

4D v19.8

PHP

Cette annexe détaille l’implémentation des modules PHP dans 4D. Les sujets suivants sont abordés :

liste des modules standard PHP fournis par défaut avec l’interpréteur PHP de 4D
liste des modules standard PHP non retenus par 4D.
modifications du fichier php.ini.

Note : Si vous souhaitez installer des modules supplémentaires, vous devez utiliser un interpréteur fastcgi-php externe (cf. Utiliser un autre interpréteur PHP).

Modules fournis par défaut

Le tableau suivant détaille les modules PHP fournis par défaut avec 4D.

Modules génériques

Nom	Site Web	Description
BCMath	http://php.net/bc	Calculateur binaire qui prend en charge des nombres de n’importe quelle taille et précision représentés sous forme de chaînes.
		Exemple :
		`C_ENTIER LONG($valeur;$resultat) $valeur:=4 $ok:=PHP Executer("";"bcpow";$resultat;$valeur;3)`
Calendar	http://php.net/calendar	Ensemble de fonctions simplifiant la conversion entre les différents formats de calendriers. Se base sur le Jour Julien.
		Exemple :
		`C_ENTIER LONG($NumberOfDays) $ok:=PHP Executer("";"cal_days_in_month";$NumberOfDays;1;2;2010)`
Ctype	http://php.net/ctype	Fonctions vérifiant si un caractère ou une chaîne appartient à une certaine classe de caractères, suivant la configuration locale courante
		Exemple :
		`// Vérifier que tous les caractères d'une chaîne sont des signes de ponctuation C_TEXTE($maChaine) $maChaine:=",.;/" $ok:=PHP Executer("";"ctype_punct";$isPunct;$maChaine)`
Date and Time	http://php.net/datetime	Récupération de la date et de l'heure depuis le serveur où le script PHP s'exécute
		Exemple : `//calcul de l’heure du lever du soleil à Lisbonne, Portugal //Latitude: 38.4 Nord //Longitude: 9 Ouest //Zénith ~= 90 //Décalage: +1 GMT C_HEURE($SunriseTime) $ok:=PHP Executer("";"date_sunrise";$SunriseTime;0;1;38,41;-9;90;1)`
DOM (Document Object Model)	http://php.net/dom	Utilisation de documents XML via l'API DOM de PHP 5
Exif	http://php.net/exif	Travail avec les méta-données des images.
Fileinfo(*)	http://php.net/fileinfo	Détection du type de contenu et de l'encodage d'un fichier.
Filter	http://php.net/filter	Valider et filtrer les données issues de source non sécurisée, comme les entrées des utilisateurs.
		Exemple :
		`C_ENTIER LONG($filterId) C_TEXTE($result) $ok:=PHP Executer("";"filter_id";$filterId;"validate_email") $ok:=PHP Executer("";"filter_var";$result;"hop@123.com";$filterId)`
FTP (File Transfert Protocol)	http://php.net/ftp	Accès détaillé à un serveur FTP
Hash	http://php.net/hash	Moteur d'empreinte numérique. Permet le traitement direct ou incrémental de message de grandeur arbitraire en utilisant une variété d'algorithmes
		Exemple :
		`C_TEXTE($md5Result) $ok:=PHP Executer("";"md5";$md5Result;"ceci est ma chaîne a hacher")`
GD (Graphics Draw) Library	http://php.net/gd	Manipulation d’images
Iconv	http://php.net/iconv	Conversion de fichiers entre divers jeux de caractères
JSON (JavaScript Object Notation)	http://php.net/json	Implémentation du format d'échange de données JSON
LDAP	http://php.net/ldap	LDAP est un protocole d’accès aux "serveurs de dossiers" stockant les informations sous forme d'arborescence
LibXML	http://php.net/libxml	Librairie de fonctions et constantes XML
LibXSLT	http://php.net/xsl	Librairie de fonctions de transformation XSLT
Multibyte String	http://php.net/mbstring	Ensemble de fonctions de manipulation de chaînes qui vous permet de travailler avec les encodages multi-octets ou de traduire des jeux de caractères.
OpenSSL	http://php.net/openssl	Utilisation des fonctions de OpenSSL pour générer et vérifier les signatures, sceller (chiffrer) et ouvrir (déchiffrer) les données.
PCRE (Perl Compatible Regular Expressions)	http://php.net/pcre	Ensemble de fonctions qui implémentent les expressions rationnelles en utilisant la même syntaxe et sémantique que Perl 5
		Exemple :
		`//Cet exemple supprime les espaces superflus d’une chaîne. C_TEXTE($maChaine) $maChaine:="foo o bar" PHP Executer("";"preg_replace";$maChaine;"/\\s\\s+/";" ";$maChaine) ALERTE($maChaine) //La chaine contient maintenant 'foo o bar' sans espaces dupliqués`
PDO (PHP Data Objects)	http://php.net/pdo	Interface d’accès à une base de données. Nécessite un driver PDO spécifique à la base de données.
PDO_SQLITE	http://php.net/pdo_sqlite	Pilote qui implémente l'interface de PHP Data Objects (PDO) pour autoriser l'accès de PHP aux bases de données SQLite 3.
Reflection	http://php.net/reflection	API de réflexion complète qui permet de faire du reverse-engineering sur les classes, les interfaces, les fonctions, les méthodes, les extensions
Phar (PHP Archive)	http://php.net/phar	Permet d’inclure une application PHP complète dans un fichier unique appelé "phar" (PHP Archive) pour faciliter son installation et sa configuration
Session	http://php.net/session	Prise en charge de sessions PHP
		Exemple :
		Les sessions sont utilisées dans les applications Web pour conserver le contexte entre chaque requête. Lorsque vous appelez PHP Executer dans 4D, le script PHP peut démarrer une session et stocker tout ce qui est utile à conserver comme contexte dans le tableau associé $_SESSION. Si un script PHP utilise des sessions vous devez obtenir l’ID de session retourné par PHP à l’aide de la commande PHP LIRE REPONSE COMPLETE et le définir avant chaque appel à PHP Executer à l’aide de la commande FIXER VARIABLE ENVIRONNEMENT
		`// Méthode "PHP Exécuter avec contexte" Si(<>PHP_Session#"") FIXER VARIABLE ENVIRONNEMENT("HTTP_COOKIE";<>PHP_Session) Fin de si Si(PHP Executer($1)) PHP LIRE REPONSE COMPLETE($0;$errorInfos;$errorValues;$headerFields;$headerValues) $idx:=Chercher dans tableau($headerFields;"Set-Cookie") Si($idx>0) <>PHP_Session:=$headerValues{$idx} Fin de si Fin de si`
SimpleXML	http://php.net/simpleXML	Outils très simples et faciles à utiliser pour convertir du XML en un objet qui peut être manipulé avec ses propriétés et les itérateurs de tableaux
Sockets	http://php.net/sockets	Implémentation d’une interface bas niveau avec les fonctions de communication par socket basées sur les sockets BSD et fournit la possibilité de fonctionner aussi bien sous forme de client que de serveur.
SPL (Standard PHP Library)	http://php.net/spl	Collection d’interfaces et de classes utilitaires créés pour résoudre les problèmes usuels.
SQLite	http://php.net/sqlite	Extension pour le moteur de base de données SQLite. Ce moteur peut être embarqué.
SQLite3	http://php.net/sqlite3	Support pour les bases de données SQLite version 3
Tokenizer	http://php.net/tokenizer	Fonctions vous permettant d’écrire vos propres outils PHP d'analyse ou de modifications sans avoir à vous soucier de la spécification du langage au niveau lexical
XML (eXtensible Markup Language)	http://php.net/xml	Analyse des documents XML
XMLreader	http://php.net/xmlreader	Analyseur XML Pull
XMLwriter	http://php.net/xmlwriter	Génération de flux et de fichiers au format XML
Zlib	http://php.net/zlib	Lecture et écriture de fichiers compressés gzip (.gz)
		Exemple :
		WEB LIRE ENTETE HTTP($names;$values) $pos:=Chercher dans tableau($names;"Accept-Encoding") Si($pos>0) Au cas ou :(Position($values{$pos};"gzip")>0) WEB FIXER ENTETE HTTP("Content-Encoding: gzip") PHP Executer("";"gzencode";$html;$html) :(Position($values{$pos};"deflate")>0) WEB FIXER ENTETE HTTP("Content-Encoding: deflate") PHP Executer("";"gzdeflate";$html;$html) Fin de cas Fin de si WEB ENVOYER TEXTE($html)
Zip	http://php.net/zip	Lecture et écriture des archives compressées ZIP et des fichiers s’y trouvant

(*) Dans la version actuelle de 4D, ces modules ne sont pas disponibles sous Windows.

Modules disponibles sous Windows uniquement

Pour des raisons structurelles, les modules PHP suivants ne sont disponibles que sur la plate-forme Windows.

Nom	Site Web	Description
COM	http://php.net/com	COM (Component Object Model) est l'une des méthodes les plus utilisées pour faire communiquer des applications et des composants sur les plates-formes Windows. Note: L’instanciation et la création d’assemblages .Net via la couche COM n'est plus supporté a partir de 4D v17 R5.
ODBC (Open DataBase Connectivity)	http://php.net/odbc	En plus du support de l'ODBC standard, l'ODBC unifié de PHP vous donne accès à diverses bases de données qui ont emprunté la sémantique des API ODBC pour implémenter leur propres API.
WDDX (Web Distributed Data eXchange)	http://php.net/wddx	Facilite les échanges de données inter-applications Web via le Web, quelle que soit la plate-forme

Modules désactivés

Les modules PHP suivants n’ont pas été implémentés dans 4D. La colonne de droite fournit la raison de cette non-implémentation :

Nom	Site Web	Cause - Solution alternative
Mimetype	http://php.net/mime-magic	Obsolète (Deprecated) - Utiliser Fileinfo
POSIX (Portable Operating System Interface)	http://php.net/posix	Obsolète (Deprecated)
Regular Expression (POSIX Extended)	http://php.net/regex	Obsolète (Deprecated) - Utiliser PCRE
Crack	http://php.net/crack	Licence restrictive
ffmpeg	http://ffmpeg-php.sourceforge.net/	Licence restrictive - Utiliser ffmpeg en ligne de commande avec LANCER PROCESS EXTERNE
Image Magick	http://php.net/manual/book.imagick.php	Licence restrictive - Utiliser GD 2
IMAP (Internet Message Access Protocol)	http://php.net/imap	Licence restrictive - Utiliser le plug-in intégré 4D Internet Commands
PDF (Portable Document Format)	http://php.net/pdf	Licence restrictive - Utiliser Haru PDF
Mysqlnd (MySQL Native Driver)	http://dev.mysql.com/downloads/connector/php-mysqlnd/	Non pertinent dans l’environnement 4D

Personnaliser le fichier php.ini

Le fichier "php.ini" à modifier (cf. ci-dessous) peut être situé soit dans le dossier Resources\php de l'application 4D (fichier par défaut) ou dans le dossier Resources de la base (fichier personnalisé). Reportez-vous également à la section Exécuter des scripts PHP dans 4D.

Attention : La modification du fichier "php.ini" doit être effectuée avec précaution et requiert une bonne connaissance de PHP. Pour plus d’informations sur la configuration des fichiers php.ini personnalisés, veuillez consulter les commentaires placés dans le fichier php.ini fourni par 4D.

Note : Si la durée du traitement PHP est relativement longue (au-delà de 30 secondes), par défaut une erreur de type 'timeout' sera retournée dans 4D et le traitement échouera. Dans ce cas, vous pouvez configurer le timeout par défaut afin d'allouer davantage de temps à l'exécution PHP. Pour cela, vous disposez de deux possibilités :

fixer la variable max_execution_time dans le fichier "php.ini" (passez une valeur en secondes). Attention, ce paramétrage affectera tous les scripts.
appeler la commande set_time_limit(nbSec) dans le script d'exécution PHP effectuant le traitement long. Passez dans nbSec le délai maximum alloué à l'exécution du script PHP. Ce paramétrage est conseillé car il n'affecte que le script. De manière générale, pour des raisons de sécurité il est préférable de conserver une valeur de timeout réduite pour les scripts PHP.