archived-doc-fr/reference/soap/soapserver/addfunction.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 577239f64b3959c22d348a5f381eaf32fde996ed Maintainer: jpauli Status: ready -->
<!-- Reviewed: no -->
<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">
<![CDATA[
<?php

function echoString($inputString)
{
    return $inputString;
}

$server->addFunction("echoString");

function echoTwoStrings($inputString1, $inputString2)
{
    return array("outputString1" => $inputString1,
                 "outputString2" => $inputString2);
}
$server->addFunction(array("echoString", "echoTwoStrings"));

$functions = get_defined_functions();
$server->addFunction(array_merge($functions['internal'], $functions['user']));

?>
]]>
    </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>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->