cvs: phpdoc-cs /reference/outcontrol ini.xml reference.xml /reference/pdf configure.xml reference.xml /reference/pfpro configure.xml ini.xml
reference.xml /reference/readline configure.xml reference.xml /reference/recode configure.xml reference.xml /reference/sem configure.xml ini.xml
reference.xml /reference/shmop configure.xml reference.xml /reference/wddx configure.xml reference.xml /reference/xslt configure.xml constants.xml
reference.xml

From:	Jakub Vrana	Date:	Wed, 31 Dec 2003 16:56:09 +0000
Subject:	cvs: phpdoc-cs /reference/outcontrol ini.xml reference.xml /reference/pdf configure.xml reference.xml /reference/pfpro configure.xml ini.xml reference.xml /reference/readline configure.xml reference.xml /reference/recode configure.xml reference.xml /reference/sem configure.xml ini.xml reference.xml /reference/shmop configure.xml reference.xml /reference/wddx configure.xml reference.xml /reference/xslt configure.xml constants.xml reference.xml
Groups:	php.doc.cs
Request:	Send a blank email to doc-cs+get-98@lists.php.net to get a copy of this message

vrana Wed Dec 31 11:56:09 2003 EDT Added files: /phpdoc-cs/reference/outcontrol ini.xml /phpdoc-cs/reference/pdf configure.xml /phpdoc-cs/reference/pfpro configure.xml ini.xml /phpdoc-cs/reference/readline configure.xml /phpdoc-cs/reference/recode configure.xml /phpdoc-cs/reference/sem configure.xml ini.xml /phpdoc-cs/reference/shmop configure.xml /phpdoc-cs/reference/wddx configure.xml /phpdoc-cs/reference/xslt configure.xml constants.xml Modified files: /phpdoc-cs/reference/outcontrol reference.xml /phpdoc-cs/reference/pdf reference.xml /phpdoc-cs/reference/pfpro reference.xml /phpdoc-cs/reference/readline reference.xml /phpdoc-cs/reference/recode reference.xml /phpdoc-cs/reference/sem reference.xml /phpdoc-cs/reference/shmop reference.xml /phpdoc-cs/reference/wddx reference.xml /phpdoc-cs/reference/xslt reference.xml Log: Up to dated

