Files
doc-fr/reference/ftp/functions/ftp-connect.xml
George Peter Banyard 2b0cfd5ba8 Apply commit 4d1c34c9b7a30cfc3a59641122c707a2812cfed7
[PHP 8.1] Use an FTP\Connection instance instead of a resource
2021-09-24 21:01:19 +01:00

140 lines
4.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.ftp-connect" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ftp_connect</refname>
<refpurpose>Ouvre une connexion FTP</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>FTP\Connection</type><type>false</type></type><methodname>ftp_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_connect</function> ouvre une connexion FTP avec l'hôte
<parameter>hostname</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>hostname</parameter></term>
<listitem>
<para>
L'adresse du serveur FTP. Ce paramètre ne doit jamais avoir 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 numéro de port alternatif pour la connexion.
S'il est omis ou définie à zéro, alors le port FTP par défaut, 21, sera utilisé.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>timeout</parameter></term>
<listitem>
<para>
Ce paramètre spécifie le délai de connexion en secondes pour toutes les opérations ultérieures en réseau.
S'il est omis, la valeur par défaut sera 90 secondes. Le délai
de connexion peut être modifié et interrogé à n'importe quel 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_connect</function></title>
<programlisting role="php">
<![CDATA[
<?php
$ftp_server = "ftp.example.com";
// Mise en place d'une connexion
$ftp = ftp_connect($ftp_server) or die("Impossible de se connecter au serveur $ftp_server");
?>
]]>
</programlisting>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>ftp_close</function></member>
<member><function>ftp_ssl_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
-->