Files
doc-fr/reference/radius/functions/radius-add-server.xml
Yannick Torres de338c7aef Convert to UTF-8
git-svn-id: https://svn.php.net/repository/phpdoc/fr/trunk@297687 c90b9560-bf6c-de11-be94-00142212c4b1
2010-04-08 08:39:50 +00:00

154 lines
4.7 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.radius-add-server" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>radius_add_server</refname>
<refpurpose>Ajoute un serveur</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>radius_add_server</methodname>
<methodparam><type>resource</type><parameter>radius_handle</parameter></methodparam>
<methodparam><type>string</type><parameter>hostname</parameter></methodparam>
<methodparam><type>int</type><parameter>port</parameter></methodparam>
<methodparam><type>string</type><parameter>secret</parameter></methodparam>
<methodparam><type>int</type><parameter>timeout</parameter></methodparam>
<methodparam><type>int</type><parameter>max_tries</parameter></methodparam>
</methodsynopsis>
<para>
<function>radius_add_server</function> peut être utilisé plusieurs fois, et il
peut être utilisé avec la fonction <function>radius_config</function>.
Tout au plus, 10 serveurs peuvent être spécifiés. Lorsque plusieurs serveurs sont fournis,
ils sont essayés à la façon <literal>round-robin</literal> tant qu'une réponse valide
n'est pas reçue, ou tant que la limite <parameter>max_tries</parameter>
de chaque serveur n'est pas atteinte.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>radius_handle</parameter></term>
<listitem>
<para>
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
Le paramètre <parameter>hostname</parameter> spécifie l'hôte serveur,
soit en tant que nom de domaine qualifié, soit en tant qu'adresse IP.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>port</parameter></term>
<listitem>
<para>
Le <parameter>port</parameter> spécifie le port UDP à
contacter sur le serveur. Si le port donné vaut &zero;, la bibliothèque
recherchera le service <systemitem class="resource">radius/udp</systemitem> ou
<systemitem class="resource">radacct/udp</systemitem>
dans la base de données des services du réseau et utilisera le port
s'y trouvant. Si aucune entrée n'est trouvée, la bibliothèque utilisera les ports
Radius standards, 1812 pour l'identification et 1813 pour les comptes.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>secret</parameter></term>
<listitem>
<para>
Le secret partagé pour l'hôte serveur est passé au paramètre
<parameter>secret</parameter>. Le protocole Radius ignore
tout mais garde les 128 premiers octets du secret partagé.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
Le délai limite pour recevoir les réponses du serveur est passé au
paramètre <parameter>timeout</parameter>, sous la forme de seconde.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>max_tries</parameter></term>
<listitem>
<para>
Le nombre maximal de requêtes répétées à faire avant d'échouer.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>radius_add_server</function></title>
<programlisting role="php">
<![CDATA[
<?php
if (!radius_add_server($res, 'radius.example.com', 1812, 'testing123', 3, 3)) {
echo 'Erreur Radius :' . radius_strerror($res). "\n<br>";
exit;
}
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>radius_config</function></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
-->