Index: phpdoc-cs/reference/outcontrol/reference.xml diff -u phpdoc-cs/reference/outcontrol/reference.xml:1.2 phpdoc-cs/reference/outcontrol/reference.xml:1.3 --- phpdoc-cs/reference/outcontrol/reference.xml:1.2 Mon Apr 15 18:06:08 2002 +++ phpdoc-cs/reference/outcontrol/reference.xml Wed Dec 31 11:56:02 2003 @@ -1,50 +1,94 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.outcontrol"> - <title>Output Control funkce</title> - <titleabbrev>Output Control</titleabbrev> + <title>Funkce pro øízení výstupu</title> + <titleabbrev>Øízení výstupu</titleabbrev> <partintro> - <para> - Output Control funkce (funkce pro øízení výstupu) vám umo¾òujíc ovládat, kdy - se ode¹le výstup skriptu. To mù¾e být u¾iteèné v nìkolika rùzných situacích, - zvlá¹tì pokud potøebujete poslat browseru hlavièky poté, co vá¹ skript - zaèal odesílat data. Output Control funkce neovlivòují hlavièky odeslané - pomocí <function>header</function> nebo <function>setcookie</function>, - pouze funkce jako <function>echo</function> a data mezi bloky PHP kódu. - </para> - <para> - <example> - <title>Ukázka øízení výstupu</title> - <programlisting role="php"> -<?php + <section id="outcontrol.intro"> + &reftitle.intro; + <para> + Funkce pro øízení výstupu vám umo¾òují ovládat, kdy + se ode¹le výstup skriptu. To mù¾e být u¾iteèné v nìkolika rùzných situacích, + zvlá¹tì pokud potøebujete poslat browseru hlavièky poté, co vá¹ skript + zaèal odesílat data. Output Control funkce neovlivòují hlavièky odeslané + pomocí funkcí <function>header</function> nebo <function>setcookie</function>, + pouze funkce jako <function>echo</function> a data mezi bloky PHP kódu. + </para> + </section> + + <section id="outcontrol.requirements"> + &reftitle.required; + &no.requirement; + </section> + + <section id="outcontrol.installation"> + &reftitle.install; + &no.install; + </section> + + &reference.outcontrol.ini; + + <section id="outcontrol.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="outcontrol.constants"> + &reftitle.constants; + &no.constants; + </section> + + <section id="outcontrol.examples"> + &reftitle.examples; + <para> + <example> + <title>Ukázka øízení výstupu</title> + <programlisting role="php"> +<![CDATA[ +<?php ob_start(); -echo "Hello\n"; +echo "Ahoj\n"; setcookie ("cookiename", "cookiedata"); ob_end_flush(); -?> - </programlisting> - </example> - </para> - <para> - Ve vý¹e uvedené ukázce se výstup z <function>echo</function> ulo¾í ve - výstupním bufferu a¾ do volání <function>ob_end_flush</function>. Mezitím - volání <function>setcookie</function> úspì¹nì ulo¾ilo cookie bez vyvolání - chyby. (Normálnì nemù¾ete odeslat do browseru hlavièky poté, co u¾ byla - odeslána data.) - </para> - <para> - Viz také <function>header</function> a <function>setcookie</function>. - </para> +?> +]]> + </programlisting> + </example> + </para> + <para> + Ve vý¹e uvedené ukázce se výstup z <function>echo</function> ulo¾í ve + výstupním bufferu a¾ do volání <function>ob_end_flush</function>. Mezitím + volání <function>setcookie</function> úspì¹nì ulo¾ilo cookie bez vyvolání + chyby. (Normálnì nemù¾ete odeslat do browseru hlavièky poté, co u¾ byla + odeslána data.) + </para> + <note> + <para> + Pøi pøechodu z PHP 4.1 (a 4.2) na 4.3 musíte kvùli chybì ve + star¹ích verzích zaruèit, aby v &php.ini; byla direktiva + <literal>implict_flush</literal> nastavena na <literal>OFF</literal>, + jinak výstup po zavolání funkce + <function>ob_start</function> nebude skryt z výstupu. + </para> + </note> + </section> + + <section id="outcontrol.seealso"> + &reftitle.seealso; + <para> + Viz také <function>header</function> a <function>setcookie</function>. + </para> + </section> </partintro> &reference.outcontrol.functions; </reference> -  Index: phpdoc-cs/reference/pdf/reference.xml diff -u phpdoc-cs/reference/pdf/reference.xml:1.2 phpdoc-cs/reference/pdf/reference.xml:1.3 --- phpdoc-cs/reference/pdf/reference.xml:1.2 Mon Apr 15 18:06:10 2002 +++ phpdoc-cs/reference/pdf/reference.xml Wed Dec 31 11:56:04 2003 @@ -1,53 +1,98 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.pdf"> <title>PDF funkce</title> <titleabbrev>PDF</titleabbrev> <partintro> <section id="pdf.intro"> - <title>Introduction</title> + &reftitle.intro; <simpara> - Pokud máte PDF knihovnu od Thomase Merze (dostupná z - <ulink url="&url.pdf;">&url.pdf;</ulink>), mù¾ete pou¾ívat PDF funkce na - tvorbu PDF souborù; ke kompilaci budete potøebovat také - <ulink url="&url.jpeg;">JPEG knihovnu</ulink> a - <ulink url="&url.tiff;">TIFF knihovnu</ulink>. Tyto dvì knihovny pomìrnì - èasto dìlají potí¾e pøi konfiguraci PHP. Pøi øe¹ení pøípadných problémù - se øiïte chybovými zprávami configure skriptu. + PDF funkce v PHP mohou vytvoøit PDF soubory s vyu¾itím knihovny + PDFlib vytvoøené <ulink url="&url.pdflib.merz;">Thomasem + Merzem</ulink>. + </simpara> + <simpara> + Dokumentace této sekce je my¹lena pouze jako pøehled + dostupných funkcí v knihovnì PDFlib a nemìla by být + pova¾ována za vyèerpávající pøehled. Prosím konzultujte + dokumentaci obsa¾enou v distribuci PDFlib pro + úplné a detailní vysvìtlené ka¾dé zde uvedené funkce. + Poskytuje velmi dobrý pøehled toho, co PDFlib doká¾e + a obsahuje nejèerstvìj¹í dokumentaci ke v¹em funkcím. </simpara> <simpara> - Vìnujte prosím pozornost výborné dokumentaci pdflib, která je souèástí - distribuce zdrojového kódu. Poskytuje velmi dobrý pøehled schopností pdflib. Vìt¹ina funkcí pdflib a pøíslu¹ného PHP modulu má stejné jméno. Argumenty jsou také identické. Pokud chcete tento modul vyu¾ívat opravdu efektivnì, mìli byste chápat také nìkteré z konceptù PDF nebo Postscriptu. V¹echny rozmìry a koordináty se udávají v Postscriptových bodech. Obecnì je 72 PostScriptových bodù na palec, ale závisí to na výstupním rozli¹ení. + Vìnujte prosím pozornost dokumentaci pdflib, která je souèástí + distribuce zdrojového kódu, pro bli¾¹í vysvìtlení pou¾itého souøadnicového + systému. </simpara> - <simpara> - Existuje dal¹í PHP modul na tvorbu PDF dokumentù, zalo¾ený na ClibPDF od - firmy <ulink url="&url.cpdf;">FastIO</ulink>. Má mírnì jinou API. Detaily - viz <link linkend="ref.cpdf">ClibPDF funkce</link>. + <simpara> + Vemte prosím na vìdomí, ¾e vìt¹ina PDF funkcí vy¾aduje + <parameter>pdfdoc</parameter> jako první parametr. Viz + <link linkend="pdf.examples">pøíklady</link> ní¾e pro bli¾¹í + vysvìtlení. </simpara> - <simpara> - Tento PDF modul zavádí nový typ promìnné. Nazývá se <parameter>pdfdoc</parameter>. - <parameter>pdfdoc</parameter> je pointer na PDF dokument a témìø v¹echny - funkce ho vy¾adují jako svùj první argument. + <note> + <simpara> + Pokud se zajímáté o alternativní volnì dostupné PDF generátory, které + nepotøebují externí PDF knihovny, podívejte se na <link linkend="faq.using.freepdf"> + tuto související FAQ</link>. </simpara> + </note> </section> - <section id="pdf.oldlibs.confusion"> - <title>Zmatek se starými verzemi pdflib</title> + + <section id="pdf.requirements"> + &reftitle.required; + <para> + PDFlib lze stáhnout na <ulink + url="&url.pdf;">&url.pdf;</ulink>, ale vy¾aduje, abyste zakoupili + licenci pro komerèní pou¾ití. Pro zkompilování + tohoto roz¹íøení jsou potøeba knihovny <ulink + url="&url.jpeg;">JPEG</ulink> a <ulink + url="&url.tiff;">TIFF</ulink>. + </para> + + <section id="pdf.oldlibs.hints"> + <title>Problémy se starými verzemi PDFlib</title> + <simpara> + ®ádná verze PHP 4 od data 9. bøezna 2000 nepodporuje podflib star¹í ne¾ + 3.0. + </simpara> <simpara> - Od úplného zaèátky podpory PDF v PHP — od pdflib 0.6 — do¹lo - k mnoha zmìnám zvlá¹tì v API pdflib. Vìt¹inu tìchto zmìn PHP nìjak zakrylo, - nìkteré vy¾adovaly zmìnu PHP API. Od pdflib 3.x se API snad stabilizovala, - a PHP 4 pøijala tuto verzi jako mimimální pro podporu PDF. Následkem toho - mnoho funkcí døíve èi pozdìji zmizí nebo bude nahra¾eno alternativami. - Podpora pdflib 0.6 u¾ byla naprosto ukonèena. Následující tabulka - vyjmenovává v¹echny funkce, které jsou od PHP 4.0.2 zastaralé a mìly by být - nahra¾eny jejich novìj¹ími verzemi. + PDFlib 3.0 a vy¹¹í je podporováno PHP 3.0.19 a vy¹¹í. </simpara> + </section> + </section> + + &reference.pdf.configure; + + <section id="pdf.configuration"> + &reftitle.runtime; + &no.config; + </section> + + + <section id="pdf.oldlibs.confusion"> + <title>Zmatek se starými verzemi PDFlib</title> + <simpara> + Od PHP 4.0.5 je PHP roz¹íøení + oficiálnì podporováno spoleèností PDFlib GmbH. To znamená, ¾e v¹echny + funkce popsané v PDFlib manuálu (V3.00 nebo vy¹¹í) jsou + podporovány v PHP 4 s pøesnì stejným významem a stejnými + parametry. Oproti manuálu PDFlib se mohou li¹it pouze návratové + hodnoty, proto¾e byla pøevzata konvence PHP + pro vracení &false; was adopted. Z dùvodu kompatibility + toto roz¹íøení PDFlib stále podporuje staré funkce, ale tyto + by mìly být nahrazeny jejich novìj¹ími verzemi. PDFlib GmbH nepomáhá + s øe¹ením ¾ádných problémù plynoucích z pou¾ívání tìchto zastaralých + funkcí. + </simpara> <para> <table> <title>Zastaralé funkce a jejich náhrady</title> @@ -62,6 +107,15 @@ <row> <entry><function>pdf_put_image</function></entry> <entry>Není potøeba.</entry> + </row> + <row> + <entry><function>pdf_execute_image</function></entry> + <entry>Není potøeba.</entry> + </row> + <row> + <entry><function>pdf_get_annotation</function></entry> + <entry><function>pdf_get_bookmark</function> se stejnými + parametry.</entry> </row> <row> <entry><function>pdf_get_font</function></entry> @@ -143,6 +197,16 @@ <literal>"transition"</literal> jako druhý argument.</entry> </row> <row> + <entry><function>pdf_open</function></entry> + <entry><function>pdf_new</function> plus následné zavolání + <function>pdf_open_file</function></entry> + </row> + <row> + <entry><function>pdf_set_font</function></entry> + <entry><function>pdf_findfont</function> plus následné zavolání + <function>pdf_setfont</function></entry> + </row> + <row> <entry><function>pdf_set_duration</function></entry> <entry><function>pdf_set_value</function> s <literal>"duration"</literal> jako druhý argument.</entry> @@ -168,62 +232,25 @@ <literal>"png"</literal> jako druhý argument.</entry> </row> <row> - <entry><function>pdf_get_imagewidth</function></entry> + <entry><function>pdf_get_image_width</function></entry> <entry><function>pdf_get_value</function> s <literal>"imagewidth"</literal> jako druhý argument a obrázkem jako tøetí argument.</entry> </row> <row> - <entry><function>pdf_get_imageheight</function></entry> + <entry><function>pdf_get_image_height</function></entry> <entry><function>pdf_get_value</function> s <literal>"imageheight"</literal> jako druhý argument a obrázkem jako tøetí argument.</entry> </row> - <row> - <entry><function></function></entry> - <entry><function></function></entry> - </row> </tbody> </tgroup> </table> </para> </section> - <section id="pdf.install.pdflib"> - <title>Rady pro instalaci pdflib 3.x</title> - <simpara> - Od pdflib 3.0 by se pdflib mìla konfigurovat s volbou - <literal>--enable-shared-pdflib</literal>. - </simpara> - </section> - <section id="pdf.oldlibs.hints"> - <title>Problémy se star¹ími verzemi pdflib</title> - <simpara> - Pokud pou¾íváte pdflib 2.01, zkontrolujte, jak je tato knihovna - nainstalována. Mìli byste mít soubor libpdf.so, nebo link na nìj. Verze - 2.01 vytváøí soubor libpdf2.01.so, který se nedá najít pøi linkování - testovacího souboru v configure. Budete muset vytvoøit symbolický link - z libpdf.so na libpdf2.01.so. - </simpara> - <simpara> - Ve verzi 2.20 pøibyly dal¹í zmìny v API pdflib a podpora èínských a - japonských fontù. Pokud pou¾íváte pdflib 2.20 buïte opatrní pøi generování - PDF dokumentù v pamìti. Do verze pdflib 3.0 by mohlo být nestabilní. - Argument kódování v <function>pdf_set_font</function> se zmìnil na øetìzec. - To znamená, ¾e místo napø. 4 musíte pou¾ít 'winansi'. - </simpara> - <simpara> - Pokud pou¾íváte pdflib 2.30, nemáte k dispozici - <function>pdf_set_text_matrix</function>. Pøestala být podporována. Obecnou - radou je zjistit si pøípadné zmìny v release notes pou¾ívané verze pdflib. - </simpara> - <simpara> - ®ádná verze PHP 4 od data 9. bøezna 2000 nepodporuje podflib star¹í ne¾ - 3.0. Na druhou stranu, PHP 3 by se nemìlo pou¾ívat s novìj¹í verzí pdflib - ne¾ 2.01. - </simpara> - </section> + <section id="pdf.examples"> - <title>Ukázky</title> + &reftitle.examples; <simpara> Vìt¹ina funkcí se pou¾ívá docela snadno. Nejtì¾¹í je zøejmì vùbec nìjaký jednoduchý PDF dokument vùbec vytvoøit. Následující ukázka by mìla pomoci @@ -235,17 +262,19 @@ <para> <example> <title>Tvorba PDF dokumentu s pdflib</title> - <programlisting> -<?php -$fp = fopen("test.pdf", "w"); -$pdf = pdf_open($fp); + <programlisting role="php"> +<![CDATA[ +<?php +$pdf = pdf_new(); +pdf_open_file($pdf, "test.pdf"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); pdf_set_info($pdf, "Title", "Test for PHP wrapper of PDFlib 2.0"); pdf_set_info($pdf, "Creator", "See Author"); pdf_set_info($pdf, "Subject", "Testing"); pdf_begin_page($pdf, 595, 842); pdf_add_outline($pdf, "Page 1"); -pdf_set_font($pdf, "Times-Roman", 30, "host"); +$font = pdf_findfont($pdf, "Times New Roman", "winansi", 1); +pdf_setfont($pdf, $font, 10); pdf_set_value($pdf, "textrendering", 1); pdf_show_xy($pdf, "Times Roman outlined", 50, 750); pdf_moveto($pdf, 50, 740); @@ -253,23 +282,28 @@ pdf_stroke($pdf); pdf_end_page($pdf); pdf_close($pdf); -fclose($fp); -echo "<A HREF=getpdf.php>finished</A>"; +pdf_delete($pdf); +echo "<A HREF=getpdf.php>finished</A>"; ?> +]]> </programlisting> - <simpara> - Skript <filename>getpdf.php</filename> pouze vrátí vytvoøený pdf dokument. - </simpara> - <informalexample> - <programlisting> -<?php -$fp = fopen("test.pdf", "r"); + </example> + + Skript <filename>getpdf.php</filename> pouze vrátí vytvoøený pdf dokument. + + <example> + <title>Vrátit pøipravené PDF</title> + <programlisting role="php"> +<![CDATA[ +<?php +$len = filesize($filename); header("Content-type: application/pdf"); -fpassthru($fp); -fclose($fp); +header("Content-Length: $len"); +header("Content-Disposition: inline; filename=foo.pdf"); +readfile($filename); ?> - </programlisting> - </informalexample> +]]> + </programlisting> </example> </para> <para> @@ -281,16 +315,23 @@ <para> <example> <title>pdfclock ukázka z pdflib distribuce</title> - <programlisting> -<?php -$pdffilename = "clock.pdf"; + <programlisting role="php"> +<![CDATA[ +<?php $radius = 200; $margin = 20; -$pagecount = 40; +$pagecount = 10; -$fp = fopen($pdffilename, "w"); -$pdf = pdf_open($fp); -pdf_set_info($pdf, "Creator", "pdf_clock.php3"); +$pdf = pdf_new(); + +if (!pdf_open_file($pdf, "")) { + print error; + exit; +}; + +pdf_set_parameter($pdf, "warning", "true"); + +pdf_set_info($pdf, "Creator", "pdf_clock.php"); pdf_set_info($pdf, "Author", "Uwe Steinmann"); pdf_set_info($pdf, "Title", "Analog Clock"); @@ -299,14 +340,14 @@ pdf_set_parameter($pdf, "transition", "wipe"); pdf_set_value($pdf, "duration", 0.5); - + pdf_translate($pdf, $radius + $margin, $radius + $margin); pdf_save($pdf); pdf_setrgbcolor($pdf, 0.0, 0.0, 1.0); /* minute strokes */ pdf_setlinewidth($pdf, 2.0); - for ($alpha = 0; $alpha < 360; $alpha += 6) { + for ($alpha = 0; $alpha < 360; $alpha += 6) { pdf_rotate($pdf, 6.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin/3, 0.0); @@ -318,7 +359,7 @@ /* 5 minute strokes */ pdf_setlinewidth($pdf, 3.0); - for ($alpha = 0; $alpha < 360; $alpha += 30) { + for ($alpha = 0; $alpha < 360; $alpha += 30) { pdf_rotate($pdf, 30.0); pdf_moveto($pdf, $radius, 0.0); pdf_lineto($pdf, $radius-$margin, 0.0); @@ -364,27 +405,40 @@ pdf_restore($pdf); pdf_end_page($pdf); + + # to see some difference + sleep(1); } -$pdf = pdf_close($pdf); -fclose($fp); -echo "<A HREF=getpdf.php?filename=".$pdffilename.">finished</A>"; -?> - </programlisting> - <simpara> - PHP skript <filename>getpdf.php</filename> pouze vrátí výtvoøený PDF - dokument. - </simpara> - <programlisting> -<?php -$fp = fopen($filename, "r"); +pdf_close($pdf); + +$buf = pdf_get_buffer($pdf); +$len = strlen($buf); + header("Content-type: application/pdf"); -fpassthru($fp); -fclose($fp); +header("Content-Length: $len"); +header("Content-Disposition: inline; filename=foo.pdf"); +print $buf; + +pdf_delete($pdf); ?> +]]> </programlisting> - </example></para> + </example> + </para> + </section> + + <section id="pdf.seealso"> + &reftitle.seealso; + <note> + <para> + Existuje dal¹í PHP modul na tvorbu PDF dokumentù, zalo¾ený na ClibPDF od + firmy <ulink url="&url.cpdf;">FastIO</ulink>. Detaily + viz <link linkend="ref.cpdf">ClibPDF funkce</link>. Má mírnì jinou API. + </para> + </note> </section> + </partintro> &reference.pdf.functions; @@ -406,5 +460,8 @@ 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 --> Index: phpdoc-cs/reference/pfpro/reference.xml diff -u phpdoc-cs/reference/pfpro/reference.xml:1.2 phpdoc-cs/reference/pfpro/reference.xml:1.3 --- phpdoc-cs/reference/pfpro/reference.xml:1.2 Mon Apr 15 18:06:11 2002 +++ phpdoc-cs/reference/pfpro/reference.xml Wed Dec 31 11:56:04 2003 @@ -1,44 +1,72 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.pfpro"> <title>Funkce pro práci s Verisign Payflow Pro</title> <titleabbrev>Verisign Payflow Pro</titleabbrev> + <partintro> - <simpara> - Tato extenze umo¾òuje zpracovávat kreditní karty a provádìt jiné finanèní - transakce pomocí Verisign Payment Services (døíve Signio, <ulink - url="&url.pfpro;">&url.pfpro;</ulink>). - </simpara> - <simpara> - Tyto funkce jsou dostupné pouze pokud bylo PHP zkompilováno s <option - role="configure">--with-pfpro[=DIR]</option>. Budete potøebovat SDK pro - va¹i platformu, který se dá po registraci stáhnout z <ulink - url="&url.pfpro.download;">mana¾erského rozhraní</ulink>. - </simpara> - <simpara> - Pokud jste si stáhli správný SDK, zkopírujte následující soubory z <filename - class="directory">lib</filename> adresáøe této distribuce: - <filename>pfpro.h</filename> do <filename - class="directory">/usr/local/include</filename> a - <filename>libpfpro.so</filename> do <filename - class="directory">/usr/local/lib</filename>. - </simpara> - <simpara> - Pøi vyu¾ívání tìchto funkcí mù¾ete vynechat volání - <function>pfpro_init</function> a <function>pfpro_cleanup</function>, tato - extenze to udìlá podle potøeby automaticky. Tyto funkce jsou ale pøesto - dostupné pro pøípad, ¾e byste potøebovali zpracovávat velké mno¾ství - transakcí a vy¾adovali naprostou kontrolu nad touto knihovnou. - Mezi <function>pfpro_init</function> a <function>pfpro_cleanup</function> - mù¾ete provést libovolné mno¾ství transakcí. - </simpara> - <simpara> - Tyto funkce byly pøidány v PHP 4.0.2. - </simpara> - - <note><para> - Tyto funkce poskytují pouze spojení s Verisign Payment Services. Kompletní - detaily vy¾adovaných parametrù viz Payflow Pro Developer's Guide. - </para></note> + <section id="pfpro.intro"> + &reftitle.intro; + <para> + Toto roz¹íøení umo¾òuje zpracovávat kreditní karty a provádìt jiné finanèní + transakce pomocí Verisign Payment Services (døíve Signio, <ulink + url="&url.pfpro;">&url.pfpro;</ulink>). + </para> + <para> + Pøi vyu¾ívání tìchto funkcí mù¾ete vynechat volání + <function>pfpro_init</function> a <function>pfpro_cleanup</function>, tato + extenze to udìlá podle potøeby automaticky. Tyto funkce jsou ale pøesto + dostupné pro pøípad, ¾e byste potøebovali zpracovávat velké mno¾ství + transakcí a vy¾adovali naprostou kontrolu nad touto knihovnou. + Mezi <function>pfpro_init</function> a <function>pfpro_cleanup</function> + mù¾ete provést libovolné mno¾ství transakcí. + </para> + <simpara> + Tyto funkce byly pøidány v PHP 4.0.2. + </simpara> + <note> + <para> + Tyto funkce poskytují pouze spojení s Verisign Payment Services. Kompletní + detaily vy¾adovaných parametrù viz Payflow Pro Developer's Guide. + </para> + </note> + &note.no-windows.extension; + </section> + + <section id="pfpro.requirements"> + &reftitle.required; + <para> + Budete potøebovat SDK pro + va¹i platformu, který se dá po registraci stáhnout z <ulink + url="&url.pfpro.download;">mana¾erského rozhraní</ulink>. + Pokud se chystáte pou¾ívat toto + roz¹íøení s webovým serverem s povoleným SSL nebo s jinými SSL komponentami (jako + je roz¹íøení CURL+SSL), musíte stáhnout beta verzi SDK. + </para> + <para> + Pokud jste si stáhli SDK, zkopírujte následující soubory z <filename + class="directory">lib</filename> adresáøe této distribuce: + <filename>pfpro.h</filename> do <filename + class="directory">/usr/local/include</filename> a + <filename>libpfpro.so</filename> do <filename + class="directory">/usr/local/lib</filename>. + </para> + </section> + + &reference.pfpro.configure; + + &reference.pfpro.ini; + + <section id="pfpro.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="pfpro.constants"> + &reftitle.constants; + &no.constants; + </section> + </partintro> &reference.pfpro.functions; @@ -60,5 +88,8 @@ 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 --> Index: phpdoc-cs/reference/readline/reference.xml diff -u phpdoc-cs/reference/readline/reference.xml:1.2 phpdoc-cs/reference/readline/reference.xml:1.3 --- phpdoc-cs/reference/readline/reference.xml:1.2 Mon Apr 15 18:06:11 2002 +++ phpdoc-cs/reference/readline/reference.xml Wed Dec 31 11:56:05 2003 @@ -1,23 +1,56 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.readline"> <title>GNU Readline</title> <titleabbrev>Readline</titleabbrev> <partintro> - <simpara> - <function>readline</function> funkce implementují rozhraní ke GNU - Readline knihovnì. Tyto funkce poskytují editovatelné pøíkazové øádky. - Pøíkladem mù¾e být zpùsob, jakým vám Bash umo¾òuje vkládat znaky nebo - listovat historií pøíkazù pomocí kláves pro pohyb kurzoru. Z interaktivní - povahy této knihovny vyplývá, ¾e není pøíli¹ u¾iteèná pro psaní webových - aplikací, ale mù¾e být u¾iteèná pøi psaní skriptù, které se mají spou¹tìt - z pøíkazové øádky. - </simpara> - <simpara> - Domovskou stránkou GNU Readline projektu je - <ulink url="&url.readline;">&url.readline;</ulink>. Udr¾uje jej Chet Ramey, - který je také autorem Bashe. - </simpara> + <section id="readline.intro"> + &reftitle.intro; + <para> + <function>readline</function> funkce implementují rozhraní ke GNU + Readline knihovnì. Tyto funkce poskytují editovatelné pøíkazové øádky. + Pøíkladem mù¾e být zpùsob, jakým vám Bash umo¾òuje vkládat znaky nebo + listovat historií pøíkazù pomocí kláves pro pohyb kurzoru. Z interaktivní + povahy této knihovny vyplývá, ¾e není pøíli¹ u¾iteèná pro psaní webových + aplikací, ale mù¾e být u¾iteèná pøi psaní skriptù, které se mají spou¹tìt + z <link linkend="features.commandline">pøíkazové øádky</link>. + </para> + &note.no-windows.extension; + </section> + + <section id="readline.requirements"> + &reftitle.required; + <para> + Abyste mohli pou¾ívat readline funkce, musíte nainstalovat libreadline. + Domovskou stránkou GNU Readline projektu je + <ulink url="&url.readline;">&url.readline;</ulink>. Udr¾uje jej Chet Ramey, + který je také autorem Bashe. + </para> + <para> + Tyto funkce mù¾ete pou¾ívat také s knihovnou libedit, ne-GPL + náhradou za knihovnu readline. Knihovna libedit je pod licencí + BSD a stáhnout lze z + <ulink url="&url.readline;">&url.libedit;</ulink>. + </para> + </section> + + &reference.readline.configure; + + <section id="readline.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="readline.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="readline.constants"> + &reftitle.constants; + &no.constants; + </section> </partintro> &reference.readline.functions; @@ -39,5 +72,8 @@ 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 --> Index: phpdoc-cs/reference/recode/reference.xml diff -u phpdoc-cs/reference/recode/reference.xml:1.2 phpdoc-cs/reference/recode/reference.xml:1.3 --- phpdoc-cs/reference/recode/reference.xml:1.2 Mon Apr 15 18:06:11 2002 +++ phpdoc-cs/reference/recode/reference.xml Wed Dec 31 11:56:06 2003 @@ -1,22 +1,47 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.recode"> <title>GNU Recode funkce</title> <titleabbrev>Recode</titleabbrev> <partintro> - <para> - Tento modul obsahuje rozhraní ke GNU Recode knihovnì, - verze 3.5. Pokud cchete pou¾ívat funkce definované v tomto modulu, musíte - zkompilovat vá¹ PHP interpretr s --with-recode. K tomu potøebujete mít na - svém systému nainstalovanou GNU Recode 3.5 nebo vy¹¹í. - </para> - <para> - GNU Recode knihovna konvertuje soubory mezi rùznými znakovými sadami a - kódováními. Kdy¾ nelze dosáhnout pøesné konverze, mù¾e se uchýlit - k approximacím. Tato knihovna rozeznává nebo produkuje témìø 150 rùzných - znakových sad, a je schopná konvertovat soubory mezi témìø libovolným párem. - Podporuje vìt¹inu znakových sad z RFC 1345. - </para> + <section id="recode.intro"> + &reftitle.intro; + <para> + Tento modul obsahuje rozhraní ke GNU Recode knihovnì, verze 3.5. + GNU Recode knihovna konvertuje soubory mezi rùznými znakovými sadami a + kódováními. Kdy¾ nelze dosáhnout pøesné konverze, mù¾e se uchýlit + k aproximacím. Tato knihovna rozeznává nebo produkuje témìø 150 rùzných + znakových sad, a je schopná konvertovat soubory mezi témìø libovolným párem. + Podporuje vìt¹inu znakových sad z <ulink url="&url.rfc;1345">RFC 1345</ulink>. + </para> + &note.no-windows.extension; + </section> + + <section id="recode.requirements"> + &reftitle.required; + <para> + Na svém systému musíte mít nainstalovanou GNU Recode 3.nebo vy¹¹í. + Balíèek lze stáhnout z <ulink url="&url.recode;">&url.recode;</ulink>. + </para> + </section> + + &reference.recode.configure; + + <section id="recode.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="recode.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="recode.constants"> + &reftitle.constants; + &no.constants; + </section> </partintro> &reference.recode.functions; @@ -38,5 +63,8 @@ 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 --> Index: phpdoc-cs/reference/sem/reference.xml diff -u phpdoc-cs/reference/sem/reference.xml:1.2 phpdoc-cs/reference/sem/reference.xml:1.3 --- phpdoc-cs/reference/sem/reference.xml:1.2 Mon Apr 15 18:06:13 2002 +++ phpdoc-cs/reference/sem/reference.xml Wed Dec 31 11:56:06 2003 @@ -1,51 +1,81 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.sem"> - <title>Funkce pro práci se semafory a sdílenou pamìtí</title> + <title>Semaphore, Shared Memory and IPC Functions</title> <titleabbrev>Semaphore</titleabbrev> <partintro> - <para> - Tato extenze poskytuje semaforové funkce vyu¾ívající System V semafory. - Semafory se dají pou¾ívat k poskytování exkluzivního pøístupu k prostøedkùm - na daném systému, nebo k omezení poètu procesù, které mohou souèasnì pou¾ívat - urèitý prostøedek. - </para> - <para> - Tato extenze také poskytuje funkce pro práci se sdílenou pamìtí vyu¾ívající - System V sdílenou pamì». Sdílená pmìt se dá pou¾ívat k poskytování pøístupu - ke globálním promìnným. Rùzní httpd-daemoni a dokonce i jiné programy (napø. - Perl, C, ...) mohou k tìmto datùm pøistupovat, a vytvoøit tak globální výmìnu - dat. Pamatujte, ¾e sdílená pamì» <emphasis>není</emphasis> chránìna proti - simultáním pøístupùm. K synchronizaci pou¾ijte semafory. - <table> - <title>Omezení sdílené pamìti systémem Unix</title> - <tgroup cols="2"> - <tbody> - <row> - <entry>SHMMAX</entry> - <entry>max. velikost sdílené pamìti, normálnì 131072 bytù</entry> - </row> - <row> - <entry>SHMMIN</entry> - <entry>min. velikost sdílené pamìti, normálne 1 byte</entry> - </row> - <row> - <entry>SHMMNI</entry> - <entry>max. poèet segmentù sdílené pamìti, normálnì 100</entry> - </row> - <row> - <entry>SHMSEG</entry> - <entry>max. poèet segmentù sdílené pamìti na proces, normálnì 6</entry> - </row> - </tbody> - </tgroup> - </table> - </para> - <note> - <simpara> - Tyto funkce nefungují na Windows. - </simpara> - </note> + <section id="sem.intro"> + &reftitle.intro; + <para> + Toto roz¹íøení poskytuje rozhraní k rodinì IPC funkcí Systemu V. + To zahrnuje semafory, sdílenou pamì» a meziprocesové zprávy (IPC). + </para> + <para> + Semafory se dají pou¾ívat k poskytování exkluzivního pøístupu k prostøedkùm + na daném systému, nebo k omezení poètu procesù, které mohou souèasnì pou¾ívat + urèitý prostøedek. + </para> + <para> + Toto roz¹íøení také poskytuje funkce pro práci se sdílenou pamìtí vyu¾ívající + System V sdílenou pamì». Sdílená pmìt se dá pou¾ívat k poskytování pøístupu + ke globálním promìnným. Rùzní httpd-daemoni a dokonce i jiné programy (napø. + Perl, C, ...) mohou k tìmto datùm pøistupovat, a vytvoøit tak globální výmìnu + dat. Pamatujte, ¾e sdílená pamì» <emphasis>není</emphasis> chránìna proti + simultáním pøístupùm. K synchronizaci pou¾ijte semafory. + <table> + <title>Omezení sdílené pamìti systémem Unix</title> + <tgroup cols="2"> + <tbody> + <row> + <entry>SHMMAX</entry> + <entry>max. velikost sdílené pamìti, normálnì 131072 bytù</entry> + </row> + <row> + <entry>SHMMIN</entry> + <entry>min. velikost sdílené pamìti, normálne 1 byte</entry> + </row> + <row> + <entry>SHMMNI</entry> + <entry>max. poèet segmentù sdílené pamìti, normálnì 100</entry> + </row> + <row> + <entry>SHMSEG</entry> + <entry>max. poèet segmentù sdílené pamìti na proces, normálnì 6</entry> + </row> + </tbody> + </tgroup> + </table> + </para> + <para> + The messaging functions may be used to send and receive messages to/from + other processes. They provide a simple and effective means of exchanging + data between processes, without the need for setting up an alternative + using unix domain sockets. + </para> + &note.no-windows.extension; + </section> + + <section id="sem.requirements"> + &reftitle.required; + &no.requirement; + </section> + + &reference.sem.configure; + + &reference.sem.ini; + + <section id="sem.resources"> + &reftitle.resources; + <para> + + </para> + </section> + + <section id="sem.constants"> + &reftitle.constants; + &no.constants; + </section> </partintro> &reference.sem.functions; @@ -67,5 +97,8 @@ 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 --> Index: phpdoc-cs/reference/shmop/reference.xml diff -u phpdoc-cs/reference/shmop/reference.xml:1.2 phpdoc-cs/reference/shmop/reference.xml:1.3 --- phpdoc-cs/reference/shmop/reference.xml:1.2 Mon Apr 15 18:06:13 2002 +++ phpdoc-cs/reference/shmop/reference.xml Wed Dec 31 11:56:07 2003 @@ -1,32 +1,61 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.shmop"> <title>Funkce pro práci se sdílenou pamìtí</title> <titleabbrev>shmop</titleabbrev> <partintro> - <para> - Shmop snadno pou¾itelná sada funkcí, která PHP umo¾òuje èíst, zapisovat, - vytváøet a mazat segmenty UNIXové sdílené pamìti. Tyto funkce na Windows - nefungují, proto¾e tento systém nepodporuje sdílenou pamì». Pokud chcete - shmop pou¾ívat, budete muset PHP zkompilovat s <option - role="configure">--enable-shmop</option>. - </para> - <note> - <simpara> - Názvy funkcí popisovaných v této kapitole zaèínají v PHP 4.0.3 na - <function>shm_</function>, ale od PHP 4.0.4 se jejich názvy zmìnily na - <function>shmop_</function>. - </simpara> - </note> - <para> - <example> - <title>Pøehled operací se sdílenou pamìtí</title> - <programlisting role="php"> -<?php - + <section id="shmop.intro"> + &reftitle.intro; + <para> + Shmop je snadno pou¾itelná sada funkcí, která PHP umo¾òuje èíst, zapisovat, + vytváøet a mazat segmenty UNIXové sdílené pamìti. Tyto funkce na Windows + pøedcházejících Windows 2000 nefungují. + </para> + <note> + <simpara> + Názvy funkcí popisovaných v této kapitole zaèínají v PHP 4.0.3 na + <function>shm_</function>, ale od PHP 4.0.4 se jejich názvy zmìnily na + <function>shmop_</function>. + </simpara> + </note> + </section> + + <section id="shmop.requirements"> + &reftitle.required; + &no.requirement; + </section> + + &reference.shmop.configure; + + <section id="shmop.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="shmop.resources"> + &reftitle.resources; + <para> + </para> + </section> + + <section id="shmop.constants"> + &reftitle.constants; + &no.constants; + </section> + + <section id="shmop.examples"> + &reftitle.examples; + <para> + <example> + <title>Shared Memory Operations Overview</title> + <programlisting role="php"> +<![CDATA[ +<?php + // Vytvoøit 100 bytový blok sdílené pamìti se system id 0xff3 $shm_id = shmop_open(0xff3, "c", 0644, 100); -if(!$shm_id) { +if (!$shm_id) { echo "Nepodaøilo se vytvoøit segment sdílené pamìti\n"; } @@ -36,32 +65,34 @@ // Zapí¹eme do sdílené pamìti zku¹ební øetìzec $shm_bytes_written = shmop_write($shm_id, "my shared memory block", 0); -if($shm_bytes_written != strlen("mùj blok sdílené pamìti")) { +if ($shm_bytes_written != strlen("my shared memory block")) { echo "Nepodaøilo se zapsat kompletní data\n"; } // Naèteme øetìzec zpátky $my_string = shmop_read($shm_id, 0, $shm_size); -if(!$my_string) { +if (!$my_string) { echo "Nepodaøilo se èíst z bloku sdílené pamìti\n"; } echo "Data ve sdílené pamìti byla: ".$my_string."\n"; -//Sma¾eme tento blok a zavøeme segment sdílené pamìti -if(!shmop_delete($shm_id)) { +// Sma¾eme tento blok a zavøeme segment sdílené pamìti +if (!shmop_delete($shm_id)) { echo "Nepodaøilo se smazat blok sdílené pamìti."; } shmop_close($shm_id); - -?> - </programlisting> - </example> - </para> + +?> +]]> + </programlisting> + </example> + </para> + </section> </partintro> - + &reference.shmop.functions; - </reference> + </reference>  Index: phpdoc-cs/reference/wddx/reference.xml diff -u phpdoc-cs/reference/wddx/reference.xml:1.2 phpdoc-cs/reference/wddx/reference.xml:1.3 --- phpdoc-cs/reference/wddx/reference.xml:1.2 Mon Apr 15 18:06:16 2002 +++ phpdoc-cs/reference/wddx/reference.xml Wed Dec 31 11:56:08 2003 @@ -1,72 +1,111 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.wddx"> <title>WDDX funkce</title> <titleabbrev>WDDX</titleabbrev> - + <partintro> - <para> - Tyto funkce jsou urèeny pro práci s <ulink url="&url.wddx;">WDDX</ulink>. - </para> - <para> - Pokud chcete pou¾ívat WDDX, budete muset nainstalovat expat knihovnu - (která je u Apache 1.3.7 a vy¹¹ích) a zkompilovat PHP s - <option role="configure">--with-xml</option> a - <option role="configure">--enable-wddx</option>. - </para> - <para> - Pozn.: v¹echny funkce které serializují promìnné pou¾ívají první element - pole k rozhodnutí jestli se toto pole serializuje do pole nebo struktury. - Pokud má první element øetìzec jako index, serializuje se do struktury, - jinak do pole. - + <section id="wddx.intro"> + &reftitle.intro; + <para> + Tyto funkce jsou urèeny pro práci s <ulink + url="&url.wddx;">WDDX</ulink>. + </para> + </section> + + <section id="wddx.requirements"> + &reftitle.required; + <para> + Pokud chcete pou¾ívat WDDX, budete muset nainstalovat expat knihovnu + (která je u Apache 1.3.7 a vy¹¹ích). + </para> + </section> + + &reference.wddx.configure; + + <section id="wddx.configuration"> + &reftitle.runtime; + &no.config; + </section> + + <section id="wddx.resources"> + &reftitle.resources; + &no.resource; + </section> + + <section id="wddx.constants"> + &reftitle.constants; + &no.constants; + </section> + + <section id="wddx.examples"> + &reftitle.examples; + <para> + V¹echny funkce, které serializují promìnné, pou¾ívají první element + pole k rozhodnutí jestli se toto pole serializuje do pole nebo struktury. + Pokud má první element øetìzec jako index, serializuje se do struktury, + jinak do pole. + </para> + <example> <title>Serializace jediné hodnoty</title> <programlisting role="php"> -<?php -print wddx_serialize_value("PHP to WDDX packet example", "PHP packet"); -?> - </programlisting> - </example></para> - - <para> - Tato ukázka vytvoøí: - <informalexample> - <programlisting role="php"> -<wddxPacket version='1.0'><header comment='PHP packet'/><data> -<string>PHP to WDDX packet example</string></data></wddxPacket> +<![CDATA[ +<?php +print wddx_serialize_value("Ukázka pøevodu paketu z PHP do WDDX", "PHP packet"); +?> +]]> </programlisting> - </informalexample> - + <para> + Tato ukázka vytvoøí: + </para> + <screen> +<![CDATA[ +<wddxPacket version='1.0'><header comment='PHP packet'/><data> +<string>Ukázka pøevodu paketu z PHP do WDDX</string></data></wddxPacket> +]]> + </screen> + </example> + <example> <title>Pou¾ití inkrementálních paketù</title> <programlisting role="php"> -<?php +<![CDATA[ +<?php $pi = 3.1415926; $packet_id = wddx_packet_start("PHP"); wddx_add_vars($packet_id, "pi"); -/* Suppose $cities came from database */ +/* Pøedpokládejme, ¾e $cities pochází z databáze */ $cities = array("Austin", "Novato", "Seattle"); wddx_add_vars($packet_id, "cities"); $packet = wddx_packet_end($packet_id); print $packet; -?> +?> +]]> </programlisting> - </example></para> - - <para> - Tato ukázka vytvoøí: - - <informalexample> - <programlisting role="php"> -<wddxPacket version='1.0'><header comment='PHP'/><data><struct> -<var name='pi'><number>3.1415926</number></var><var name='cities'> -<array length='3'><string>Austin</string><string>Novato</string> -<string>Seattle</string></array></var></struct></data></wddxPacket> - </programlisting> - </informalexample></para> - + <para> + Tato ukázka vytvoøí: + </para> + <screen> +<![CDATA[ +<wddxPacket version='1.0'><header comment='PHP'/><data><struct> +<var name='pi'><number>3.1415926</number></var><var name='cities'> +<array length='3'><string>Austin</string><string>Novato</string> +<string>Seattle</string></array></var></struct></data></wddxPacket> +]]> + </screen> + </example> + + <note> + <para> + If you want to serialize non-ASCII characters you have to set + the appropriate locale before doing so (see + <function>setlocale</function>). + </para> + </note> + </section> </partintro> &reference.wddx.functions; @@ -89,5 +128,8 @@ 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 --> Index: phpdoc-cs/reference/xslt/reference.xml diff -u phpdoc-cs/reference/xslt/reference.xml:1.2 phpdoc-cs/reference/xslt/reference.xml:1.3 --- phpdoc-cs/reference/xslt/reference.xml:1.2 Mon Apr 15 18:06:18 2002 +++ phpdoc-cs/reference/xslt/reference.xml Wed Dec 31 11:56:08 2003 @@ -1,52 +1,59 @@ <?xml version="1.0" encoding="iso-8859-2"?> + <reference id="ref.xslt"> <title>XSLT funkce</title> <titleabbrev>XSLT</titleabbrev> <partintro> - &warn.experimental; - <section id="xslt.partintro"> - <title>Úvod</title> - - <section id="xslt.intro"> - <title>O XSLT and Sablotronu</title> - <para> - XSLT (Extensible Stylesheet Language (XSL) Transformations) je jazyk pro - transformaci XML dokumentù do jiných XML dokumentù. Je to standard - definovaný The World Wide Web konsorciem (W3C). Imformace o XSLT a - souvisejících technologiích jsou dostupné na - <ulink url="&url.xslt;">&url.xslt;</ulink>. - </para> - </section> + <section id="xslt.intro"> + &reftitle.intro; + <para> + Toto roz¹íøení PHP poskytuje API nezávislé na zpracovateli pro XSLT + transformace. V souèasnosti toto roz¹íøení podporuje pouze knihovnu + Sablotron od Ginger Alliance. Plánována je podpora také pro dal¹í + knihovny, jako napøíklad Xalan nebo libxslt. + </para> + <para> + XSLT (Extensible Stylesheet Language (XSL) Transformations) je jazyk pro + transformaci XML dokumentù do jiných XML dokumentù. Je to standard + definovaný The World Wide Web konsorciem (W3C). Imformace o XSLT a + souvisejících technologiích jsou dostupné na + <ulink url="&url.xslt;">&url.xslt;</ulink>. + </para> + <note> + <simpara> + Toto roz¹íøení se li¹í od roz¹íøení Sablotron, které bylo distribuováno s + PHP verzemi ni¾¹ími ne¾ 4.1. Od PHP 4.1 je podporováno pouze toto nové + roz¹íøení. Pokud potøebujete podporu pro star¹í roz¹íøení, zeptejte se prosím + v PHP konferencích. + </simpara> + </note> + </section> - <section id="xslt.install"> - <title>Instalace</title> + <section id="xslt.requirements"> + &reftitle.required; <para> Tato extenze vyu¾ívá <productname>Sabloton</productname> a <productname>expat</productname>, které jsou dostupné na <ulink url="&url.sablotron;">&url.sablotron;</ulink>, a to jak binární soubory tak zdrojové kódy. </para> - <para> - Na UNIXu spus»te <command>configure</command> s <option - role="configure">--with-sablot</option>. - <productname>Sablotron</productname> knihovna by mìla být nainstalována - na nìjakém místì, kde ji vá¹ kompilátor mù¾e najít. - </para> - </section> + </section> - <section id="xslt.about"> - <title>O této extenzi</title> - <para> - Tato PHP extenze implementuje podporu <productname>Sablotron</productname> - od Ginger Alliance v PHP. Tato nástrojù vám umo¾òuje transformovat XML - dokumenty na jiné dokumenty, vèetnì nových XML dokumentù, ale také do XML - a jiných cílových formátù. V podstatì poskytuje standardizovaný a pøenosný - systém ¹ablon oddìlující obsah a design websajty. - </para> - </section> + &reference.xslt.configure; + + <section id="xslt.configuration"> + &reftitle.runtime; + &no.config; + </section> + <section id="xslt.resources"> + &reftitle.resources; + &no.resource; </section> + + &reference.xslt.constants; + </partintro> &reference.xslt.functions; @@ -68,5 +75,8 @@ 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 --> Index: phpdoc-cs/reference/outcontrol/ini.xml +++ phpdoc-cs/reference/outcontrol/ini.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="outcontrol.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Konfiguraèní volby øízení výstupu</title> <tgroup cols="3"> <thead> <row> <entry>Název</entry> <entry>Výchozí hodnota</entry> <entry>Lze zmìnit</entry> </row> </thead> <tbody> <row> <entry>output_buffering</entry> <entry>"0"</entry> <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>output_handler</entry> <entry>NULL</entry> <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> <row> <entry>implicit_flush</entry> <entry>"0"</entry> <entry>PHP_INI_PERDIR|PHP_INI_SYSTEM</entry> </row> </tbody> </tgroup> </table> Pro bli¾¹í podrobnosti a definici PHP_INI_* konstant viz <function>ini_set</function>. </para> &ini.descriptions.title; <para> <variablelist> <varlistentry id="ini.output-buffering"> <term> <parameter>output_buffering</parameter> <type>boolean</type>/<type>integer</type> </term> <listitem> <para> Øízení výstupu mù¾ete povolit pro v¹echny soubory nastavením této direktivy na 'On'. Pokud chcete omezit velikost bufferu na urèitou hodnotu, mù¾ete jako hodnotu této direktivy místo 'On' pou¾ít maximální poèet bytù (napø. output_buffering=4096). </para> </listitem> </varlistentry> <varlistentry id="ini.output-handler"> <term> <parameter>output_handler</parameter> <type>string</type> </term> <listitem> <para> Celý výstup va¹ich skriptù mù¾ete pøesmìrovat do funkce. Napøíklad pokud nastavíte output_handler na <function>mb_output_handler</function>, kódování znakù bude transparentnì pøekódováno do zadaného kódování. Nastavení jakékoliv funkce automaticky zapne øízení výstupu. </para> <note> <para> Nemù¾ete pou¾ívat najednou <function>mb_output_handler</function> s <function>ob_inconv_handler</function> a nemù¾ete pou¾ívat najednou <function>ob_gzhandler</function> a <link linkend="ini.zlib.output-compression">zlib.output_compression</link>. </para> </note> </listitem> </varlistentry> <varlistentry id="ini.implicit-flush"> <term> <parameter>implicit_flush</parameter> <type>boolean</type> </term> <listitem> <para> Ve výchozí nastavení je &false;. Zmìna na &true; oznámí PHP, aby oznámilo výstupní vrstvì, aby se automaticky vyprázdnila po ka¾dém vypsaném bloku. Je to ekvivalentní volání <literal>PHP</literal> funkce <function>flush</function> po ka¾dém zavolání funkce <function>print</function> nebo <function>echo</function> a po ka¾dém <literal>HTML</literal> bloku. </para> <para> Kdy¾ se <literal>PHP</literal> pou¾ívá v prostøedí webu, zapnutí této volby má záva¾né výkonnostní dùsledky a obecnì se doporuèuje ho pou¾ívat pouze pro ladìní. Tato hodnota má výchozí nastavení &true; pokud pracujete pod <literal>CLI SAPI</literal>. </para> <para> Viz také <function>ob_implicit_flush</function>. </para> </listitem> </varlistentry> </variablelist> </para> </section>  Index: phpdoc-cs/reference/pdf/configure.xml +++ phpdoc-cs/reference/pdf/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="pdf.installation"> &reftitle.install; <para> Abyste mohli tyto funkce pou¾ívat, musíte PHP zkompilovat s volbou <option role="configure">--with-pdflib[=DIR]</option>. DIR je základní instalaèní adresáø PDFlib, výchozí hodnota je <filename>/usr/local</filename>. Navíc mù¾ete urèit knihovny jpeg, tiff a png, které má PDFlib pou¾ívat, co¾ je volitelné v PDFlib 4.x. Pokud tak chcete uèinit, pøidejte volby configure <option role="configure">--with-jpeg-dir[=DIR]</option> <option role="configure">--with-png-dir[=DIR]</option> <option role="configure">--with-tiff-dir[=DIR]</option>. </para> <para> Od pdflib 3.0 by se pdflib mìla konfigurovat s volbou <literal>--enable-shared-pdflib</literal>. </para> </section>  Index: phpdoc-cs/reference/pfpro/configure.xml +++ phpdoc-cs/reference/pfpro/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="pfpro.installation"> &reftitle.install; <para> Tyto funkce jsou dostupné pouze pokud bylo PHP zkompilováno s volbou <option role="configure">--with-pfpro[=DIR]</option>. </para> </section>  Index: phpdoc-cs/reference/pfpro/ini.xml +++ phpdoc-cs/reference/pfpro/ini.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="pfpro.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Konfiguraèní volby pro Verisign Payflow Pro</title> <tgroup cols="3"> <thead> <row> <entry>Název</entry> <entry>Výchozí hodnota</entry> <entry>Lze zmìnit</entry> </row> </thead> <tbody> <row> <entry>pfpro.defaulthost/PFPRO_VERSION < 3 </entry> <entry>"test.signio.com"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.defaulthost</entry> <entry>"test-payflow.verisign.com"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.defaultport</entry> <entry>"443"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.defaulttimeout</entry> <entry>"30"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.proxyaddress</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.proxyport</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.proxylogon</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>pfpro.proxypassword</entry> <entry>""</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> Pro bli¾¹í podrobnosti a definici PHP_INI_* konstant viz <function>ini_set</function>. </para> </section>  Index: phpdoc-cs/reference/readline/configure.xml +++ phpdoc-cs/reference/readline/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="readline.installation"> &reftitle.install; <para> Abyste mohli pou¾ívat tyto funkce, musíte zkompilovat CGI nebo CLI verzi PHP s podporou pro readline. PHP musíte zkonfigurovat s volbou <option role="configure">--with-readline[=DIR]</option>. Pokud chcete pou¾ívat libedit jako náhradu za readline, zkonfigurujte PHP s volbou <option role="configure">--with-libedit[=DIR]</option>. </para> </section>  Index: phpdoc-cs/reference/recode/configure.xml +++ phpdoc-cs/reference/recode/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="recode.installation"> &reftitle.install; <para> Pokud cchete pou¾ívat funkce definované v tomto modulu, musíte zkompilovat vá¹ PHP interpretr s volbou <option role="configure">--with-recode[=DIR]</option>. </para> <warning> <para> Padání a problémy pøi startu <literal>PHP</literal> mohou být zaznamenány kdy¾ nahráváte roz¹íøení Recode <emphasis role="strong">po</emphasis> nahrání roz¹íøení <link linkend="ref.mysql">mysql</link> nebo <link linkend="ref.imap">imap</link>. Nahrání Recode pøed tìmito roz¹íøeními problém vyøe¹í. Je to kvùli technickému problému spoèívajícímu v tom, ¾e obì C-knihovny pou¾ívané knihovnou imap a recode mají svou vlastní funkci <literal>hash_lookup()</literal> a obì knihovny pou¾ívané mysql a recode mají svou vlastní funkci <literal>hash_insert</literal>. </para> </warning> &warn.imaprecodeyaz; </section>  Index: phpdoc-cs/reference/sem/configure.xml +++ phpdoc-cs/reference/sem/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="sem.installation"> &reftitle.install; <para> Podpora tìchto funkcí není ve výchozím nastavení zapnuta. Pro zapnutí podpory semaforù Systemu V zkompilujte PHP s volbou <option role="configure">--enable-sysvsem</option>. Pro zapnutí podpory sdílené pamìti Systemu V zkompilujte PHP s volbou <option role="configure">--enable-sysvshm</option>. Pro zapnutí podpory zpráv Systemu V zkompilujte PHP s volbou <option role="configure">--enable-sysvmsg</option>. </para> </section>  Index: phpdoc-cs/reference/sem/ini.xml +++ phpdoc-cs/reference/sem/ini.xml <?xml version="1.0" encoding="iso-8859-1"?>  <section id="sem.configuration"> &reftitle.runtime; &extension.runtime; <para> <table> <title>Konfiguraèní volby pro Semaphore</title> <tgroup cols="3"> <thead> <row> <entry>Název</entry> <entry>Výchozí hodnota</entry> <entry>Lze zmìnit</entry> </row> </thead> <tbody> <row> <entry>sysvmsg.value</entry> <entry>"42"</entry> <entry>PHP_INI_ALL</entry> </row> <row> <entry>sysvmsg.string</entry> <entry>"foobar"</entry> <entry>PHP_INI_ALL</entry> </row> </tbody> </tgroup> </table> Pro bli¾¹í podrobnosti a definici PHP_INI_* konstant viz <function>ini_set</function>. </para> </section>  Index: phpdoc-cs/reference/shmop/configure.xml +++ phpdoc-cs/reference/shmop/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="shmop.installation"> &reftitle.install; <para> Pokud chcete shmop pou¾ívat, musíte PHP zkompilovat s volbou <option role="configure">--enable-shmop</option>. </para> </section>  Index: phpdoc-cs/reference/wddx/configure.xml +++ phpdoc-cs/reference/wddx/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="wddx.installation"> &reftitle.install; <para> Po instalaci expatu zkompilujte PHP s volbou <option role="configure">--enable-wddx</option>. </para> &windows.builtin; </section>  Index: phpdoc-cs/reference/xslt/configure.xml +++ phpdoc-cs/reference/xslt/configure.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="xslt.installation"> &reftitle.install; <para> Na UNIXu spus»te <command>configure</command> s volbami <option role="configure">--enable-xslt</option> a <option role="configure">--with-xslt-sablot</option>. <productname>Sablotron</productname> knihovna by mìla být nainstalována na nìjakém místì, kde ji vá¹ kompilátor mù¾e najít. </para> <para> Zaruète, aby byly k <productname>Sablotron</productname>u pøilinkovány stejné knihovny, které jsou pøilinkovány k PHP. Konfiguraèní pøepínaèe <option role="configure">--with-expat-dir=DIR</option> a <option role="configure">--with-iconv-dir=DIR</option> jsou zde proto, aby vám pomohly s jejich specifikací. Pokud po¾adujete podporu, v¾dy se zmiòte o tìchto direktivách a o tom, zda jsou na va¹em systému instalovány jiné verze tìchto knihoven. Jednodu¹e øeèeno, poskytnìte v¹echna èísla verzí. </para> <caution> <para> Zaruète, aby knihovna Sablot byla pøilinkována k <literal>-lstdc++</literal>, jinak se konfigurace nepodaøí nebo se PHP nespustí nebo nezavede. </para> </caution> <note> <title>Podpora pro JavaScript E-XSLT</title> <simpara> Pokud jste <productname>Sablotron</productname> zkompilovali s podporou pro JavaScript, musíte zadat volbu <option role="configure">--with-sablot-js=DIR</option>. </simpara> </note> <note> <title>Poznámka pro u¾ivatele Win32</title> <simpara> Abyste mohli tento modul pou¾ívat pod Windows, musíte zkopírovat nìjaké soubory z adresáøe DLL disribuèního archivu PHP/Win32 do adresáøe SYSTEM32 va¹ich Windows. (Napø.: <filename>C:\WINNT\SYSTEM32</filename> nebo <filename>C:\WINDOWS\SYSTEM32</filename>). Pro PHP <= 4.2.0 zkopírujte <filename>sablot.dll</filename> a <filename>expat.dll</filename>. Pro PHP >= 4.2.1 zkopírujte <filename>sablot.dll</filename>, <filename>expat.dll</filename> a <filename>iconv.dll</filename>. </simpara> </note> </section>  Index: phpdoc-cs/reference/xslt/constants.xml +++ phpdoc-cs/reference/xslt/constants.xml <?xml version="1.0" encoding="iso-8859-2"?>  <section id="xslt.constants"> &reftitle.constants; &extension.constants; <variablelist> <varlistentry> <term> <constant>XSLT_OPT_SILENT</constant> (<type>integer</type>) </term> <listitem> <simpara> Zru¹it ve¹keré logování a hlá¹ení chyb. Jedná se o obecnou volbu pro v¹echny nástroje, které mohou být pøidány v budoucnu. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>XSLT_SABOPT_PARSE_PUBLIC_ENTITIES</constant> (<type>integer</type>) </term> <listitem> <para> Pøikázat <productname>Sablotron</productname>u, aby parsoval veøejné entity. Ve výchozím nastavení je tato volba vypnuta. </para> </listitem> </varlistentry> <varlistentry> <term> <constant>XSLT_SABOPT_DISABLE_ADDING_META</constant> (<type>integer</type>) </term> <listitem> <para> Nepøidávat meta znaèku "Content-Type" do HTML výstupu. Výchozí nastavení je urèeno bìhem kompilace <productname>Sablotron</productname>u. </para> </listitem> </varlistentry> <varlistentry> <term> <constant>XSLT_SABOPT_DISABLE_STRIPPING</constant> (<type>integer</type>) </term> <listitem> <simpara> Potlaèit odstraòování bílých znakù (pouze u datových souborù). </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>XSLT_SABOPT_IGNORE_DOC_NOT_FOUND</constant> (<type>integer</type>) </term> <listitem> <simpara> Pova¾ovat nerozpoznané dokumenty (funkce document()) za nesmrtelné. </simpara> </listitem> </varlistentry> <varlistentry> <term> <constant>XSLT_ERR_UNSUPPORTED_SCHEME</constant> (<type>integer</type>) </term> <listitem> <simpara> Vrátit chybový kód, pro <link linkend="function.xslt-set-scheme-handlers">scheme handlers</link>. </simpara> </listitem> </varlistentry> </variablelist> </section>