doc-fr/reference/ftp/functions/ftp-ssl-connect.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ftp-ssl-connect" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ftp_ssl_connect</refname>
  <refpurpose>Ouvre une connexion FTP sécurisée avec SSL</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>FTP\Connection</type><type>false</type></type><methodname>ftp_ssl_connect</methodname>
   <methodparam><type>string</type><parameter>hostname</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>port</parameter><initializer>21</initializer></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>timeout</parameter><initializer>90</initializer></methodparam>
  </methodsynopsis>
  <para>
   
   <function>ftp_ssl_connect</function> ouvre <emphasis>explicitement</emphasis> une connexion SSL-FTP 
   à l'<parameter>hostname</parameter> spécifié. Cela implique que
   <function>ftp_ssl_connect</function> réussira même si le serveur n'est pas 
   configuré SSL-FTP, ou si le certificat est invalide. C'est uniquement quand 
   <function>ftp_login</function> est appelé, que le client recevra la 
   commande AUTH FTP appropriée, alors  <function>ftp_login</function> 
   échouera dans les cas mentionnés.
  </para>
  <note>
   <title>Pourquoi cette fonction peut ne pas exister ?</title>
   <para>
    Antérieur à PHP 7.0.0, <function>ftp_ssl_connect</function> n'était
    disponible que si le module ftp et le support <link linkend="ref.openssl">OpenSSL</link>
    avaient été compilé statiquement dans php; cela signifie que, sous Windows,
    cette fonction n'était pas définie dans la version officielle de PHP.
    Afin d'avoir cette fonction disponible sous Windows, il était nécessaire de
    compiler ses propres binaires PHP.
   </para>
  </note>
  <note>
   <para>
    <function>ftp_ssl_connect</function> n'est pas prévu pour fonctionner
    avec sFTP. Pour utiliser sFTP avec PHP, reportez-vous à la fonction
    <function>ssh2_sftp</function>.
   </para>
  </note>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>hostname</parameter></term>
     <listitem>
      <para>
       L'adresse FTP du serveur. Ce paramètre ne doit pas comporter de slash
       final et ne doit pas être préfixé par <literal>ftp://</literal>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>port</parameter></term>
     <listitem>
      <para>
       Ce paramètre spécifie un port alternatif de connexion. S'il est omis ou défini
       à zéro, alors le port par défaut FTP, 21, sera utilisé.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>timeout</parameter></term>
     <listitem>
      <para>
       Ce paramètre spécifie le délai de connexion pour toutes les opérations sur le
       réseau. S'il est omis, la valeur par défaut sera de 90 secondes. Ce délai de connexion
       peut être modifié et consulté à tout moment avec les fonctions 
       <function>ftp_set_option</function> et <function>ftp_get_option</function>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Retourne une instance de <classname>FTP\Connection</classname> en cas de succès,&return.falseforfailure;.
  </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.1.0</entry>
      <entry>
       Retourne désormais une instance de <classname>FTP\Connection</classname> ;
       auparavant, une &resource; était retournée.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Exemple avec <function>ftp_ssl_connect</function></title>
    <programlisting role="php">
<![CDATA[
<?php

// Mise en place d'une connexion basique
$ftp = ftp_ssl_connect($ftp_server);

// Identification avec un nom d'utilisateur et un mot de passe
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);
if (!$login_result) {
    // PHP aura déjà soulevé un message de niveau E_WARNING dans ce cas
    die("can't login");
}

echo ftp_pwd($ftp);

// Fermeture de la connexion SSL
ftp_close($ftp);
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>ftp_connect</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
-->