cvs: phpdoc /en/appendices wrappers.xml

philip Fri Dec 27 11:49:25 2002 EDT Modified files: /phpdoc/en/appendices wrappers.xml Log: Revert sk invasion.

Index: phpdoc/en/appendices/wrappers.xml diff -u phpdoc/en/appendices/wrappers.xml:1.9 phpdoc/en/appendices/wrappers.xml:1.10 --- phpdoc/en/appendices/wrappers.xml:1.9 Thu Dec 26 20:40:20 2002 +++ phpdoc/en/appendices/wrappers.xml Fri Dec 27 11:49:25 2002 @@ -1,19 +1,19 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- EN-Revision: 1.8 Maintainer: joseph Status: ready --> +<!-- $Revision: 1.10 $ --> <appendix id="wrappers"> - <title>Zoznam Podporovaných Protokolov/Balíèkov</title> + <title>List of Supported Protocols/Wrappers</title> <para> - Následujúce je zoznam rôznych ¹týlových protokolov URL, ktoré - má PHP vstavané pre pou¾itie s filesystem funkciami ako sú - <function>fopen</function> a <function>copy</function>. - Okrem týchto balíèkov (wrappers), ako aj tých v PHP 4.3, si - mô¾te napísa» svoje vlastné balíèky s pou¾itím PHP skriptu a + The following is a list of the various URL style protocols that + PHP has built-in for use with the filesystem functions such as + <function>fopen</function> and <function>copy</function>. + In addition to these wrappers, as of PHP 4.3, you can write + your own wrappers using PHP script and <function>stream_register_wrapper</function>. </para> <section id="wrappers.http"> - <title>HTTP a HTTPS</title> - <simpara>PHP 3, PHP 4. <filename>https://</filename> od PHP 4.3</simpara> + <title>HTTP and HTTPS</title> + <simpara>PHP 3, PHP 4. <filename>https://</filename> since PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>http://example.com</filename></simpara></listitem> @@ -22,38 +22,39 @@ <listitem><simpara><filename>https://user:password@example.com</filename></simpara></listitem> </itemizedlist> - <simpara>Umo¾òuje prístup iba na èítanie k súborom/zdrojom cez HTTP 1.0 - pou¾itím metódy HTTP GET. Hlavièka <literal>Host:</literal> sa po¹le - s po¾iadavkou na zaistenie na mene zalo¾ených virtuálnych hostov. Ak - ste nakonfigurovali re»azec <link linkend="ini.user-agent">user_agent</link> - pou¾itím vá¹ho ini súboru alebo prúdového kontextu, taktie¾ sa zahrnie - do po¾iadavky. - </simpara> - <simpara> - Uz PHP 4.0.5 podporuje presmerovania; ak pou¾ívate predchádzajúce - verzie, budete musie» zahrnú» vleèné lomítka do svojich URL adries. - </simpara> - <simpara> - Prúd umo¾òuje prístup k <emphasis>telu</emphasis> - zdroja; hlavièky sú ulo¾ené v premennej - <varname>$http_response_header</varname>. - Od PHP 4.3, hlavièky sú dostupné pou¾itím + <simpara>Allows read-only access to files/resources via HTTP 1.0, + using the HTTP GET method. A <literal>Host:</literal> header is sent with the request + to handle name-based virtual hosts. If you have configured + a <link linkend="ini.user-agent">user_agent</link> string using + your ini file or the stream context, it will also be included + in the request. + </simpara> + <simpara> + Redirects have been supported since PHP 4.0.5; if you are using + an earlier version you will need to include trailing slashes in + your URLs. + </simpara> + <simpara> + The stream allows access to the <emphasis>body</emphasis> of + the resource; the headers are stored in the + <varname>$http_response_header</varname> variable. + Since PHP 4.3, the headers are available using <function>stream_get_meta_data</function>. </simpara> <simpara> - Pripojenia cez HTTP sú iba na èítanie; nemô¾ete zapisova» dáta - alebo kopírova» súbory do HTTP zdroja. + HTTP connections are read-only; you cannot write data or copy + files to an HTTP resource. </simpara> <note> - <simpara>HTTPS podporovalo u¾ PHP 4.3, ak ste - kompilovali s podporou pre OpenSSL. + <simpara>HTTPS is supported starting from PHP 4.3, if you + have compiled in support for OpenSSL. </simpara> </note> </section> <section id="wrappers.ftp"> - <title>FTP a FTPS</title> - <simpara>PHP 3, PHP 4. <filename>ftps://</filename> od PHP 4.3</simpara> + <title>FTP and FTPS</title> + <simpara>PHP 3, PHP 4. <filename>ftps://</filename> since PHP 4.3</simpara> <itemizedlist> <listitem><simpara><filename>ftp://example.com/pub/file.txt</filename></simpara></listitem> @@ -63,37 +64,37 @@ </itemizedlist> <simpara> - Umo¾òuje prístup na èítanie k existujúcim súborom a tvorbu - nových cez FTP. Ak server nepodporuje pasívny mód ftp, spojenie - zlyhá. - </simpara> - <simpara> - Mô¾te otvára» súbory buï na èítanie alebo zápis, ale nie oboje - zároveò. Ak u¾ vzdialený súbor existuje na ftp serveri - a pokú¹ate sa ho otvori» na zapisovanie, spojenie zlyhá. Ak - potrebujete obnovi» existujúci súbor cez ftp, pou¾ite - <function>ftp_connect</function>. - </simpara> - <simpara> - <filename>ftps://</filename> bol predstavený v PHP 4.3. - Je to rovnaké ako s <filename>ftp://</filename>, - ale pokú¹a sa vyhµada» bezpeèné spojenie s ftp serverom. Ak server - nepodporuje SSL, potom sa spojenie navráti k regulérnemu - kryptovanému ftp. + Allows read access to existing files and creation of new files + via FTP. If the server does not support passive mode ftp, the + connection will fail. + </simpara> + <simpara> + You can open files for either reading or writing, but not both + simultaneously. If the remote file already exists on the ftp + server and you attempt to open it for writing, the connection + will fail. If you need to update existing files over ftp, + use <function>ftp_connect</function>. + </simpara> + <simpara> + <filename>ftps://</filename> was introduced in PHP 4.3. + It is the same as <filename>ftp://</filename>, + but attempts to negotiate a secure connection with the ftp server. + If the server does not support SSL, then the connection falls back + to regular unencrypted ftp. </simpara> <note> - <simpara>FTPS podporovalo u¾ PHP 4.3, ak ste - kompilovali s podporou pre OpenSSL. + <simpara>FTPS is supported starting from PHP 4.3, if you + have compiled in support for OpenSSL. </simpara> </note> </section> <section id="wrappers.php"> - <title>Vstupné/Výstupné prúdy PHP</title> + <title>PHP input/output streams</title> <simpara> - PHP 3.0.13 a vy¹¹ie, <filename>php://output</filename> - a <filename>php://input</filename> poèínajúc PHP 4.3 + PHP 3.0.13 and up, <filename>php://output</filename> + and <filename>php://input</filename> since PHP 4.3 </simpara> <itemizedlist> @@ -106,33 +107,33 @@ <simpara> <filename>php://stdin</filename>, <filename>php://stdout</filename> - a <filename>php://stderr</filename> umo¾òujú prístup ku - kore¹pondujúcemu vstupnému alebo výstupnému prúdu PHP procesu. + and <filename>php://stderr</filename> allow access to + the corresponding input or output stream of the PHP process. </simpara> <simpara> - <filename>php://output</filename> umo¾òuje zápis do výstupného - mechanizmu zásobníka rovnakým spôsobom ako - <function>print</function> a <function>echo</function>. + <filename>php://output</filename> allows you to write to the + output buffer mechanism in the same way as + <function>print</function> and <function>echo</function>. </simpara> <simpara> - <filename>php://input</filename> umo¾òuje èítanie prvotné POST dáta. - Je to menej pamä» za»a¾ujúca alternatíva k - <varname>$HTTP_RAW_POST_DATA</varname> a nepotrebuje ¾iadne - ¹peciálne &php.ini; direktívy. + <filename>php://input</filename> allows you to read raw POST data. + It is a less memory intensive alternative to + <varname>$HTTP_RAW_POST_DATA</varname> and does not need any + special &php.ini; directives. </simpara> <simpara> - <filename>php://stdin</filename> a - <filename>php://input</filename> sú iba na èítanie, zatiaµèo + <filename>php://stdin</filename> and + <filename>php://input</filename> are read-only, whereas <filename>php://stdout</filename>, - <filename>php://stderr</filename> a - <filename>php://output</filename> sú iba na zápis. + <filename>php://stderr</filename> and + <filename>php://output</filename> are write-only. </simpara> </section> <section id="wrappers.compression"> - <title>Prúdy Kompresie</title> - <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (iba systémy s fopencookie)</simpara> - <simpara><filename>compress.zlib://</filename> a <filename>compress.bzip2://</filename> PHP 4.3 a vy¹¹ie</simpara> + <title>Compression Streams</title> + <simpara><filename>zlib:</filename> PHP 4.0.4 - PHP 4.2.3 (systems with fopencookie only)</simpara> + <simpara><filename>compress.zlib://</filename> and <filename>compress.bzip2://</filename> PHP 4.3 and up</simpara> <itemizedlist> <listitem><simpara><filename>zlib:</filename></simpara></listitem> @@ -141,18 +142,18 @@ </itemizedlist> <simpara> - <filename>zlib:</filename> pracuje ako <function>gzopen</function>, a¾ na to, ¾e - prúd sa dá pou¾i» s <function>fread</function> a inými - filesystem funkciami. Nie je to schvaµované ako to nie je aj v PHP 4.3 - kvôli nejednoznaènosti s názvami súborov obsahujúcich znaky ':'; rad¹ej - pou¾ívajte <filename>compress.zlib://</filename>. + <filename>zlib:</filename> works like <function>gzopen</function>, except that the + stream can be used with <function>fread</function> and the other + filesystem functions. This is deprecated as of PHP 4.3 due + to ambiguities with filenames containing ':' characters; use + <filename>compress.zlib://</filename> instead. </simpara> <simpara> - <filename>compress.zlib://</filename> a - <filename>compress.bzip2://</filename> sú ekvivalentné k - <function>gzopen</function> a <function>bzopen</function> - jednotlivo a fungujú dokonca aj na systémoch, ktoré nepodporujú + <filename>compress.zlib://</filename> and + <filename>compress.bzip2://</filename> are equivalent to + <function>gzopen</function> and <function>bzopen</function> + respectively, and operate even on systems that do not support fopencookie. </simpara> </section>