<?xml version="1.0" encoding="iso-8859-2"?>
<!-- EN-Revision: 1.26 Maintainer: leon Status: ready -->
<!-- $Revision: 1.11 $ -->
 <reference id="ref.ftp">
  <title>FTP</title>
  <titleabbrev>FTP</titleabbrev>

  <partintro>
   <para>
    Funkcje z tego rozszerzenia implementuj kliencki dostp do plikw serwera
    rozpoznajcego File Transfer Protocol FTP opisanego w
    &spec.ftp;.
   </para>

   <para>
    Ponisze stae s zdefiniowane podczas pracy z moduem FTP:
    <constant>FTP_ASCII</constant> i <constant>FTP_BINARY</constant>.
   </para>
  <para>
   Aby mc skorzysta z funkcji FTP, powinno si doda opcj
   <link linkend="install.configure.enable-ftp">
   <option>--enable-ftp</option></link> przy instalacji PHP 4 lub
   <link linkend="install.configure.with-ftp">
   <option>--with-ftp</option></link> uywajc PHP 3.
  </para>
   <para>
    <example>
     <title>Przykad <function>ftp</function></title>
      <programlisting>
<![CDATA[
<?php
// ustaw podstawowe poczenie
$conn_id = ftp_connect("$ftp_server"); 

// zaloguj si nazw uytkownika i hasem
$login_result = ftp_login($conn_id, "$ftp_user_name", "$ftp_user_pass"); 

// sprawd poczenie
if ((!$conn_id) || (!$login_result)) { 
        echo "Poczenie FTP si nie powiodo!";
        echo "Prbowano poczy si do $ftp_server jako uytkownik";
           . $ftp_user_name;
        die; 
    } else {
        echo "Poczony z $ftp_server jako uytkownik $ftp_user_name";
    }

// przelij plik
$upload = ftp_put($conn_id, "$plik_docelowy", "$plik_zrodlowy", FTP_BINARY); 

// sprawd stan operacji
if (!$upload) { 
        echo "Ftp upload has failed!";
    } else {
        echo "Przesano $plik_zrodlowy na $ftp_server jako $plik_docelowy";
    }

// zamknij strumie FTP
ftp_quit($conn_id); 
?>
]]>
     </programlisting>
    </example>
   </para>
  </partintro>

  <refentry id="function.ftp-connect">
   <refnamediv>
    <refname>ftp_connect</refname>
    <refpurpose>Otwiera poczenie FTP</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_connect</methodname>
      <methodparam><type>string</type><parameter>host</parameter></methodparam>
      <methodparam choice="opt"><type>int</type><parameter>port
       </parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca strumie FTP w przypadku sukcesu, lub warto &false; w przypadku
     poraki.
    </para>
    <para>
     <function>ftp_connect</function> otwiera poczenie z hostem podanym w
     parametrze <parameter>host</parameter>.  Paremetr <parameter>port
     </parameter> okrela alternatywny port poczenia. Jeli jest on
     pominity lub rwny zero, uyty bdzie domylny port FTP, czyli 21.
    </para>
   </refsect1>
  </refentry>


  <refentry id="function.ftp-login">
   <refnamediv>
    <refname>ftp_login</refname>
    <refpurpose>Loguje si w poczeniu FTP</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_login</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>nazwa_uzytkownika</parameter></methodparam>
      <methodparam><type>string</type><parameter>haslo</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Loguje si do podanego strumienia FTP.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-pwd">
   <refnamediv>
    <refname>ftp_pwd</refname>
    <refpurpose>Zwraca nazw biecego katalogu</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_pwd</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca nazw biecego katalogu lub &false; w przypadku napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-cdup">
   <refnamediv>
    <refname>ftp_cdup</refname>
    <refpurpose>Zmienia biecy katalog na nadrzdny</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_cdup</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Zmienia biecy katalog na nadrzdny.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-chdir">
   <refnamediv>
    <refname>ftp_chdir</refname>
    <refpurpose>Zmienia katalog na serwerze FTP</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_chdir</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Zmienia biecy katalog na ten okrelony w parametrze
     <parameter>katalog</parameter>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-mkdir">
   <refnamediv>
    <refname>ftp_mkdir</refname>
    <refpurpose>Tworzy katalog</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_mkdir</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Tworzy podany <parameter>katalog</parameter>.
    </para>
    <para>
     W przypadku sukcesu zwraca nazw nowo utworzonego katalogu, lub warto
     &false; w przypadku napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rmdir">
   <refnamediv>
    <refname>ftp_rmdir</refname>
    <refpurpose>Usuwa katalog</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_rmdir</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para> 
     Tworzy podany <parameter>katalog</parameter>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-nlist">
   <refnamediv>
    <refname>ftp_nlist</refname>
    <refpurpose>Zwraca list plikw w podanym katalogu.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>ftp_nlist</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para>
     W przypadku sukcesu zwracana jest tablica z nazwami plikw lub warto
     &false; w przypadku napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rawlist">
   <refnamediv>
    <refname>ftp_rawlist</refname>
    <refpurpose>
     Zwraca szczegow list plikw w podanym katalogu.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>array</type><methodname>ftp_rawlist</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>katalog</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_rawlist</function> wykonuje polecenie FTP LIST i zwraca
     wynik tego polecenia jako tablic. Kady element odpowiada jednej linii
     tekstu. Wyjcie nie jest parsowane w jakikolwiek sposb. Identyfikator
     systemu, zwracany przez <function>ftp_systype</function>, moe by uyty
     do interpretacji wynikw.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-systype">
   <refnamediv>
    <refname>ftp_systype</refname>
    <refpurpose>
     Zwraca identyfikator systemu dla zdalnego serwera FTP.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>string</type><methodname>ftp_systype</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
     </methodsynopsis>
    <para>
     Zwraca typ zdalnego systemu lub &false; w przypadku napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-pasv">
   <refnamediv>
    <refname>ftp_pasv</refname>
    <refpurpose>Wcza/wycza tryb pasywny.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_pasv</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>int</type><parameter>pasywny</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_pasv</function> wcza tryb pasywny jeli parametr
     <parameter>pasywny</parameter> ma warto &true; (wycza tryb pasywyny
     jeli parametr <parameter>pasywny</parameter> ma warto &false;.) W
     trybie pasywnym, poczenia danych s inicjowane przez klienta a nie
     przez serwer.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-get">
   <refnamediv>
    <refname>ftp_get</refname>
    <refpurpose>Pobiera plik z serwera FTP.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_get</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_lokalny</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
      <methodparam><type>int</type><parameter>tryb</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_get</function> pobiera <parameter>plik_zdalny</parameter> z
     serwera FTP i zapisuje go lokalnie jako <parameter>plik_lokalny
     </parameter>. <parameter>tryb</parameter> poczenia musi by podany jako
     <constant>FTP_ASCII</constant> lub <constant>FTP_BINARY</constant>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-fget">
   <refnamediv>
    <refname>ftp_fget</refname>
    <refpurpose>
     Pobiera plik z serwera FTP i zapisuje go do otwartego pliku.
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_fget</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
      <methodparam><type>int</type><parameter>tryb</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_fget</function> pobiera <parameter>plik_zdalny</parameter>
     z serwera FTP i zapisuje go do podanego wskanika,
     <parameter>fp</parameter>.  <parameter>tryb</parameter> musi by podany
     jako <constant>FTP_ASCII</constant> lub <constant>FTP_BINARY</constant>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-put">
   <refnamediv>
    <refname>ftp_put</refname>
    <refpurpose>Umieszcza plik na serwerze FTP.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_put</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_lokalny</parameter></methodparam>
      <methodparam><type>int</type><parameter>tryb</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_put</function> umieszcza <parameter>plik_lokalny</parameter>
     na serwerze jako <parameter>plik_zdalny</parameter>. <parameter>tryb
     </parameter> poczenia musi by okrelony jako
     <constant>FTP_ASCII</constant> lub <constant>FTP_BINARY</constant>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
    <para>
     <example>
      <title>Przykad <function>ftp_put</function></title>
      <programlisting role="php">
