<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="soapserver.addfunction" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<refnamediv>

<refname>SoapServer::addFunction</refname>

<refpurpose>Ajoute une ou plusieurs fonctions qui vont gérer les requêtes SOAP</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis role="SoapServer">

<modifier>public</modifier> <type>void</type><methodname>SoapServer::addFunction</methodname>

<methodparam><type class="union"><type>array</type><type>string</type><type>int</type></type><parameter>functions</parameter></methodparam>

</methodsynopsis>

<para>

Exporte une ou plusieurs fonctions pour les clients distants.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>functions</parameter></term>

<listitem>

<para>

Pour exporter une seule fonction, il faut passer son nom dans ce paramètre

en tant que chaîne de caractères.

</para>

<para>

Pour exporter plusieurs fonctions, il faut utiliser

un tableau de noms de fonctions.

</para>

<para>

Pour exporter toutes les fonctions, il faut passer un tableau

de noms de fonctions.

</para>

<para>

À partir de PHP 8.4.0, passer une valeur entière (dont

<constant>SOAP_FUNCTIONS_ALL</constant>) est déprécié.

Utiliser <function>get_defined_functions</function> comme remplacement

pour <constant>SOAP_FUNCTIONS_ALL</constant>.

</para>

<note>

<para>

<parameter>functions</parameter> doit recevoir tous les arguments d'entrée

dans le même ordre que celui défini dans le fichier WSDL (il ne doit

recevoir aucun paramètre de sortie en tant qu'argument) et retourne

une ou plusieurs valeurs. Pour retourner plusieurs valeurs, il doit retourner

un tableau contenant le nom des paramètres de sortie.

</para>

</note>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

&return.void;

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.4.0</entry>

<entry>

Passer un entier à <methodname>SoapServer::addFunction</methodname>

est désormais déprécié.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Exemple avec <function>SoapServer::addFunction</function></title>

<programlisting role="php">

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><methodname>SoapServer::__construct</methodname></member>

<member><methodname>SoapServer::setClass</methodname></member>

</simplelist>

</para>

</refsect1>

</refentry>