Manuel PHP
Précédent |  | Suivant

# CXLI. Fonctions SOAP

# Introduction

L'extension SOAP sert à écrire des serveurs et clients SOAP. Elle supporte une partie des spécifications de SOAP 1.1, SOAP 1.2 et WSDL 1.1.

# Pré-requis

Cette extension nécessite la bibliothèque GNOME xml. Téléchargez et installez cette bibliothèque. Vous devez avoir au moins la version libxml-2.5.4.

# Installation

Cette extension est uniquement disponible si PHP a été configuré avec --enable-soap.

# Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier `php.ini`.

Tableau 1. Options de configuration

Nom | Par défaut | Modifiable | Historique
--- | --- | --- | ---
soap.wsdl_cache_enabled | "1" | PHP_INI_ALL | Disponible depuis PHP 5.0.0.
soap.wsdl_cache_dir | "/tmp" | PHP_INI_ALL | Disponible depuis PHP 5.0.0.
soap.wsdl_cache_ttl | 86400 | PHP_INI_ALL | Disponible depuis PHP 5.0.0.

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe G.

Voici un éclaircissement sur l'utilisation des directives de configuration.

soap.wsdl_cache_enabled boolean

  Active ou désactive le cache WSDL.

soap.wsdl_cache_dir string

  Spécifie le nom du dossier où SOAP place les fichiers mis en cache.

soap.wsdl_cache_ttl int

  Nombre de secondes de conservation (time to live) des fichiers dans le système de cache.

# Classes pré-définies

## SoapClient

### Constructeur

- SoapClient->__construct() - construit un nouvel objet SoapClient

### Méthodes

- SoapClient->__call() - Appelle une fonction SOAP (dépréciée)

- SoapClient->__doRequest() - Exécute une requête SOAP

- SoapClient->__getFunctions() - Retourne une liste de fonctions SOAP

- SoapClient->__getLastRequest() - Retourne la dernière requête SOAP

- SoapClient->__getLastRequestHeaders() - Retourne les en-têtes de la dernière requête SOAP

- SoapClient->__getLastResponse() - Retourne la dernière réponse SOAP

- SoapClient->__getLastResponseHeaders() - Retourne les en-têtes de la dernière réponse SOAP

- SoapClient->__getTypes() - Retourne une liste des types SOAP

- SoapClient->__setCookie() - Définit le cookie qui sera envoyé avec la requête SOAP

- SoapClient->__soapCall() - Appel une fonction SOAP

## SoapFault

### Constructeur

- SoapFault->__construct() - construit un nouvel objet SoapFault

## SoapHeader

SoapHeader est une classe de bas niveau pour passer et retourner des en-têtes SOAP. C'est juste un gestionnaire de données et il n'a pas de méthodes spéciales excepté son constructeur. Elle peut être utilisée dans la méthode SoapClient->__soapCall() pour passer un en-tête SOAP ou dans un gestionnaire d'en-têtes SOAP pour retourner l'en-tête dans une réponse SOAP.

### Constructeur

- SoapHeader->__construct() - construit un nouvel objet SoapHeader

## SoapParam

SoapParam est une classe bas niveau pour nommer les paramètres et retourner les valeurs dans le mode non-WSDL. C'est juste un gestionnaire de données et il n'a pas de méthodes spéciales excepté son constructeur.

### Constructeur

- SoapParam->__construct() - construit un nouvel objet SoapParam

## SoapServer

### Constructeur

- SoapServer->__construct() - construit un nouvel objet SoapServer

### Méthodes

- SoapServer->addFunction() - Ajoute une ou plusieurs fonctions qui seront gérées dans les requêtes SOAP

- SoapServer->fault() -

- SoapServer->getFunctions() - Retourne une liste de fonctions définies

- SoapServer->handle() - Gère une requête SOAP

- SoapServer->setClass() - Définit une classe qui sera gérée dans les requêtes SOAP

- SoapServer->setPersistence() - Définit le mode persistant de SoapServer

## SoapVar

SoapVar est une classe bas niveau pour encoder les paramètres et retourner les valeurs dans le mode non-WSDL. C'est juste un gestionnaire de données et n'a pas de méthodes spaciales excepté le constructeur. C'est particulièrement utile lorsque vous voulez définir la propriété type dans une requête ou une réponse SOAP.

### Constructeur

- SoapVar->__construct() - construit un nouvel objet SoapVar

# Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

`SOAP_1_1` (entier)

`SOAP_1_2` (entier)

`SOAP_PERSISTENCE_SESSION` (entier)

`SOAP_PERSISTENCE_REQUEST` (entier)

`SOAP_FUNCTIONS_ALL` (entier)

`SOAP_ENCODED` (entier)

`SOAP_LITERAL` (entier)

`SOAP_RPC` (entier)

`SOAP_DOCUMENT` (entier)

`SOAP_ACTOR_NEXT` (entier)

`SOAP_ACTOR_NONE` (entier)

`SOAP_ACTOR_UNLIMATERECEIVER` (entier)

`SOAP_COMPRESSION_ACCEPT` (entier)

`SOAP_COMPRESSION_GZIP` (entier)

`SOAP_COMPRESSION_DEFLATE` (entier)

`UNKNOWN_TYPE` (entier)

`XSD_STRING` (entier)

`XSD_BOOLEAN` (entier)

`XSD_DECIMAL` (entier)

`XSD_FLOAT` (entier)

`XSD_DOUBLE` (entier)

`XSD_DURATION` (entier)

`XSD_DATETIME` (entier)

`XSD_TIME` (entier)

`XSD_DATE` (entier)

`XSD_GYEARMONTH` (entier)

integer `XSD_GYEAR` (entier)

`XSD_GMONTHDAY` (entier)

`XSD_GDAY` (entier)

`XSD_GMONTH` (entier)

`XSD_HEXBINARY` (entier)

`XSD_BASE64BINARY` (entier)

`XSD_ANYURI` (entier)

`XSD_ANYXML` (integer)

  Ajouté en PHP 5.1.0.

`XSD_QNAME` (entier)

`XSD_NOTATION` (entier)

`XSD_NORMALIZEDSTRING` (entier)

`XSD_TOKEN` (entier)

`XSD_LANGUAGE` (entier)

`XSD_NMTOKEN` (entier)

`XSD_NAME` (entier)

`XSD_NCNAME` (entier)

`XSD_ID` (entier)

`XSD_IDREF` (entier)

`XSD_IDREFS` (entier)

`XSD_ENTITY` (entier)

`XSD_ENTITIES` (entier)

`XSD_INTEGER` (entier)

`XSD_NONPOSITIVEINTEGER` (entier)

`XSD_NEGATIVEINTEGER` (entier)

`XSD_LONG` (entier)

`XSD_INT` (entier)

`XSD_SHORT` (entier)

`XSD_BYTE` (entier)

`XSD_NONNEGATIVEINTEGER` (entier)

`XSD_UNSIGNEDLONG` (entier)

`XSD_UNSIGNEDINT` (entier)

`XSD_UNSIGNEDSHORT` (entier)

`XSD_UNSIGNEDBYTE` (entier)

`XSD_POSITIVEINTEGER` (entier)

`XSD_NMTOKENS` (entier)

`XSD_ANYTYPE` (entier)

`SOAP_ENC_OBJECT` (entier)

`SOAP_ENC_ARRAY` (entier)

`XSD_1999_TIMEINSTANT` (entier)

`XSD_NAMESPACE` (chaîne de caractères)

`XSD_1999_NAMESPACE` (chaîne de caractères)

Précédent | Sommaire | Suivant
snmpwalkoid | Niveau supérieur | is_soap_fault