cvs: phpdoc /cs/features connection-handling.xml cookies.xml http-auth.xml images.xml persistent-connections.xml remote-files.xml
| From: | Roman Neuhauser | 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 moné stavy: <itemizedlist> <listitem><simpara>0 - NORMAL (normální)</simpara></listitem> <listitem><simpara>1 - ABORTED (zrueno)</simpara></listitem> <listitem><simpara>2 - TIMEOUT (vyprel è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 uivatel 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í vaeho skriptu. Nìkdy je uiteèné nechat skripty dobìhnout do konce, pøestoe 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í uivatele 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ý uivatel zmáèkne tlaèítko STOP, pøi dalím pokusu tohoto skriptu odeslat výstup PHP detekuje, e spojení bylo zrueno, 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ì, take pokud chcete po zruené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í zrueno. </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ì uivatelské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 povimnutí je, e stavy ABORTED a TIMEOUT mohou být aktivní souèasnì. Moné je to v pøípadì, e naøídíte PHP ignorovat odpojení uivatee. PHP i tak bude vìdìt, e uivatel pøeruil spojení, ale skript pobìí dál. Pokud potom dosáhne èasového limitu, bude ukonèen, a zavolá se vae funkce pro provedení pøi ukonèení skriptu, pokud existuje. V tomto okamiku 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ù. Take 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 uivatelù. 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> Vechny 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 vloení uivatelského jména a hesla. Jakmile uivatel 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 poslouit jako ukázka vyádání autentikace uivatele na stránce: <example> <title>Ukázka HTTP Autentikace</title> <programlisting role="php"> <?php if(!isset($PHP_AUTH_USER)) { Header("WWW-Authenticate: Basic realm=\"My Realm\""); Header("HTTP/1.0 401 Unauthorized"); echo "Text, který se odele, pokud uivatel zmáèkne tlaèítko Cancel\n"; exit; } else { echo "Ahoj $PHP_AUTH_USER.<P>"; echo "Jako heslo jsi zadal $PHP_AUTH_PW.<P>"; } ?> </programlisting> </example></para> <para> Místo protého vytitì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 uivatele 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 uivatele pouít promìnnou $REMOTE_USER. </simpara> <simpara> Vimnì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 uivatele v podstatì "odlogovat". Nìkteøí lidé toho vyuívají k "vyprení" pøihláení nebo tvorbì odhlaovacího tlaèítka. </simpara> <simpara></simpara> <example> <title>Ukázka HTTP autentikace vyadující nové jméno a heslo</title> <programlisting role="php"> <?php function authenticate() { Header( "WWW-authenticate: basic realm=\"Test Authentication System\""); Header( "HTTP/1.0 401 Unauthorized"); echo "K pøístupu na tento zdroj musíte zadat platné ID a heslo\n"; exit; } if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) { authenticate(); } else { echo "Welcome: $PHP_AUTH_USER<BR>"; echo "Old: $OldAuth"; echo "<FORM ACTION=\"$PHP_SELF\" METHOD=POST>\n"; echo "<INPUT TYPE=HIDDEN NAME=\"SeenBefore\" VALUE=\"1\">\n"; echo "<INPUT TYPE=HIDDEN NAME=\"OldAuth\" VALUE=\"$PHP_AUTH_USER\">\n"; echo "<INPUT TYPE=Submit VALUE=\"Re Authenticate\">\n"; echo "</FORM>\n"; } ?> </programlisting> </example> <simpara> Podle standardu HTTP Basic authentication se toto chování nevyaduje, take 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, take po stisknutí back a forward se znovu ukáe poadovaný zdroj (pokud se nezmìnily poadavky na údaje). </simpara> <simpara> Dále si vimnìte, e tato vlastnost pøi pouití 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 vyadovat 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"> <?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: <img src="button.php?text"> Skript button.php pak vezme øetìzec "text", pøekryje jím základní obrázek, co je v tomto pøípadì "images/button1.png" a zobrazí výsledný obrázek. Toto je vhodný zpùsob jak se vyhnout kreslení nového obrázku tlaèítka pokadé, 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 poadavku na trvalé spojení PHP nejdøíve zkontroluje, jestli u neexistuje identické spojení (které zùstalo otevøeno z døívìjka) - a pokud existuje, pouije ho. Pokud neexistuje, PHP ho otevøe. "Identické" spojení je spojení, které bylo otevøeno se stejným serverem, uivatelský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í "uivatelský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 moná s jejich netrvalými protìjky. </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 reimu se vytváøí a nièí jedna instance PHP interpretru pro kadý poadavek (na PHP strnánku) na vaem web serveru. Protoe je znièna po obslouení poadavku, vechny 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 pouití 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 mnoina, 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. Kadý poadavek, který pøijde od klienta, je obslouen jedním z dìtí, které právì neobsluhuje jiného klienta. To znamená, e kdy stejný klient vznese dalí poadavek na stejný server, tento mùe být obslouen jiným dìtským procesem ne ten první. Trvalá spojení zajiují, aby se kadý 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 vyaduje 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 jetì nefunguje jako plagin v ádném multithreadovém web serveru. Pracuje se na podpoøe ISAPI, WSAPI a NSAPI (na Windows), co umoní 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 reii. Reálná výe této reie 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í reie vysoká, trvalá spojení vám znatelnì pomohou. Umoní dìtskému procesu pøipojit se pouze jednou za celý jeho ivotní cyklus místo kadého zpracování stránky, která vyaduje spojení s SQL serverem. To znamená, e kadé 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 kadého dítìte. </simpara> <simpara> Vimnì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á vae databáze limit 16 souèasných pøipojení, a v runém okamiku 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 oputìných nebo neèinných spojení. </simpara> <simpara> Dùleitý souhrn. Trvalá spojení byla navrena tak, aby odpovídala jedna k jedné normálním spojením. To znamená, e byste <emphasis>vdy</emphasis> mìli být schopni nahradit trvalá spojení netrvalými beze zmìny fungování vaeho 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>Pouití vzdálených souborù</title> <para> Pokud pøi konfiguraci PHP aktivujete podporu "URL fopen wrapper" (standardnì je zapnutá, ledae 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ìtiny 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 uivatel 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ý uivatel ne 'anonymous', musíte v URL udat uivatelské 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é vyadují Basic authentication, mùete pouít stejnou syntaxi.) </para> <para> <example> <title>Uloení 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: -->
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 moné stavy: <itemizedlist> <listitem><simpara>0 - NORMAL (normální)</simpara></listitem> <listitem><simpara>1 - ABORTED (zrueno)</simpara></listitem> <listitem><simpara>2 - TIMEOUT (vyprel è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 uivatel 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í vaeho skriptu. Nìkdy je uiteèné nechat skripty dobìhnout do konce, pøestoe 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í uivatele 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ý uivatel zmáèkne tlaèítko STOP, pøi dalím pokusu tohoto skriptu odeslat výstup PHP detekuje, e spojení bylo zrueno, 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ì, take pokud chcete po zruené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í zrueno. </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ì uivatelské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 povimnutí je, e stavy ABORTED a TIMEOUT mohou být aktivní souèasnì. Moné je to v pøípadì, e naøídíte PHP ignorovat odpojení uivatee. PHP i tak bude vìdìt, e uivatel pøeruil spojení, ale skript pobìí dál. Pokud potom dosáhne èasového limitu, bude ukonèen, a zavolá se vae funkce pro provedení pøi ukonèení skriptu, pokud existuje. V tomto okamiku 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ù. Take 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 uivatelù. 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> Vechny 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 vloení uivatelského jména a hesla. Jakmile uivatel 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 poslouit jako ukázka vyádání autentikace uivatele na stránce: <example> <title>Ukázka HTTP Autentikace</title> <programlisting role="php"> <?php if(!isset($PHP_AUTH_USER)) { Header("WWW-Authenticate: Basic realm=\"My Realm\""); Header("HTTP/1.0 401 Unauthorized"); echo "Text, který se odele, pokud uivatel zmáèkne tlaèítko Cancel\n"; exit; } else { echo "Ahoj $PHP_AUTH_USER.<P>"; echo "Jako heslo jsi zadal $PHP_AUTH_PW.<P>"; } ?> </programlisting> </example></para> <para> Místo protého vytitì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 uivatele 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 uivatele pouít promìnnou $REMOTE_USER. </simpara> <simpara> Vimnì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 uivatele v podstatì "odlogovat". Nìkteøí lidé toho vyuívají k "vyprení" pøihláení nebo tvorbì odhlaovacího tlaèítka. </simpara> <simpara></simpara> <example> <title>Ukázka HTTP autentikace vyadující nové jméno a heslo</title> <programlisting role="php"> <?php function authenticate() { Header( "WWW-authenticate: basic realm=\"Test Authentication System\""); Header( "HTTP/1.0 401 Unauthorized"); echo "K pøístupu na tento zdroj musíte zadat platné ID a heslo\n"; exit; } if(!isset($PHP_AUTH_USER) || ($SeenBefore == 1 && !strcmp($OldAuth, $PHP_AUTH_USER)) ) { authenticate(); } else { echo "Welcome: $PHP_AUTH_USER<BR>"; echo "Old: $OldAuth"; echo "<FORM ACTION=\"$PHP_SELF\" METHOD=POST>\n"; echo "<INPUT TYPE=HIDDEN NAME=\"SeenBefore\" VALUE=\"1\">\n"; echo "<INPUT TYPE=HIDDEN NAME=\"OldAuth\" VALUE=\"$PHP_AUTH_USER\">\n"; echo "<INPUT TYPE=Submit VALUE=\"Re Authenticate\">\n"; echo "</FORM>\n"; } ?> </programlisting> </example> <simpara> Podle standardu HTTP Basic authentication se toto chování nevyaduje, take 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, take po stisknutí back a forward se znovu ukáe poadovaný zdroj (pokud se nezmìnily poadavky na údaje). </simpara> <simpara> Dále si vimnìte, e tato vlastnost pøi pouití 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 vyadovat 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"> <?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: <img src="button.php?text"> Skript button.php pak vezme øetìzec "text", pøekryje jím základní obrázek, co je v tomto pøípadì "images/button1.png" a zobrazí výsledný obrázek. Toto je vhodný zpùsob jak se vyhnout kreslení nového obrázku tlaèítka pokadé, 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 poadavku na trvalé spojení PHP nejdøíve zkontroluje, jestli u neexistuje identické spojení (které zùstalo otevøeno z døívìjka) - a pokud existuje, pouije ho. Pokud neexistuje, PHP ho otevøe. "Identické" spojení je spojení, které bylo otevøeno se stejným serverem, uivatelský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í "uivatelský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 moná s jejich netrvalými protìjky. </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 reimu se vytváøí a nièí jedna instance PHP interpretru pro kadý poadavek (na PHP strnánku) na vaem web serveru. Protoe je znièna po obslouení poadavku, vechny 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 pouití 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 mnoina, 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. Kadý poadavek, který pøijde od klienta, je obslouen jedním z dìtí, které právì neobsluhuje jiného klienta. To znamená, e kdy stejný klient vznese dalí poadavek na stejný server, tento mùe být obslouen jiným dìtským procesem ne ten první. Trvalá spojení zajiují, aby se kadý 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 vyaduje 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 jetì nefunguje jako plagin v ádném multithreadovém web serveru. Pracuje se na podpoøe ISAPI, WSAPI a NSAPI (na Windows), co umoní 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 reii. Reálná výe této reie 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í reie vysoká, trvalá spojení vám znatelnì pomohou. Umoní dìtskému procesu pøipojit se pouze jednou za celý jeho ivotní cyklus místo kadého zpracování stránky, která vyaduje spojení s SQL serverem. To znamená, e kadé 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 kadého dítìte. </simpara> <simpara> Vimnì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á vae databáze limit 16 souèasných pøipojení, a v runém okamiku 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 oputìných nebo neèinných spojení. </simpara> <simpara> Dùleitý souhrn. Trvalá spojení byla navrena tak, aby odpovídala jedna k jedné normálním spojením. To znamená, e byste <emphasis>vdy</emphasis> mìli být schopni nahradit trvalá spojení netrvalými beze zmìny fungování vaeho 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>Pouití vzdálených souborù</title> <para> Pokud pøi konfiguraci PHP aktivujete podporu "URL fopen wrapper" (standardnì je zapnutá, ledae 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ìtiny 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 uivatel 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ý uivatel ne 'anonymous', musíte v URL udat uivatelské 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é vyadují Basic authentication, mùete pouít stejnou syntaxi.) </para> <para> <example> <title>Uloení 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: -->