cvs: phpdoc-sk /appendices about.xml migration4.xml resources.xml wrappers.xml
[email protected] ("Joseph Drake")
| Newsgroups | php.doc.sk |
|---|---|
| Message-ID | <cvsjoseph1053551754@cvsserver> |
joseph Wed May 21 17:15:54 2003 EDT
Modified files:
/phpdoc-sk/appendices about.xml migration4.xml resources.xml
wrappers.xml
Log:
updated
joseph-20030521171554.txt
(text/plain, 15.5 KB)
Index: phpdoc-sk/appendices/about.xml
diff -u phpdoc-sk/appendices/about.xml:1.12 phpdoc-sk/appendices/about.xml:1.13
--- phpdoc-sk/appendices/about.xml:1.12 Fri Feb 21 19:18:38 2003
+++ phpdoc-sk/appendices/about.xml Wed May 21 17:15:53 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!--EN-Revision: 1.22 Maintainer: joseph Status: ready -->
+<!--EN-Revision: 1.24 Maintainer: joseph Status: ready -->
<!--
TODO: add manual conventions section (eg. how to read
@@ -262,7 +262,7 @@
si chceli stiahnu» CVS verziu, pozri <ulink url="&url.php.anoncvs;">anonymná prístupná CVS stránka</ulink>.
</para>
<para>
- Taktie¾ mô¾te narazi» na dokumentáciu pre PHP verziu, ktorá e¹te
+ Taktie¾ mô¾ete narazi» na dokumentáciu pre PHP verziu, ktorá e¹te
nie je uvoµnená (nieèo ako PHP 5.0.0, preto¾e najnov¹ia samostatná
verzia je 4.3.0). Väè¹inou toto nepredstavuje chybu v dokumetácii.
Vysvetlenie sa èasto pridáva k rubrikám, ktoré nie sú dostupné v
@@ -331,8 +331,8 @@
<ulink url="&url.docbook.xml;">DocBook XML DTD</ulink>, vyu¾ívajúci
<ulink url="&url.dsssl;"><acronym>DSSSL</acronym></ulink> (Document
Style and Semantics Specification Language) pre formátovanie a
- experimentrálne <ulink url="&url.xslt;"><acronym>XSLT</acronym>
- </ulink> (Extensible Stylesheet Language Transformations)
+ experimentrálne <ulink url="&url.xslt;"><acronym>XSLT</acronym> </ulink>
+ (Extensible Stylesheet Language Transformations)
pre úpravu a formátovanie.
</para>
<para>
@@ -398,8 +398,10 @@
</note>
<para>
Momentálne je manuál èiastoène dostupný v následujúcich jazykoch:
- v brazílskej portugal¹tine, èín¹tine, èe¹tine, holand¹tine, francúz¹tine,
- nemèine, maïarèine, talianèine, japonèine, kórejèine, pol¹tine a ¹panielèine.
+ v brazílskej portugalèine, èín¹tine (zjednodu¹enej), èín¹tine (tradiènej),
+ èe¹tine, holand¹tine, fín¹tine, francúz¹tine, nemèine, hebrejèine,
+ maïarèine, talianèine, japonèine, kórejèine, pol¹tine, rumunèine, ru¹tine,
+ slovenèine, slovinèine, ¹panielèine, ¹védèine a tureètine.
</para>
<para>
V¹etky sa dajú stiahnú» tu: <ulink url="&url.php.docs;">&url.php.docs;</ulink>.
Index: phpdoc-sk/appendices/migration4.xml
diff -u phpdoc-sk/appendices/migration4.xml:1.6 phpdoc-sk/appendices/migration4.xml:1.7
--- phpdoc-sk/appendices/migration4.xml:1.6 Fri Feb 21 19:18:38 2003
+++ phpdoc-sk/appendices/migration4.xml Wed May 21 17:15:53 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.28 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.33 Maintainer: joseph Status: ready -->
<appendix id="migration4">
<title>Migrácia z PHP 3 do PHP 4</title>
@@ -106,21 +106,37 @@
Sú dva rozdiely medzi hodnotami Adminovskými a ne-adminovskými:
</simpara>
<itemizedlist>
- <listitem><simpara>Admin hodnoty (alebo flagy) sa objavujú len na konfiguraèných súboroch Apache roz¹írených po serveri (t.j. httpd.conf).</simpara></listitem>
- <listitem><simpara>©tandardné hodnoty (alebo flagy) nedoká¾u spoµahlivo kontrolova» PHP direktívy, napr. - núdzový re¾im (ak by ste dokázali prejs» cez nastavenia núdzového re¾imu v súboroch .htaccess, zamietlo by to známer núdzového re¾imu). Naopak, Admin hodnoty mô¾u pozmeni» hodnoty akejkoµvek PHP direktívy.</simpara></listitem>
+ <listitem>
+ <simpara>Admin hodnoty (alebo flagy) sa objavujú len v konfiguraèných
+ súboroch Apache roz¹írených po serveri (t.j. httpd.conf).
+ </simpara>
+ </listitem>
+ <listitem>
+ <simpara>
+ ©tandardné hodnoty (alebo flagy) nedoká¾u spoµahlivo kontrolova»
+ PHP direktívy, napr. - &safemode; (ak by ste dokázali prejs» cez
+ nastavenia núdzového re¾imu v súboroch .htaccess, anulovalo by to zámer
+ núdzového re¾imu). Naopak, Admin hodnoty mô¾u pozmeni» hodnoty akejkoµvek
+ PHP direktívy.
+ </simpara>
+ </listitem>
</itemizedlist>
<simpara>
- Aby sa proces prekladania uµahèil, PHP 4 je vybavené skriptami, ktoré automaticky konvertujú va¹u Apache kofiguráciu a súbory .htaccess, aby pracovali s PHP 3 aj s PHP 4. Tieto skripty NEKONVERTUJÚ napodobnené typové riadky! Tieto musíte prekonvertova» sami.
+ Aby sa proces prekladania uµahèil, PHP 4 je vybavené skriptami, ktoré
+ automaticky konvertujú va¹u Apache kofiguráciu a súbory .htaccess, aby
+ pracovali s PHP 3 aj s PHP 4. Tieto skripty NEKONVERTUJÚ napodobnené
+ typové riadky! Tieto musíte prekonvertova» sami.
</simpara>
<para>
- Aby ste prekonvertovali svoje konfiguraèné súbory Apache, spustite skript apconf-conv.sh (dostupný v adresári /scripts/apache/). Na príklad:
+ Aby ste prekonvertovali svoje konfiguraèné súbory Apache, spustite skript
+ apconf-conv.sh (dostupný v adresári /scripts/apache/). Na príklad:
<informalexample>
- <programlisting role="shell">
+ <programlisting role="shell">
<![CDATA[
~/php4/scripts/apache:# ./apconf-conv.sh /usr/local/apache/conf/httpd.conf
]]>
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
</para>
<simpara>
Pôvodný konfiguraèný súbor bude ulo¾ený do httpd.conf.orig.
@@ -128,15 +144,15 @@
<para>
Aby ste prekonvertovali svoje .htaccess súbory, spustite skript aphtaccess-conv.sh (tie¾ dostupný v adresári scripts/apache/):
<informalexample>
- <programlisting role="shell">
+ <programlisting role="shell">
<![CDATA[
~/php4/scripts/apache:# find / -name .htaccess -exec ./aphtaccess-conv.sh {} \;
]]>
- </programlisting>
- </informalexample>
+ </programlisting>
+ </informalexample>
</para>
<simpara>
- Rovnako sa aj va¹e staré .htaccess súbory ulo¾ia s prefixom .orig.
+ Rovnako sa aj va¹e staré &htaccess; súbory ulo¾ia s prefixom .orig.
</simpara>
<simpara>
K in¹talácii konverzných skriptov sa vy¾aduje trocha zruènosti.
Index: phpdoc-sk/appendices/resources.xml
diff -u phpdoc-sk/appendices/resources.xml:1.6 phpdoc-sk/appendices/resources.xml:1.7
--- phpdoc-sk/appendices/resources.xml:1.6 Mon Dec 23 19:28:10 2002
+++ phpdoc-sk/appendices/resources.xml Wed May 21 17:15:53 2003
@@ -10,6 +10,11 @@
<table>
<title>Typy zdrojov</title>
<tgroup cols="5">
+ <colspec colwidth='1*'/>
+ <colspec colwidth='1*'/>
+ <colspec colwidth='1.4*'/>
+ <colspec colwidth='1*'/>
+ <colspec colwidth='1*'/>
<thead>
<row>
<entry>Názov typu zdroja</entry>
Index: phpdoc-sk/appendices/wrappers.xml
diff -u phpdoc-sk/appendices/wrappers.xml:1.3 phpdoc-sk/appendices/wrappers.xml:1.4
--- phpdoc-sk/appendices/wrappers.xml:1.3 Thu Jan 23 21:09:07 2003
+++ phpdoc-sk/appendices/wrappers.xml Wed May 21 17:15:53 2003
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="iso-8859-2"?>
-<!-- EN-Revision: 1.10 Maintainer: joseph Status: ready -->
+<!-- EN-Revision: 1.16 Maintainer: joseph Status: ready -->
<appendix id="wrappers">
<title>Zoznam Podporovaných Protokolov/Balíèkov</title>
<para>
@@ -49,6 +49,67 @@
kompilovali s podporou pre OpenSSL.
</simpara>
</note>
+ <para>
+ <table>
+ <title>Voµby kontextu (od <literal>PHP 5.0</literal>)</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Názov</entry>
+ <entry>Pou¾itie</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>method</literal></entry>
+ <entry><constant>GET</constant> alebo <constant>POST</constant>
+ </entry>
+ <entry><constant>GET</constant></entry>
+ </row>
+ <row>
+ <entry><literal>header</literal></entry>
+ <entry>Ïal¹ie hlavièky na odoslanie poèas po¾iadavky. Hodnoty
+ v tejto voµbe anulujú ostatné hodnoty (ako
+ <literal>User-agent:</literal>, <literal>Host:</literal>
+ a <literal>Authentication:</literal>.
+ </entry>
+ <entry></entry>
+ </row>
+ <row>
+ <entry><literal>user_agent</literal></entry>
+ <entry>Hodnoty na odoslanie s hlavièkou User-Agent:. Táto hodnota sa
+ pou¾ije iba ak user_agent <emphasis>nie</emphasis> je urèený
+ v kontextovej voµbe <literal>header</literal> uvedenej hore.
+ </entry>
+ <entry>
+ <literal>php.ini</literal> nastavenie: <literal>user_agent</literal>
+ </entry>
+ </row>
+ <row>
+ <entry><literal>obsah</literal></entry>
+ <entry>
+ Ïal¹ie dáta na odoslanie po hlavièkách. Sú typicky pou¾ívané
+ s po¾iadavkami POST.
+ </entry>
+ <entry></entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+
+ <note>
+ <title>Podèiarkovanie soketového prúdu kontextových volieb</title>
+ <simpara>
+ Ïal¹ie kontextové voµby mo¾u by» podporované
+ <link linkend="transports.inet">podèiarkujúcim prenosom</link>
+ Pre <literal>http://</literal> prúdy si pozrite kontextové
+ voµby pre <literal>tcp://</literal> prenos. Pre
+ <literal>https://</literal> prúdy si pozrite kontextové voµby
+ pre <literal>ssl://</literal> prenos.
+ </simpara>
+ </note>
</section>
<section id="wrappers.ftp">
@@ -70,10 +131,21 @@
<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>.
+ a pokú¹ate sa ho otvori» na zapisovanie, ale neurèili ste
+ kontextovú voµbu <literal>overwrite</literal>, spojenie zlyhá.
+ Ak potrebujete prepísa» existujúce súbory cez ftp, urète
+ voµbu <literal>overwrite</literal> v kontexte a otvorte súbor
+ na zapisovanie. Prípadne mo¾ete pou¾i»
+ <link linkend="ref.ftp">FTP roz¹írenie</link>.
</simpara>
+ <note>
+ <title>Dodatok</title>
+ <simpara>
+ Od <literal>PHP 5.0</literal> sa súbory mo¾u pridáva» cez
+ <literal>ftp://</literal> url wrapper. V predo¹lých verziách bude
+ pokus o pridanie súboru cez <literal>ftp://</literal> hlási» chybu.
+ </simpara>
+ </note>
<simpara>
<filename>ftps://</filename> bol predstavený v PHP 4.3.
Je to rovnaké ako s <filename>ftp://</filename>,
@@ -86,14 +158,48 @@
kompilovali s podporou pre OpenSSL.
</simpara>
</note>
-
+ <para>
+ <table>
+ <title>Kontextové voµby (od <literal>PHP 5.0</literal>)</title>
+ <tgroup cols="3">
+ <thead>
+ <row>
+ <entry>Názov</entry>
+ <entry>Pou¾itie</entry>
+ <entry>Default</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry><literal>overwrite</literal></entry>
+ <entry>
+ Povolí prepisovanie u¾ existujúcich súborov na vzdialenom severi.
+ </entry>
+ <entry>&false; (Vypnutý)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </table>
+ </para>
+ <note>
+ <title>Podèiarkovanie soketového prúdu kontextových volieb</title>
+ <simpara>
+ Ïal¹ie kontextové voµby mo¾u by» podporované
+ <link linkend="transports.inet">podèiarkujúcim prenosom</link>
+ Pre <literal>ftp://</literal> prúdy si pozrite kontextové
+ voµby pre <literal>tcp://</literal> prenos. Pre
+ <literal>ftps://</literal> prúdy si pozrite kontextové voµby
+ pre <literal>ssl://</literal> prenos.
+ </simpara>
+ </note>
</section>
-
+
<section id="wrappers.php">
<title>Vstupné/Výstupné prúdy PHP</title>
<simpara>
- PHP 3.0.13 a vy¹¹ie, <filename>php://output</filename>
- a <filename>php://input</filename> poèínajúc PHP 4.3
+ <literal>PHP 3.0.13</literal> a vy¹¹ie, <filename>php://output</filename>
+ a <filename>php://input</filename> poèínajúc <literal>PHP 4.3</literal>,
+ <filename>php://filter</filename> poèínajúc <literal>PHP 5.0</literal>
</simpara>
<itemizedlist>
@@ -102,6 +208,7 @@
<listitem><simpara><filename>php://stderr</filename></simpara></listitem>
<listitem><simpara><filename>php://output</filename></simpara></listitem>
<listitem><simpara><filename>php://input</filename></simpara></listitem>
+ <listitem><simpara><filename>php://filter</filename></simpara></listitem>
</itemizedlist>
<simpara>
@@ -127,6 +234,92 @@
<filename>php://stderr</filename> a
<filename>php://output</filename> sú iba na zápis.
</simpara>
+
+ <simpara>
+ <filename>php://filter</filename> je druh meta-wrappera dizajnovaný
+ na pripustenie aplikácii filtrov do prúdu v èase otvárania.
+ Je to u¾itoèné u v¹etkých súborových funkcií
+ <function>readfile</function>, <function>file</function> a
+ <function>file_get_contents</function>, kde inak nie je ¾iadna
+ mo¾nos» aplikova» filter do prúdu pred preèítaním obsahu.
+ </simpara>
+ <simpara>
+ Cieµ <filename>php://filter</filename> má následuúce
+ 'parametre' ako èasti svojej 'cesty'.
+ </simpara>
+ <itemizedlist>
+ <listitem>
+ <para>
+ <literal>/resource=<prúd na filtrovanie></literal>
+ (<emphasis>po¾adovaný</emphasis>) Tento paramter musí by» umiestnený
+ na konci vá¹ej <filename>php://filter</filename> ¹pecifikácie a
+ mal by ukazova» na prúd, ktorý chcete filtrova».
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Toto je ekvivalentné jednoduchému:
+ readfile("http://www.example.com");
+ preto¾e filtre nie sú urèené */
+
+readfile("php://filter/resource=http://www.example.com");
+?>
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>/read=<zoznam filtra na umo¾nenie èítania re»aze></literal>
+ (<emphasis>voliteµný</emphasis>) Tento parameter má jeden alebo
+ viac názvov oddelené znakom potrubia <literal>|</literal>.
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Vystupom tohto bude obsah
+ www.example.com celý v uppercase */
+readfile("php://filter/read=string.toupper/resource=http://www.example.com");
+
+/* Toto urobi to iste ako hore,
+ ale tiez ho ROT13 zakoduje */
+readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com");
+?>
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ <listitem>
+ <para>
+ <literal>/write=<zoznam filtra na umo¾nenie zápisu re»aze></literal>
+ (<emphasis>voliteµný</emphasis>) Tento parameter má jeden alebo viac
+ názvov oddelené znakom potrubia <literal>|</literal>.
+ <informalexample>
+ <programlisting role="php">
+<![CDATA[
+<?php
+/* Toto vyfiltruje retazec "Hello World"
+ cez rot13 filter, potom zapise do
+ example.txt v aktualnom adresari */
+file_set_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");
+?>
+]]>
+ </programlisting>
+ </informalexample>
+ </para>
+ </listitem>
+ <listitem>
+ <simpara>
+ <literal>/<zoznam filtra na umo¾nenie oboch re»azí></literal>
+ (<emphasis>voliteµný</emphasis>) V¹etky zoznamy filtra, ktoré nie
+ sú urèené cez <literal>read=</literal> alebo
+ <literal>write=</literal> budú aplikované do oboch re»azí èítania
+ a zápisu (ako pridelené).
+ </simpara>
+ </listitem>
+ </itemizedlist>
</section>
<section id="wrappers.compression">