<![CDATA[
$upload = ftp_put ($conn_id, "$plik_docelowy", "$plik_zrodlowy", FTP_ASCII);
]]>
      </programlisting>
     </example>
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-fput">
   <refnamediv>
    <refname>ftp_fput</refname>
    <refpurpose>Umieszcza dane z otwartego pliku na serwerze FTP.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_fput</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
      <methodparam><type>int</type><parameter>fp</parameter></methodparam>
      <methodparam><type>int</type><parameter>tryb</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_fput</function> umieszcza na serwerze dane pobrane ze
     wskanika <parameter>fp</parameter> do koca pliku. <parameter>tryb
     </parameter> poczenia musi by okrelony jako
     <constant>FTP_ASCII</constant> lub <constant>FTP_BINARY</constant>
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-size">
   <refnamediv>
    <refname>ftp_size</refname>
    <refpurpose>Zwraca rozmiar podanego pliku.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_size</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_size</function> zwraca rozmiar zdalnego pliku. Jeli
     napotkany zostanie bd lub plik nie istnieje, zwracana jest
     warto -1. Nie wszystkie serwery obsuguj t opcj.
    </para>
    <para>
     W przypadku sukcesu zwraca rozmiar podanego pliku lub -1 w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-mdtm">
   <refnamediv>
    <refname>ftp_mdtm</refname>
    <refpurpose>Zwraca czas ostaniej modyfikacji podanego pliku.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_mdtm</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>plik_zdalny</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_mdtm</function> sprawdza czas ostatniej modyfikacji
     podanego pliku i zwraca to jako UNIX timestamp (ilo sekund od
     1.1.1970). Jeli napotkany zostanie bd lub plik nie istnieje, zwracana
     jest warto -1. Zauwa, e nie wszystkie serwery obsuguj t opcj.
    </para>
    <para>
     W przypadku sukcesu zwraca UNIX timestamp lub -1 w przypadku napotkania
     bdu.
    </para>
    <note>
     <para>
      <function>ftp_mdtm</function> nie dziaa dla katalogw.
     </para>
    </note>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-rename">
   <refnamediv>
    <refname>ftp_rename</refname>
    <refpurpose>Zmienia nazw pliku na serwerze FTP.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>boolean</type><methodname>ftp_rename</methodname>
      <methodparam><type>resource</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>z</parameter></methodparam>
      <methodparam><type>string</type><parameter>na</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_rename</function> zmienia nazw pliku lub katalogu o
     aktualnej nazwie <parameter>z</parameter> na now nazw
     <parameter>na</parameter>, na strumieniu FTP 
     <parameter>strumien_ftp</parameter>.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-delete">
   <refnamediv>
    <refname>ftp_delete</refname>
    <refpurpose>Usuwa plik z serwera FTP.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_delete</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>sciezka</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_delete</function> usuwa plik okrelony przez parametr
     <parameter>ciezka</parameter> z serwera FTP.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-site">
   <refnamediv>
    <refname>ftp_site</refname>
    <refpurpose>Wysya serwerowi polecenie SITE.</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_site</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
      <methodparam><type>string</type><parameter>cmd</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_site</function> wysya do serwera FTP komend okrelon
     przez parametr <parameter>cmd</parameter>. Komendy SITE nie s
     ustandaryzowane i mog si rni midzy serwerami. S one przydatne przy
     obsudze takich rzeczy jak prawa dostpu do plikw i czonkostwo w
     grupach.
    </para>
    <para>
     Zwraca warto &true; w przypadku sukcesu lub &false; w przypadku
     napotkania bdu.
    </para>
   </refsect1>
  </refentry>

  <refentry id="function.ftp-quit">
   <refnamediv>
    <refname>ftp_quit</refname>
    <refpurpose>Zamyka poczenie FTP</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Opis</title>
     <methodsynopsis>
      <type>int</type><methodname>ftp_quit</methodname>
      <methodparam><type>int</type><parameter>strumien_ftp</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>ftp_quit</function> zamyka <parameter>strumien_ftp</parameter>.
    </para>
   </refsect1>
  </refentry>

</reference>
<!-- 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:"../../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=xml
vi: ts=1 sw=1
-->