goba Mon Aug 20 11:35:41 2001 EDT
Modified files:
/phpdoc/hu/functions outcontrol.xml
Log:
Adding new outcontrol translation by Heilig Szabolcs :))
Index: phpdoc/hu/functions/outcontrol.xml
diff -u /dev/null phpdoc/hu/functions/outcontrol.xml:1.3
--- /dev/null Mon Aug 20 11:35:41 2001
+++ phpdoc/hu/functions/outcontrol.xml Mon Aug 20 11:35:41 2001
@@ -0,0 +1,453 @@
+<?xml encoding="iso-8859-2"?>
+
+ <reference id="ref.outcontrol">
+ <title>Kimenet Szab�lyoz� F�ggv�nyek</title>
+ <titleabbrev>Kimenet Szab�lyz�s</titleabbrev>
+
+ <partintro>
+ <para>
+ A kimenet szab�lyz� f�ggv�nyek teszik lehet�v�, hogy teljes
+ kontrolt szerezz�nk afelett, mikor ker�ljon a PHP
+ script fut�s�nak eredm�nye a kimenetre, azaz Apache
+ modulk�nt pl. mikor adja azt �t ezt a webszervernek.
+ Hasznos ez akkor, amikor fejl�cadatokat akarunk
+ m�g l�trehozni/m�dos�tani, mik�zben m�r
+ a html lap genegr�l�s�nak k�zep�n j�runk. Eme kimenetvez�rl�
+ f�ggv�nyek nincsenek hat�ssal a <function>header</function>
+ vagy a <function>setcookie</function> �ltal l�trehozott fejl�c
+ adatokra, csakis a t�rzsben tal�lhat�, <function>echo</function>
+ vagy egy�b f�ggv�nyek �ltal gener�lt kimenetre, valamint
+ a php k�don k�v�li statikus r�szekre (azaz amik a <?
+ > jeleken k�v�l tal�lhat�ak).
+ </para>
+ <para>
+ <example>
+ <title>Kimenet Szab�lyz�s P�lda</title>
+ <programlisting role="php">
+<?php
+
+ob_start();
+echo "Szia\n";
+
+setcookie ("sutineve", "sutiadat");
+
+ob_end_flush();
+
+?>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ A fenti p�ld�ban az echo �ltal gener�lt sz�veg a pufferben
+ v�rakozik mindaddig, am�g egy <function>ob_end_flush</function
+ parancs nem �rkezik. Mindek�zben a <function>setcookie</function>
+ �ltal gener�lt fejl�csor minden hiba n�l�l elmegy a b�ng�sz�
+ fel� (ez am�gy lehetetlen volna, mivel az echo m�r a webszerver
+ fel� k�ld�tt adatok t�rzs�be dolgozna, �gy a fejl�cbe
+ �rni m�r lehetetlens�g lenne).
+ </para>
+ <para>
+ L�sd m�g: <function>header</function> �s
+ <function>setcookie</function>.
+ </para>
+ </partintro>
+
+ <refentry id="function.flush">
+ <refnamediv>
+ <refname>flush</refname>
+ <refpurpose>A kimeneti puffer �rit�se</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>flush</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <simpara>
+ Ezzel a f�ggv�nnyel tudjuk k�nyszer�teni a php kimenet�t
+ esetlegesen pufferel� programnak (ez lehet a CGI r�teg,
+ avagyon a webszerver p�ld�ul), hogy azonnal �r�tse ezt
+ a puffert. Gyakorlatilag ez annyit jelent, hogy az adatok
+ azonnal elindulnak a b�ng�sz� fele.
+ </simpara>
+ <note>
+ <para>
+ A <function>flush</function> nincs hat�ssal a php
+ saj�t pufferel�si rendszer�re, sem a b�ng�sz�
+ esetleges pufferel�si mechanizmus�ra.
+ </para>
+ <para>
+ Bizonyos szerverek, p�ld�nak ok��rt a Win32 alatt fut�k
+ ennek ellen�re is pufferelik a php-t�l kapott kimenetet,
+ am�g annak fut�sa be nem fejez�dik.
+ </para>
+ <para>
+ Az is lehets�ges m�g, hogy a b�ng�sz� maga puffereli a
+ kapott adatokat. P�ld�ul a Netscape a kapott html-t
+ puffereli, am�g egy sorv�ge jellel nem tal�lkozik,
+ vagy egy html c�mke kezdet�t nem l�tja. Emellett
+ a t�bl�zatokat csak a </table> z�r�c�mke
+ meg�rkez�se ut�n rajzolja csak ki.
+ </para>
+ </note>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-start">
+ <refnamediv>
+ <refname>ob_start</refname>
+ <refpurpose>A kimenet pufferel�s bekapcsol�sa</refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>ob_start</function></funcdef>
+ <paramdef>string
+ <parameter>
+ <optional>output_callback</optional>
+ </parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Ezzel a f�ggv�nnyel kapcsolhatjuk be a PHP saj�t bels�
+ kimenet pufferel�si mechanizmus�t. Ameddig a kimenet
+ pufferel�s be van kapcsolva, a fejl�cadatokon k�v�l
+ semmif�le kimenet nem hagyja el a PHP h�za t�j�k�t,
+ az egy bels� pufferben t�rol�dik.
+ </para>
+ <para>
+ Ennek a puffernek a tartalma az <function>ob_get_contents</function>
+ f�ggv�ny seg�ts�g�vel v�ltoz�ba m�solhat�. Ha v�g�l szeretn�nk
+ a puffer tartalm�t kiadni a php kez�b�l, akkor j�n sz�ba az
+ <function>ob_end_flush</function>. Ha valami�rt menet k�zben
+ �gy d�nt�nk, a puffer tartalma m�gis felesleges, az
+ <function>ob_end_clean</function> csendben �s titokban
+ megsemmis�ti a puffer�nket tartalmast�l, nem hagyja el egy
+ b�jt sem ekkor a php-t.
+ </para>
+ <para>
+ Az itt <parameter>output_callback</parameter> n�ven nevezett
+ m�sodik, opcion�lis param�ter seg�ts�g�vel megadhatunk egy
+ f�ggv�nyt, melynek egy string t�pus� adatot kell param�terk�nt
+ fogadnia, �s ugyancsak stringet kell visszaadnia. Ez a
+ megadhat� f�ggv�ny akkor h�v�dik meg, amikor az
+ <function>ob_end_flush</function> megh�v�sra ker�l, vagy a
+ script v�gezt�vel a kimeneti puffer �r�t�sekor,
+ automatikusan. Ekkor megkapja ez az <parameter>output_callback</parameter>
+ param�terben megadott f�ggv�ny a puffer tartalm�t, ezzel
+ elj�tszhadozhat, majd visszaadja a j�tszadoz�s eredm�ny�t,
+ �s ez ker�l v�g�l a php kimenet�re.
+ </para>
+ <note>
+ <para>
+ A 4.0.4-es PHP verzi�t�l felfele l�tezik egy
+ <function>ob_gzhandler</function> nev� be�p�tett php f�ggv�ny,
+ mely seg�ts�g�vel gz t�m�r�tett form�ban k�ldhetj�k el
+ adatainkat a b�ng�sz� fele. Az <function>ob_gzhandler</function>
+ erre csak akkor vetemedik, ha �gy tal�lja, a b�ng�sz� ezt
+ a gzip k�dolt form�tumot elfogadja. Ezt a f�ggv�nyt teh�t
+ az <function>ob_start</function> m�sodik param�terek�nt megadva
+ haszn�lhatjuk fel.
+ </para>
+ </note>
+ <para>
+ A pufferek egym�sba �gyazhat�ak, azaz mik�zben m�r
+ van akt�v kimeneti puffer�nk, hozhatunk l�tre m�g
+ egyet. Viszont ez esetben biztosnak kell lenn�nk
+ abban, hogy az <function>ob_end_flush</function>
+ megfelel� sz�mban meg legyen h�vva. Ha t�bb
+ <parameter>output_callback</parameter> is meg van ilyenkor
+ adva, mindegyik pufferhez m�sfajta, akkor azok
+ mind sorban v�grehajt�dnak az egym�sba �gyazotts�g
+ sorrendj�ben.
+ </para>
+ <example>
+ <title>Felhaszn�l� �ltal �rt pufferm�dos�t� f�ggv�ny haszn�lata</title>
+ <programlisting role="php">
+<?php
+
+function callback($buffer) {
+
+ // minden s�rt borra cser�l�nk
+ return (ereg_replace("S�rre", "Borra", $buffer));
+
+}
+
+ob_start("callback");
+
+?>
+
+<html>
+<body>
+<p>S�rre bor, mindenkor!
+</body>
+</html>
+
+<?php
+
+ob_end_flush();
+
+?>
+ </programlisting>
+ </example>
+ <para>
+ A k�vetkez� kimenet j�n l�tre:
+ <informalexample>
+ <programlisting role="php">
+<html>
+<body>
+<p>Borra bor, mindenkor!
+</body>
+</html>
+ </programlisting>
+ </informalexample>
+ </para>
+ <para>
+ L�sd m�g: <function>ob_get_contents</function>,
+ <function>ob_end_flush</function>,
+ <function>ob_end_clean</function>,
+ <function>ob_implicit_flush</function> �s
+ <function>ob_gzhandler</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-get-contents">
+ <refnamediv>
+ <refname>ob_get_contents</refname>
+ <refpurpose>
+ A kimeneti puffer tartalm�nak kinyer�se
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>ob_get_contents</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ A kimeneti puffer tartalm�t adja vissza, vagy &false; �rt�ket,
+ ha a kimeneti puffer mechanizmus nem akt�v.
+ </para>
+ <para>
+ L�sd m�g: <function>ob_start</function> �s
+ <function>ob_get_length</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-get-length">
+ <refnamediv>
+ <refname>ob_get_length</refname>
+ <refpurpose>
+ A kimeneti puffer aktu�lis m�ret�nek kiolvas�sa
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>ob_get_length</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Eme f�ggv�nnyel tudjuk meg�llap�tani, milyen m�ret� jelenleg
+ a kimeneti puffer, azaz mennyi kik�ld�sre v�r� adat van benne.
+ Ha nem akt�v a kimeneti pufferel�s a visszat�r�si �rt�k
+ &false; lesz.
+ </para>
+ <para>
+ L�sd m�g: <function>ob_start</function> �s
+ <function>ob_get_contents</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-gzhandler">
+ <refnamediv>
+ <refname>ob_gzhandler</refname>
+ <refpurpose>
+ ob_start f�ggv�nyhez haszn�latos, kimenet gzip-el� f�ggv�ny
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>string <function>ob_gzhandler</function></funcdef>
+ <paramdef>string <parameter>buffer</parameter></paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Az <function>ob_gzhandler</function> f�ggv�ny arra
+ lett l�trehozva, hogy az <function>ob_start</function>
+ m�sodik param�terek�nt megadva megpr�b�lkozzon gzip
+ t�m�r�tettre alak�tva tov�bb�tani a kimeneti puffert.
+ Pr�b�lkoz�sr�l az�rt van csak sz�, mert ezt a k�dol�st
+ csak akkor hajtja v�gre, ha a b�ng�sz� elfogadja ezt
+ a form�tumot. Ezt az inform�ci�t HTTP k�r�s fejl�c�ben
+ k�ldi a b�ng�sz�, "Accept-Encoding" n�v alatt. Ha van ilyen
+ inform�ci� a b�ng�sz�r�l, �s ennek �rt�ke "gzip" vagy
+ "deflate", ennek megfelel�en k�ldi a megfelel�
+ "Content-Type" fejl�cet �s a k�dolt weblapot.
+ Ez b�ng�sz�f�ggetlen meold�s, hisz a b�ng�sz� maga
+ k�zli, hogy hajland�-e ilyen form�ban adatot
+ fogadni, vagy sem.
+ </para>
+ <para>
+ <example>
+ <title><function>ob_gzhandler</function> P�lda</title>
+ <programlisting role="php">
+<?php
+
+ob_start("ob_gzhandler");
+
+?>
+<html>
+<body>
+<p>Ez egy t�m�r�tett oldal lesz (tal�n). :)
+</html>
+</body>
+ </programlisting>
+ </example>
+ </para>
+ <para>
+ L�sd m�g: <function>ob_start</function> �s
+ <function>ob_end_flush</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-end-flush">
+ <refnamediv>
+ <refname>ob_end_flush</refname>
+ <refpurpose>
+ A kimeneti puffer �r�t�se (kik�ld�se), �s a kimeneti pufferel�s lekapcsol�sa
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>ob_end_flush</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Eme f�ggv�ny elk�ldi a kimeneti puffer tartam�t a kimenetre,
+ majd kikapcsolja a pufferel�st. Ha sz�ks�g lenne m�g a puffer
+ tartalm�ra esetlegesen k�s�bbi m�veletekhez, az
+ <function>ob_get_contents</function> f�ggv�ny seg�ts�g�vel
+ tudjuk v�ltoz�ba menteni azt, miel�tt m�g az
+ <function>ob_end_flush</function> megh�v�sra ker�lne.
+ </para>
+ <para>
+ L�sd m�g: <function>ob_start</function>,
+ <function>ob_get_contents</function>, �s
+ <function>ob_end_clean</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-end-clean">
+ <refnamediv>
+ <refname>ob_end_clean</refname>
+ <refpurpose>
+ A kimeneti puffer t�rl�se, �s egyidej�leg a pufferel�s kikapcsol�sa
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>ob_end_clean</function></funcdef>
+ <void/>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Eme f�ggv�ny alkalmaz�s�val teljesen megsemmis�thetj�k a
+ kimeneti puffer tartalm�t, valamint megsz�ntethetj�k
+ a pufferel�st is egyben.
+ </para>
+ <para>
+ L�sd m�g: <function>ob_start</function> �s
+ <function>ob_end_flush</function>.
+ </para>
+ </refsect1>
+ </refentry>
+
+ <refentry id="function.ob-implicit-flush">
+ <refnamediv>
+ <refname>ob_implicit_flush</refname>
+ <refpurpose>
+ Az implicit puffer�r�t�s ki-be kapcsol�sa
+ </refpurpose>
+ </refnamediv>
+ <refsect1>
+ <title>Le�r�s</title>
+ <funcsynopsis>
+ <funcprototype>
+ <funcdef>void <function>ob_implicit_flush</function></funcdef>
+ <paramdef>int
+ <parameter><optional>flag</optional></parameter>
+ </paramdef>
+ </funcprototype>
+ </funcsynopsis>
+ <para>
+ Az <function>ob_implicit_flush</function> seg�ts�g�vel
+ kapcsolhat� be vagy ki az implicit puffer�r�t�s.
+ Az itt <parameter>flag</parameter> n�ven nevezett
+ opcion�lis param�ter elhagy�sa eset�n a
+ f�ggv�nyh�v�sa bekapcsol�st jelent, am�gy �rt�ke
+ "on" vagy "off" kell legyen.
+ Ha az implicit puffer�r�t�s be van kapcsolva,
+ minden olyan m�velet ut�n amely kimenetet
+ gener�l, megh�v�dik a <function>flush</function>
+ f�ggv�ny, ez�ltal a webszerver minden PHP kimeneti
+ parancs ut�n tov�bb�tani fogja azonnal a b�ng�sz�
+ fele az adott dokumentumr�szletet. Ekkor a <function>flush</function>
+ h�vogats�ra term�szetszer�leg nincs sz�ks�g.
+ </para>
+ <para>
+ Ha bekapcsoljuk ezt az implicit puffer�r�t�si
+ opci�t, �s ekkor akt�v kimeneti pufferel�s fut,
+ azaz m�r volt megh�vva <function>ob_start</function>
+ f�ggv�ny, ez a kimeneti pufferel�s azonnal
+ kimenetre �r�t�ssel, valamint a kimeneti pufferel�s
+ lekapcsol�s�val j�r. Teh�t mintha egy
+ <function>ob_end_flush</function>
+ f�ggv�nyh�v�st alkalmaztunk volna.
+ </para>
+ <para>
+ L�sd m�g: <function>flush</function>,
+ <function>ob_start</function>, �s
+ <function>ob_end_flush</function>.
+ </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
+sgml-parent-document:nil
+sgml-default-dtd-file:"../../manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
