4D Doc Center : Prise en charge des modules PHP

4D v13.4

4D - Langage

PHP

Prise en charge des modules 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,
instructions d’installation de modules supplémentaires.

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
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 ENVIRONMENT
		`// 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 & .NET	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. En outre, 4D prend en charge l’instanciation et la création d’assemblages .Net via la couche COM.
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 v12. 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
Phar (PHP Archive)	http://php.net/phar	Non pertinent dans l’environnement 4D

Installation de modules supplémentaires

L’interpréteur PHP vous laisse la possibilité d’installer des modules supplémentaires. Ce principe vous permet d’accéder à des fonctionnalités spécifiques non présentes par défaut. Vous pouvez installer plusieurs types d’extensions :

extensions PECL (PHP Extension Community Library)
extensions du framework PEAR (PHP Extension and Application Repository)
extensions du framework Zend
extensions du framework Symphony
extensions du framework JELIX
composants eZ

Les informations d’installation pour chaque type d’extension sont fournies ci-dessous.

Note : Les caractéristiques de la version de PHP fournie avec 4D v12 sont les suivantes :

Version 5.3.2
Sous Windows et Mac OS, compilation 32 bits et en mode "thread-safe"

Fichier "php.ini" : Le fichier "php.ini" à modifier (cf. ci-dessous) peut être situé soit dans le dossier Resources de l'application 4D (fichier par défaut) ou dans le dossier de préférences de la base (fichier personnalisé). A ce sujet, reportez-vous à la section Exécuter des scripts PHP dans 4D.

Extensions PECL

Site Web : http://pecl.php.net
Pour ajouter des extensions PECL :

Téléchargez et construisez l’extension PECL souhaitée.
OU
Prenez l’extension déjà construite depuis un package binaire Windows PHP 5.3 VC9 Non Thread Safe (http://windows.php.net/download/#php-5.3-nts-VC9-x86)
Ajoutez l’extension dans le dossier des extensions.
Activez l’extension dans le fichier "php.ini".

Attention : si les extensions disponibles sur le site Web PECL sont sous licence PHP qui n’est pas restrictive, certaines peuvent nécessiter des librairies qui, elles, ont une licence plus contraignante.

Des extensions PHP sont disponibles sur d’autres sites Web, mais elles ne bénéficient pas dans ce cas de la garantie de sécurité apportée par la validation du PHP Group.

Extensions PEAR

Site Web : http://pear.php.net
PEAR est un framework entièrement orienté objet.
Pour ajouter des extensions PEAR :

Téléchargez (http://pear.php.net/package/PEAR/download) et décompactez le package PEAR dans un dossier nommé "pear".
Ajoutez ce dossier "pear" dans le "include_path" défini dans le fichier "php.ini".
Téléchargez et décompactez tout package PEAR dans ce dossier.

Extensions Zend

Téléchargez (http://framework.zend.com/download/latest) et décompactez le framework Zend dans un dossier nommé "zend".
Ajoutez ce dossier "zend" dans le "include_path" défini dans le fichier "php.ini".
Lisez la documentation des composants du framework Zend : http://framework.zend.com/manual/en

Extensions Symphony

Site Web : http://www.symfony-project.org
Le framework Symphony est structuré de manière à être utilisé en tant qu’application Web accompagnée de son contrôleur Web.

Téléchargez et décompactez le framework source ainsi que le bac à sable depuis l’adresse http://www.symfony-project.org/installation/1_2.

Extensions JELIX

Téléchargez (http://jelix.org/articles/en/download/stable) et décompactez le framework JELIX.
Ajoutez le dossier "jelix" résultant dans le "include_path" défini dans le fichier "php.ini".
Lisez la documentation des composants du framework JELIX : http://jelix.org/articles/en/manual-1.1/components

Composants eZ

Téléchargez (http://www.ezcomponents.org/download) et décompactez les composants eZ dans un dossier "ez".
Ajoutez le dossier "ez" dans le "include_path" défini dans le fichier "php.ini".
Lisez la documentation des composants eZ : http://www.ezcomponents.org/docs/api/latest