Files
doc-fr/reference/ftp/functions/ftp-pasv.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

128 lines
3.2 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 4d1c34c9b7a30cfc3a59641122c707a2812cfed7 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ftp-pasv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>ftp_pasv</refname>
<refpurpose>Active ou désactive le mode passif</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>ftp_pasv</methodname>
<methodparam><type>FTP\Connection</type><parameter>ftp</parameter></methodparam>
<methodparam><type>bool</type><parameter>enable</parameter></methodparam>
</methodsynopsis>
<para>
<function>ftp_pasv</function> active ou non le mode passif.
En mode passif, les données de connexion sont initiées par le
client, plutôt que par le serveur.
Ce mode peut être nécessaire lorsque le client est derrière un pare-feu.
</para>
<para>
Notez que <function>ftp_pasv</function> ne peut être appelée qu'après
une identification réussie, sinon, la fonction échouera.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>ftp</parameter></term>
<listitem>
&ftp.parameter.ftp;
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>enable</parameter></term>
<listitem>
<para>
Si &true;, le mode passif est activé, sinon, il est désactivé.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&return.success;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
&ftp.changelog.ftp-param;
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Exemple avec <function>ftp_pasv</function></title>
<programlisting role="php">
<![CDATA[
<?php
$file = 'somefile.txt';
$remote_file = 'readme.txt';
// Mise en place d'une connexion basique
$ftp = ftp_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);
// Activation du mode passif
ftp_pasv($ftp, true);
// Chargement d'un fichier
if (ftp_put($ftp, $remote_file, $file, FTP_ASCII)) {
echo "Le fichier $file a été chargé avec succès\n";
} else {
echo "Il y a eu un problème lors du chargement du fichier $file\n";
}
// Fermeture de la connexion
ftp_close($ftp);
?>
]]>
</programlisting>
</example>
</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
-->