ftp-pasv.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: jesusruiz Status: ready -->
<refentry xml:id="function.ftp-pasv" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ftp_pasv</refname>
  <refpurpose>Activa o desactiva el modo pasivo</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>ftp_pasv</methodname>
   <methodparam><type>resource</type><parameter>ftp_stream</parameter></methodparam>
   <methodparam><type>bool</type><parameter>pasv</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>ftp_pasv</function> activa o desactiva el modo pasivo. En
   modo pasivo, las conexiones de datos son iniciadas por el cliente,
   en lugar de por el servidor.
   Puede ser necesaria si el cliente está detrás de un firewall.
  </para>
  <para>
   Tenga en cuenta que <function>ftp_pasv</function> sólo puede ser llamado después de un
   inicio de sesión correcto o de lo contrario fallará.
  </para>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>ftp_stream</parameter></term>
     <listitem>
      <para>
       El identificador de enlace de la conexión FTP.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>pasv</parameter></term>
     <listitem>
      <para>
       Si &true;, el modo pasivo está activado, de lo contrario estará desactivado.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>ftp_pasv</function></title>
    <programlisting role="php">
<![CDATA[
<?php
$file = 'somefile.txt';
$remote_file = 'readme.txt';

// establecer una conexión básica
$conn_id = ftp_connect($ftp_server);

// iniciar sesión con nombre de usuario y contraseña
$login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

// activar modo pasivo
ftp_pasv($conn_id, true);

// cargar un archivo
if (ftp_put($conn_id, $remote_file, $file, FTP_ASCII)) {
 echo "se ha cargado $file con éxito\n";
} else {
 echo "Hubo un problema al cargar $file\n";
}

// cerrar la conexión ftp
ftp_close($conn_id);
?>
]]>
    </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
-->