ftp-ssl-connect.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: d78c0a4f3335f668b36ae2309350649b45486f78 Maintainer: jesusruiz Status: ready -->
<refentry xml:id="function.ftp-ssl-connect" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>ftp_ssl_connect</refname>
  <refpurpose>Abre una conexión segura SSL-FTP</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>resource</type><methodname>ftp_ssl_connect</methodname>
   <methodparam><type>string</type><parameter>host</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> abre una conexión explícita SSL-FTP al 
   <parameter>host</parameter> especificado.
  </para>
  <note>
   <title>Por qué puede que esta función no exista</title>
   <para>
    <function>ftp_ssl_connect</function> sólo está disponible si ambos,
    el módulo de FTP y el soporte de <link linkend="ref.openssl">OpenSSL</link>,
    están construidos de forma estática en PHP, esto significa que en Windows esta función 
 no estará disponible en las compilaciones oficiales de PHP. Para hacer esta
    función disponible en Windows, debe compilar sus propios binarios de PHP.
   </para>
  </note>
  <note>
   <para>
    <function>ftp_ssl_connect</function> no está pensada para su uso con SFTP.
    Para utilizar sFTP con PHP, por favor, consulte <function>ssh2_sftp</function>.
   </para>
  </note>
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>host</parameter></term>
     <listitem>
      <para>
       La dirección del servidor FTP. Este parámetro no debe tener barras al
       final y no debe estar precedido de <literal>ftp://</literal>.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>port</parameter></term>
     <listitem>
      <para>
       Este parámetro especifica un puerto alternativo al que conectarse. Si se
       omite o se define como cero, entonces el puerto por defecto FTP, 21, será utilizado.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>timeout</parameter></term>
     <listitem>
      <para>
       Este parámetro especifica el tiempo de espera para todas las operaciones de red posteriores.
       Si se omite, el valor predeterminado es 90 segundos. El tiempo de espera puede ser cambiado y
       consultado en cualquier momento con <function>ftp_set_option</function> y
       <function>ftp_get_option</function>.
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   Devuelve una secuencia SSL-FTP en caso de éxito o &false; en caso de error.
  </para>
 </refsect1>

 <refsect1 role="changelog">
  &reftitle.changelog;
  <para>
   <informaltable>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>&Version;</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>5.2.2</entry>
       <entry>
        La función se ha cambiado para devolver &false; cuando no se puede utilizar una conexión SSL,
        en lugar de recurrir a una conexión no-SSL como hacía en versiones anteriores.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </informaltable>
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>ftp_ssl_connect</function></title>
    <programlisting role="php">
<![CDATA[
<?php

// establecer la conexión SSL básica
$conn_id = ftp_ssl_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);

echo ftp_pwd($conn_id); // /

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