doc-fr/language/wrappers/ftp.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a71742330defbc0edfbc6822b4f947bf437b2f70 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<refentry xml:id="wrappers.ftp" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" role="noversion">
 <refnamediv>
  <refname>ftp://</refname>
  <refname>ftps://</refname>
  <refpurpose>Accès aux URLs FTP(s)</refpurpose>
 </refnamediv>

 <refsect1 role="description"><!-- {{{ -->
  &reftitle.description;
  <para>
   Permet l'accès en lecture aux fichiers existants, et la création de fichiers, via FTP.
   Si le serveur ne supporte pas FTP en mode passif, la
   connexion échouera.
  </para>
  <simpara>
   Vous pouvez ouvrir des fichiers en lecture ou en écriture, mais
   pas les deux en même temps. Si le fichier distant existe déjà sur le serveur
   ftp et que vous tentez de l'ouvrir en écriture alors que vous n'avez pas
   spécifié l'option <literal>overwrite</literal> dans le contexte,
   la connexion échouera. Si vous devez réécrire des fichiers existants
   en utilisant ftp, spécifiez l'option <literal>overwrite</literal> dans le
   contexte et ouvrez le fichier en écriture. Alternativement, vous pouvez
   utiliser l'<link linkend="ref.ftp">extension FTP</link>.
  </simpara>
  <simpara>
   Si vous avez défini la directive <link linkend="ini.from">from</link>
   dans le fichier &php.ini;, alors cette valeur sera envoyée en tant
   que mot de passe pour les accès FTP anonymes.
  </simpara>
 </refsect1><!-- }}} -->

 <refsect1 role="usage"> <!-- {{{ -->
  &reftitle.usage;
  <itemizedlist>
   <listitem><simpara><filename>ftp://example.com/pub/fichier.txt</filename></simpara></listitem>
   <listitem><simpara><filename>ftp://user:password@example.com/pub/fichier.txt</filename></simpara></listitem>
   <listitem><simpara><filename>ftps://example.com/pub/fichier.txt</filename></simpara></listitem>
   <listitem><simpara><filename>ftps://user:password@example.com/pub/fichier.txt</filename></simpara></listitem>
  </itemizedlist>
 </refsect1> <!-- }}} -->

 <refsect1 role="options"><!-- {{{ -->
  &reftitle.options;
  <para>
   <table>
    <title>Résumé du gestionnaire</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Attribut</entry>
       <entry>Supporté</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>Restreint par <link linkend="ini.allow-url-fopen">allow_url_fopen</link></entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Autorise la lecture</entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Autorise l'écriture</entry>
       <entry>Oui (nouveaux fichiers/fichiers existants avec le paramètre <parameter>overwrite</parameter>)</entry>
      </row>
      <row>
       <entry>Autorise l'ajout</entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Autorise la lecture et l'écriture simultanément</entry>
       <entry>Non</entry>
      </row>
      <row>
       <entry>Support de la fonction <function>stat</function></entry>
       <entry>
        <function>filesize</function>, <function>filetype</function>,
        <function>file_exists</function>, <function>is_file</function>,
        <function>is_dir</function>, et <function>filemtime</function>
        uniquement.
       </entry>
      </row>
      <row>
       <entry>Support de la fonction <function>unlink</function></entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Support de la fonction <function>rename</function></entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Support de la fonction <function>mkdir</function></entry>
       <entry>Oui</entry>
      </row>
      <row>
       <entry>Support de la fonction <function>rmdir</function></entry>
       <entry>Oui</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </refsect1> <!-- }}} -->

 <refsect1 role="notes"><!-- {{{ -->
  &reftitle.notes;
  <note>
   <para>
    FTPS n'est supporté que lorsque l'extension <link linkend="book.openssl">openssl</link>
    est active.
   </para>
   <simpara>
    Si le serveur ne supporte pas SSL, alors la connexion passera automatiquement
    en connexion ftp non chiffrée.
   </simpara>
  </note>
  <note>
   <title>L'ajout</title>
   <simpara>
    L'ajout d'informations à un fichiers est possible avec
    le gestionnaire d'URL <literal>ftp://</literal>.
   </simpara>
  </note>
 </refsect1><!-- }}} -->

 <refsect1 role="seealso"><!-- {{{ -->
  &reftitle.seealso;
  <simplelist>
   <member><xref linkend="context.ftp" /></member>
  </simplelist>
 </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
-->