<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.ftp.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'pt_BR',
  ),
  'this' => 
  array (
    0 => 'function.ftp-ssl-connect.php',
    1 => 'ftp_ssl_connect',
    2 => 'Abre uma conex&atilde;o SSL-FTP segura',
  ),
  'up' => 
  array (
    0 => 'ref.ftp.php',
    1 => 'Fun&ccedil;&otilde;es da extens&atilde;o FTP',
  ),
  'prev' => 
  array (
    0 => 'function.ftp-size.php',
    1 => 'ftp_size',
  ),
  'next' => 
  array (
    0 => 'function.ftp-systype.php',
    1 => 'ftp_systype',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'pt_BR',
    'path' => 'reference/ftp/functions/ftp-ssl-connect.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.ftp-ssl-connect" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">ftp_ssl_connect</h1>
  <p class="verinfo">(PHP 4 &gt;= 4.3.0, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">ftp_ssl_connect</span> &mdash; <span class="dc-title">Abre uma conexão SSL-FTP segura</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.ftp-ssl-connect-description">
  <h3 class="title">Descrição</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>ftp_ssl_connect</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$hostname</code></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$port</code><span class="initializer"> = 21</span></span>, <span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$timeout</code><span class="initializer"> = 90</span></span>): <span class="type"><span class="type"><a href="class.ftp-connection.php" class="type FTP\Connection">FTP\Connection</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>ftp_ssl_connect()</strong></span> abre uma conexão SSL-FTP <em>explícita</em> com o
   servidor informado em <code class="parameter">hostname</code>. Isso implica que
   <span class="function"><strong>ftp_ssl_connect()</strong></span> terá sucesso mesmo se o servidor não estiver
   configurado para SSL-FTP. Somente quando a função <span class="function"><a href="function.ftp-login.php" class="function">ftp_login()</a></span> for chamada, o cliente enviará o
   comando <code class="literal">AUTH FTP</code> apropriado, portanto <span class="function"><a href="function.ftp-login.php" class="function">ftp_login()</a></span> falhará.
   A conexão estabelecida por <span class="function"><strong>ftp_ssl_connect()</strong></span> <em>não</em> fará
   verificação de certificado de par.
  </p>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <strong>Por que esta função pode não existir</strong><br />
   <p class="para">
    Antes do PHP 7.0.0, <span class="function"><strong>ftp_ssl_connect()</strong></span> só estava disponível se tanto
    o módulo FTP quanto o suporte <a href="ref.openssl.php" class="link">OpenSSL</a>
    tivessem sido construídos estaticamente no PHP. Isso significa que no Windows esta
    função estava indefinida nas compilações oficiais do PHP. Para ter esta
    função disponível no Windows, foi necessário compilar binários PHP próprios.
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <p class="para">
    <span class="function"><strong>ftp_ssl_connect()</strong></span> não se destina ao uso com sFTP.
    Para usar sFTP com PHP, consulte <span class="function"><a href="function.ssh2-sftp.php" class="function">ssh2_sftp()</a></span>.
   </p>
  </p></blockquote>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.ftp-ssl-connect-parameters">
  <h3 class="title">Parâmetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">hostname</code></dt>
     <dd>
      <p class="para">
       O endereço do servidor FTP. Este parâmetro não deve ter barras
       finais e não deve ser prefixado com <code class="literal">ftp://</code>.
      </p>
     </dd>
    
    
     <dt><code class="parameter">port</code></dt>
     <dd>
      <p class="para">
       Este parâmetro especifica uma porta alternativa para conexão. Se for
       omitido ou definido como zero, a porta FTP padrão, 21, será usada.
      </p>
     </dd>
    
    
     <dt><code class="parameter">timeout</code></dt>
     <dd>
      <p class="para">
       Este parâmetro especifica o tempo limite para todas as operações de rede subsequentes.
       Se omitido, o valor padrão será 90 segundos. O tempo limite pode ser alterado e
       consultado a qualquer momento com <span class="function"><a href="function.ftp-set-option.php" class="function">ftp_set_option()</a></span> e
       <span class="function"><a href="function.ftp-get-option.php" class="function">ftp_get_option()</a></span>.
      </p>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.ftp-ssl-connect-returnvalues">
  <h3 class="title">Valor Retornado</h3>
  <p class="para">
   Retorna uma instância de <span class="classname"><a href="class.ftp-connection.php" class="classname">FTP\Connection</a></span> em caso de sucesso, ou <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> em caso de falha.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.ftp-ssl-connect-changelog">
  <h3 class="title">Registro de Alterações</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versão</th>
      <th>Descrição</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.1.0</td>
      <td>
       Retorna uma instância de <span class="classname"><a href="class.ftp-connection.php" class="classname">FTP\Connection</a></span> agora;
       anteriormente, um <span class="type"><a href="language.types.resource.php" class="type resource">resource</a></span> era retornado.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 examples" id="refsect1-function.ftp-ssl-connect-examples">
  <h3 class="title">Exemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Exemplo #1 Exemplo de <span class="function"><strong>ftp_ssl_connect()</strong></span></strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// configura conexão SSL básica<br /></span><span style="color: #0000BB">$ftp </span><span style="color: #007700">= </span><span style="color: #0000BB">ftp_ssl_connect</span><span style="color: #007700">(</span><span style="color: #0000BB">$ftp_server</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// registra com usuário e senha<br /></span><span style="color: #0000BB">$login_result </span><span style="color: #007700">= </span><span style="color: #0000BB">ftp_login</span><span style="color: #007700">(</span><span style="color: #0000BB">$ftp</span><span style="color: #007700">, </span><span style="color: #0000BB">$ftp_user_name</span><span style="color: #007700">, </span><span style="color: #0000BB">$ftp_user_pass</span><span style="color: #007700">);<br /><br />if (!</span><span style="color: #0000BB">$login_result</span><span style="color: #007700">) {<br />    </span><span style="color: #FF8000">// O PHP já teria gerado uma mensagem de nível E_WARNING neste caso<br />    </span><span style="color: #007700">die(</span><span style="color: #DD0000">"não foi possível registrar"</span><span style="color: #007700">);<br />}<br /><br />echo </span><span style="color: #0000BB">ftp_pwd</span><span style="color: #007700">(</span><span style="color: #0000BB">$ftp</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// fecha a conexão SSL<br /></span><span style="color: #0000BB">ftp_close</span><span style="color: #007700">(</span><span style="color: #0000BB">$ftp</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.ftp-ssl-connect-seealso">
  <h3 class="title">Veja Também</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.ftp-connect.php" class="function" rel="rdfs-seeAlso">ftp_connect()</a> - Abre uma conex&atilde;o FTP</span></li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>