cvs: phpdoc /cs/features connection-handling.xml cookies.xml http-auth.xml images.xml persistent-connections.xml remote-files.xml

From: Date: Wed, 24 Jan 2001 13:12:35 +0000
Subject: cvs: phpdoc /cs/features connection-handling.xml cookies.xml http-auth.xml images.xml persistent-connections.xml remote-files.xml
Groups: php.doc 
Request: Send a blank email to phpdoc+get-969333904@lists.php.net to get a copy of this message
cynic Wed Jan 24 05:12:35 2001 EDT Added files: /phpdoc/cs/features connection-handling.xml cookies.xml http-auth.xml images.xml persistent-connections.xml remote-files.xml Log: first couple of files

Index: phpdoc/cs/features/connection-handling.xml +++ phpdoc/cs/features/connection-handling.xml <chapter id="features.connection-handling"> <title>Obsluha spojení</title> <note> <para>Následující text platí pro verzi 3.0.7 a vyšší.</para> </note> <para> Stav spojení se v PHP internì sleduje. Jsou tøi možné stavy: <itemizedlist> <listitem><simpara>0 - NORMAL (normální)</simpara></listitem> <listitem><simpara>1 - ABORTED (zrušeno)</simpara></listitem> <listitem><simpara>2 - TIMEOUT (vypršel èasový limit)</simpara></listitem> </itemizedlist> </para> <simpara> Pøi normálním bìhu PHP skriptu je aktivní stav NORMAL. Pokud se klient odpojí, nastaví se pøíznak ABORTED. K odpojení vzdáleného klienta typicky dochází, když uživatel zmáèkne tlaèítko STOP. Pokud se dosáhne èasového limitu (viz <function>set_time_limit</function>), nastaví se stavový pøíznak TIMEOUT. </simpara> <simpara> Mùžete se rozhodnout jestli chcete, aby odpojení klienta zpùsobilo pøedèasné ukonèení vašeho skriptu. Nìkdy je užiteèné nechat skripty dobìhnout do konce, pøestože není vzdáleného browseru, který by pøijímal výstup. Výchozí chování je nicménì takové, že pøi odpojení vzdáleného klienta dojde k ukonèení bìhu skriptu. Toto chování se dá zmìnit skrze konfiguraèní direktivu ignore_user_abort v php3.ini, odpovídající direktivu php3_ignore_user_abort v .conf souboru Apache, èi funkci <function>ignore_user_abort</function>. Pokud nedáte PHP pokyn ignorovat odpojení uživatele a ten se odpojí, vᚠskript se ukonèí. Výjimkou je, pokud máte pomocí <function>register_shutdown_function</function> zaregistrovanou funkci pro provedení pøi ukonèení skriptu. V tom pøípadì, pokud vzdálený uživatel zmáèkne tlaèítko STOP, pøi dalším pokusu tohoto skriptu odeslat výstup PHP detekuje, že spojení bylo zrušeno, a zavolá se funkce zaregistrovaná pro provedení pøi ukonèení skriptu. Tato funkce se zavolá také na konci bìhu skriptu konèícím normálnì, takže pokud chcete po zrušeném spojení udìlat nìco jiného, mùžete použít <function>connection_aborted</function>. Tato funkce vrátí <literal>true</literal>, pokud bylo spojení zrušeno. </simpara> <simpara> Vᚠskript mùže také ukonèit vestavìný èítaè èasu. Výchozí èasový limit je 30 sekund. To se dá zmìnit max_execution_time direktivou v phpš.ini nebo odpovídající php3_max_execution_time direktivou v .conf souboru Apahe, èi voláním funkce <function>set_time_limit</function>. Když èítaè èasu dobìhne, skript se ukonèí, a jako ve výše uvedeném pøípadì uživatelského odpojení, pokud je zaregistrovaná funkce pro provedení pøi ukonèení skriptu, tato se zavolá. Uvnitø této funkce mùžte zkontrolovat, jestli její zavolání zpùsobilo dobìhnutí èítaèe èasu zavoláním funkce <function>connection_timeout</function>. Tato funkce vrátí <literal>true</literal>, pokud volání funkce registrované pro provedení pøi ukonèení skriptu zpùsobilo dobìhnutí èítaèe èasu. </simpara> <simpara> Skuteèností hodnou povšimnutí je, že stavy ABORTED a TIMEOUT mohou být aktivní souèasnì. Možné je to v pøípadì, že naøídíte PHP ignorovat odpojení uživatee. PHP i tak bude vìdìt, že uživatel pøerušil spojení, ale skript pobìží dál. Pokud potom dosáhne èasového limitu, bude ukonèen, a zavolá se vaše funkce pro provedení pøi ukonèení skriptu, pokud existuje. V tomto okamžiku zjistíte, že jak <function>connection_timeout</function>, tak <function>connection_aborted</function> vracejí <literal>true</literal>. Oba stavy mùžete zkontrolovat jediným voláním funkce <function>connection_status</function>. Tato funkce vrací bitové pole aktivních stavù. Takže napøíklad, pokud jsou aktivní oba tyto stavy, vrátí 3. </simpara> </chapter> <!-- 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: --> Index: phpdoc/cs/features/cookies.xml +++ phpdoc/cs/features/cookies.xml <chapter id="features.cookies"> <title>Cookies</title> <para> PHP transparentnì podporuje HTTP cookies. Cookies jsou mechanismem na ukládání dat ve vzdáleném browseru a tudíž sledování nebo identifikaci vracejících se uživatelù. Cookies mùžete nastavovat pomocí funkce <function>setcookie</function>. Cookies jsou souèástí HTTP hlavièky, tudíž <function>setcookie</function> se musí volat pøed odesláním výstupu do browseru. To je stejné omezení, jako má funkce <function>header</function>. </para> <para> Všechny cookies pøijaté od klienta se automaticky stávají PHP promìnnou stejnì jako u GET a POST dat. Pokud chcete pøiøadit jednomu cookie více hodnot, pøidejte <emphasis>[]</emphasis> na konec jména cookie. Více detailù viz funkce <function>setcookie</function>.</para> </chapter> <!-- 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: --> Index: phpdoc/cs/features/http-auth.xml +++ phpdoc/cs/features/http-auth.xml <chapter id="features.http-auth"> <title>HTTP autentikace a PHP</title> <simpara> Prostøedky HTTP autentikace jsou v PHP pøístupné pouze pokud PHP bìží jako modul Apache, tudíž nejsou pøístupné v CGI verzi. V PHP skriptu bìžícím pod modulem Apache lze použít funkci <function>Header</function> k odeslání zprávy "Authentication Required" klientskému browseru, což vyvolá zobrazení dialogového okna pro vložení uživatelského jména a hesla. Jakmile uživatel zadá jméno a heslo, URL obsahující tento PHP skript se zavolá znovu s promìnnými $PHP_AUTH_USER, $PHP_AUTH_PW and $PHP_AUTH_TYPE obsahujícími jméno, heslo a typ autentikace. V souèasnosti je podporována pouze "Basic" autentikace. Více informací viz funkce <function>Header</function>. </simpara> <para> Následující fragment kódu mùže posloužit jako ukázka vyžádání autentikace uživatele na stránce: <example> <title>Ukázka HTTP Autentikace</title> <programlisting role="php"> &lt;?php if(!isset($PHP_AUTH_USER)) { Header(&quot;WWW-Authenticate: Basic realm=\&quot;My Realm\&quot;&quot;); Header(&quot;HTTP/1.0 401 Unauthorized&quot;); echo &quot;Text, který se odešle, pokud uživatel zmáèkne tlaèítko Cancel\n&quot;; exit; } else { echo &quot;Ahoj $PHP_AUTH_USER.&lt;P&gt;&quot;; echo &quot;Jako heslo jsi zadal $PHP_AUTH_PW.&lt;P&gt;&quot;; } ?> </programlisting> </example></para> <para> Místo protého vytištìní $PHP_AUTH_USER a $PHP_AUTH_PW byste asi chtìli ovìøit platnost zadaného jména a hesla. Napøíklad dotazem v databázi nebo vyhledáním uživatele v dbm souboru. </para> <para> Pozor na chybové browsery Internet Explorer. Zdá se, že jsou velice vybíravé, pokud jde o poøadí hlavièek. Zdá se, že odeslání hlavièky <emphasis>WWW-Authenticate</emphasis> pøed hlavièkou <errorcode>HTTP/1.0 401</errorcode> zabírá. </para> <simpara> Aby se zabránilo psaní skriptù odhalujících hesla na stránkách autentikovaných nìkterým z tradièních externích mechanismù, PHP_AUTH promìnné se nevytvoøí, pokud je pro tu kterou stránku zapnuta externí autentikace. V takovém pøípadì mùžete k identifikaci externì autentikovaného uživatele použít promìnnou $REMOTE_USER. </simpara> <simpara> Všimnìte si nicménì, že výše uvedené nezabrání krádežím hesel z autentikovaných URL osobou, která ovládá neautentikovanou URL na stejném serveru. </simpara> <simpara> Jak Netscape, tak Internet Explorer po pøijetí response kódu 401 vyprázdní autentikaèní cache souèasného realmu. Tak mùžete uživatele v podstatì "odlogovat". Nìkteøí lidé toho využívají k "vypršení" pøihlášení nebo tvorbì odhlašovacího tlaèítka. </simpara> <simpara></simpara> <example> <title>Ukázka HTTP autentikace vyžadující nové jméno a heslo</title> <programlisting role="php"> &lt;?php function authenticate() { Header( &quot;WWW-authenticate: basic realm=\&quot;Test Authentication System\&quot;&quot;); Header( &quot;HTTP/1.0 401 Unauthorized&quot;); echo &quot;K pøístupu na tento zdroj musíte zadat platné ID a heslo\n&quot;; exit; } if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 &amp;&amp; !strcmp($OldAuth, $PHP_AUTH_USER)) ) { authenticate(); } else { echo &quot;Welcome: $PHP_AUTH_USER&lt;BR&gt;&quot;; echo &quot;Old: $OldAuth&quot;; echo &quot;&lt;FORM ACTION=\&quot;$PHP_SELF\&quot; METHOD=POST&gt;\n&quot;; echo &quot;&lt;INPUT TYPE=HIDDEN NAME=\&quot;SeenBefore\&quot; VALUE=\&quot;1\&quot;&gt;\n&quot;; echo &quot;&lt;INPUT TYPE=HIDDEN NAME=\&quot;OldAuth\&quot; VALUE=\&quot;$PHP_AUTH_USER\&quot;&gt;\n&quot;; echo &quot;&lt;INPUT TYPE=Submit VALUE=\&quot;Re Authenticate\&quot;&gt;\n&quot;; echo &quot;&lt;/FORM&gt;\n&quot;; } ?> </programlisting> </example> <simpara> Podle standardu HTTP Basic authentication se toto chování nevyžaduje, takže byste na to nikdy nemìli spoléhat. Pokusy s Lynxem ukázaly, že Lynx po pøijetí response kódu 401 nevyprázdní autentikaèní údaje, takže po stisknutí back a forward se znovu ukáže požadovaný zdroj (pokud se nezmìnily požadavky na údaje). </simpara> <simpara> Dále si všimnìte, že tato vlastnost pøi použití IIS serveru a CGI verze PHP díky omezením IIS nefunguje. </simpara> </chapter> <!-- 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: --> Index: phpdoc/cs/features/images.xml +++ phpdoc/cs/features/images.xml <chapter id="features.images"> <title>Tvorba a úpravy obrázkù</title> <simpara> PHP není omezeno na tvorbu pouze HTML výstupu. Mùže také vytváøet a upravovat obrázkové soubory rùzných formátù, vèetnì gif, png, jpg, wbmp a xpm. PHP mùže dokonce pøímo posílat obrazové proudy do browseru. Na to budete potøebovat PHP zkompilované s GD knihovnou obrazových funkcí. GD a PHP mohou vyžadovat další knihovny v závislosti na obrazových formátech, se kterými chcete pracovat. GD pøestala podporovat gif obrázky ve verzi 1.6. </simpara> <para> <example> <title>Tvorba PNG obrázkù v PHP</title> <programlisting role="php"> &lt;?php Header("Content-type: image/png"); $string=implode($argv," "); $im = imageCreateFromPng("images/button1.png"); $orange = ImageColorAllocate($im, 220, 210, 60); $px = (imagesx($im)-7.5*strlen($string))/2; ImageString($im,3,$px,9,$string,$orange); ImagePng($im); ImageDestroy($im); ?> </programlisting> </example> Tento pøíklad by se volal ze stránky pomocí tagu podobného tomuto: &lt;img src=&quot;button.php?text&quot;&gt; Skript button.php pak vezme øetìzec &quot;text&quot;, pøekryje jím základní obrázek, což je v tomto pøípadì &quot;images/button1.png&quot; a zobrazí výsledný obrázek. Toto je vhodný zpùsob jak se vyhnout kreslení nového obrázku tlaèítka pokaždé, když chcete zmìnit text tlaèítka. Touto metodou se generují automaticky. </para> </chapter> <!-- 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: --> Index: phpdoc/cs/features/persistent-connections.xml +++ phpdoc/cs/features/persistent-connections.xml <chapter id="features.persistent-connections"> <title>Persistentní databázová spojení</title> <simpara> Trvalá spojení jsou SQL spojení, která se nezavírají na konci prùbìhu skriptu. Pøi požadavku na trvalé spojení PHP nejdøíve zkontroluje, jestli už neexistuje identické spojení (které zùstalo otevøeno z døívìjška) - a pokud existuje, použije ho. Pokud neexistuje, PHP ho otevøe. "Identické" spojení je spojení, které bylo otevøeno se stejným serverem, uživatelským jménem a heslem (pokud je zadáte). </simpara> <simpara> Lidé, kteøí nejsou dùkladnì obeznámeni se zpùsobem, jakým web servery fungují a distribuují zátìž mohou pokládat trvalá spojení za nìco èím nejsou. Zvláštì <emphasis>neumožòují</emphasis> otvírání "uživatelských sessions" na stejném SQL spojení, <emphasis>neumožòují</emphasis> efektivní tvorbu transakcí, a neumožòují spoustu dalších vìcí. Dokonce, aby bylo opravdu a dúkladnì jasno, vám trvalá spojení nedají <emphasis>žádnou</emphasis> funkcionalitu, která by nebyla možná s jejich netrvalými protìjšky. </simpara> <simpara> Proè? </simpara> <simpara> To je dáno zpùsobem, jakým fungují webové servery. Jsou tøi zpùsoby, jakými vᚠweb server mùže využít PHP ke generování webových stránek. </simpara> <simpara> První metodou je použít PHP jako CGI "obal". V tomto režimu se vytváøí a nièí jedna instance PHP interpretru pro každý požadavek (na PHP strnánku) na vašem web serveru. Protože je znièna po obsloužení požadavku, všechny zdroje, které získá (jako tøeba spojení s databázovým serverem) jsou pøi jejím znièení zavøeny. V tomto pøípadì pokusem o použití trvalých spojení nic nezískáte - prostì nevydrží. </simpara> <simpara> Druhou, a nejpopulárnìjší, metodou, je provozovat PHP jako modul v multiprocesním web serveru, což je množina, která v souèasnosti obsahuje pouze Apache. Multiprocesní web serveru má typicky jeden proces (rodièe), který øídí skupinu procesù (svých dìtí), které dìlají vlastní práci - servírují stránky. Každý požadavek, který pøijde od klienta, je obsloužen jedním z dìtí, které právì neobsluhuje jiného klienta. To znamená, že když stejný klient vznese další požadavek na stejný server, tento mùže být obsloužen jiným dìtským procesem než ten první. Trvalá spojení zajišují, aby se každý dìtský proces musel na vᚠSQL server pøihlásit pouze pøi prvním odeslání stránky, která takové spojení využívá. Když spojení s SQL serverem vyžaduje další stránka, mùže použít spojení, které toto dítì otevøelo už døíve. </simpara> <simpara> Poslední metodou je použít PHP jako plugin v multithreadovém web serveru. To je v souèasností pouhá teorie - PHP ještì nefunguje jako plagin v žádném multithreadovém web serveru. Pracuje se na podpoøe ISAPI, WSAPI a NSAPI (na Windows), což umožní používat PHP jako plugin v multithreadových serverech jako Netscape FastTrack, Microsoft Internet Information Server (IIS), a O'Reilly's WebSite Pro. Až k tomu dojde, chování bude v podstatì stejné jako u multiprocesním modelu popsaném døíve. </simpara> <simpara> Pokud trvalá spojení neposkytují žádnou pøidanou funkcionalitu, k èemu jsou dobrá? </simpara> <simpara> Odpovìï na tuto otázku je velmi jednoduchá - efektivita. Trvalá spojení jsou dobrá, pokud má tvorba spojení s vaším SQL serverem vysokou režii. Reálná výše této režie záleží na mnoha faktorech. Napøíklad jaký je to typ databáze, jestli sídlí na stejném poèítaèi jako vᚠwebserver, jak zatížený je stroj, na kterém vᚠSQL server bìží a tak dále. Pointa je, že pokud je spojovací režie vysoká, trvalá spojení vám znatelnì pomohou. Umožní dìtskému procesu pøipojit se pouze jednou za celý jeho životní cyklus místo každého zpracování stránky, která vyžaduje spojení s SQL serverem. To znamená, že každé dítì, které otevøelo trvalé spojení, bude mít otevøené vlastní trvalé spojení se serverem. Pokud napøíklad máte 20 dìtských procesù, které spustily skript, který otevøel trvalé spojení s vaším SQL serverem, máte 20 nezávislých spojení s SQL serverem, po jednom z každého dítìte. </simpara> <simpara> Všimnìte si nicménì, že to mùže mít nevýhody, pokud používate databázi s omezeným poètem pøipojení, který trvalá spojení dìtí pøekroèí. Pokud má vaše databáze limit 16 souèasných pøipojení, a v rušném okamžiku se pokusí pøipojit 17 dìtských procesù, jednomu se to nepodaøí. Pokud máte ve svých skriptech chyby, které brání zavírání spojení (napø. nekoneèné smyèky), databáze s pouhými 32 spojeními bude brzy zaplavena. Vyhledejte si v dokumentaci vaší databáze informace o obsluze opuštìných nebo neèinných spojení. </simpara> <simpara> Dùležitý souhrn. Trvalá spojení byla navržena tak, aby odpovídala jedna k jedné normálním spojením. To znamená, že byste <emphasis>vždy</emphasis> mìli být schopni nahradit trvalá spojení netrvalými beze zmìny fungování vašeho skriptu. <emphasis>Mùže</emphasis> to (a pravdìpodobnì bude) mít vliv na efektivitu tohoto skriptu, ale ne jeho chování! </simpara> </chapter> <!-- 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: --> Index: phpdoc/cs/features/remote-files.xml +++ phpdoc/cs/features/remote-files.xml <chapter id="features.remote-files"> <title>Použití vzdálených souborù</title> <para> Pokud pøi konfiguraci PHP aktivujete podporu &quot;URL fopen wrapper&quot; (standardnì je zapnutá, ledaže pro configure explicitnì zadáte <option>--disable-url-fopen-wrapper</option> pøíznak (verze do 4.0.3), nebo (u novìjších verzí) nastavíte <parameter>allow_url_fopen</parameter> v php.ini na off), mùžete ve voláních vìtšiny funkcí, které oèekávají jako argument název souboru (vèetnì <function>require</function> a <function>include</function>) uvést HTTP nebo FTP URL. </para> <para> <note> <para> Na Windows nelze používat vzdálené soubory v <function>include</function> a <function>require</function> výrazech. </para> </note> </para> <para> Mùžete napøíklad otevøít soubor na vzdáleném web serveru, vyseparovat z výstupu data, která potøebujete, a tato data potom použít v dotazu na databázi, nebo je prostì zaèlenit do výstupu stylem odpovídajícím zbytku vaší web site. </para> <para> <example> <title>Získání názvu vzdálené stránky</title> <programlisting role="php"> <![CDATA[ <?php $file = fopen ("http://www.php.net/", "r"); if (!$file) { echo "<p>Nelze otevøít vzdálený soubor.\n"; exit; } while (!feof ($file)) { $line = fgets ($file, 1024); /* Toto bude fungovat pouze pokud jsou tagy a název na jedné øádce */ if (eregi ("<title>(.*)</title>", $line, $out)) { $title = $out[1]; break; } } fclose($file); ?> ]]> </programlisting> </example> </para> <para> Pokud se pøipojíte jako uživatel s dostateènými právy, a daný soubor už neexistuje, mùžete data také ukládat po FTP. Pokud se chcete pøipojit jako jiný uživatel než 'anonymous', musíte v URL udat uživatelské jméno (a pravdìpodobnì i heslo), napø. 'ftp://uzivatel:heslo@ftp.example.com/path/to/file'. (Pro pøístup k souborùm pøes HTTP, které vyžadují Basic authentication, mùžete použít stejnou syntaxi.) </para> <para> <example> <title>Uložení dat na vzdáleném serveru</title> <programlisting role="php"> <![CDATA[ <?php $file = fopen ("ftp://ftp.php.net/incoming/outputfile", "w"); if (!$file) { echo "<p>Nelze otevøít vzdálený soubor pro zápis.\n"; exit; } /* Zapíšeme data. */ fputs ($file, "$HTTP_USER_AGENT\n"); fclose ($file); ?> ]]> </programlisting> </example> </para> <para> <note> <para> Z výše uvedeného pøíkladu by vás mohlo napadnout využít tuto techniku k zápisu do vzdáleného logu, ale jak už bylo zmínìno výše, pomocí URL fopen() wrapperu mùžete zapisovat pouze do nového souboru. Pokud máte zájem o distribuované logování, podívejte se na <function>syslog</function>. </para> </note> </para> </chapter> <!-- 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: -->
« previous php.doc (#969333904) next »