-
Notifications
You must be signed in to change notification settings - Fork 146
/
ftp-ssl-connect.xml
169 lines (162 loc) · 5.31 KB
/
ftp-ssl-connect.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
<?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
-->