cvs: phpdoc-hu /language variables.xml
| From: | Bagi Levente L�szl� | Date: | Fri, 09 Jul 2004 11:43:49 +0000 |
| Subject: | cvs: phpdoc-hu /language variables.xml | ||
| Groups: | php.doc.hu | ||
| Request: | Send a blank email to doc-hu+get-668@lists.php.net to get a copy of this message | ||
bagilevi Fri Jul 9 07:43:49 2004 EDT
Modified files:
/phpdoc-hu/language variables.xml
Log:
Sync with EN-Revision
http://cvs.php.net/diff.php/phpdoc-hu/language/variables.xml?r1=1.24&r2=1.25&ty=u Index: phpdoc-hu/language/variables.xml diff -u phpdoc-hu/language/variables.xml:1.24 phpdoc-hu/language/variables.xml:1.25 --- phpdoc-hu/language/variables.xml:1.24 Sun Jun 13 04:30:44 2004 +++ phpdoc-hu/language/variables.xml Fri Jul 9 07:43:49 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: goba Status: ready --> -<!-- CREDITS: kgergely,gerzson --> +<!-- EN-Revision: 1.78 Maintainer: goba Status: ready --> +<!-- CREDITS: kgergely,gerzson,bagilevi --> <chapter id="language.variables"> <title>Változók</title> @@ -33,14 +33,16 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $var = "Géza"; $Var = "János"; echo "$var, $Var"; // kiírja, hogy "Géza, János" $4site = 'ez nem jó'; // nem érvényes, mert számmal kezdõdik $_4site = 'ez ok'; // érvényes, aláhúzással kezdõdik -$täyte = 'mansikka'; // érvényes, az 'ä' az ASCII 228-as karaktere +$täyte = 'mansikka'; // érvényes, az 'ä' a kiterjesztett ASCII 228-as karaktere $tükörfúrógép = "árvíztûrõ"; // érvényes, ellenõrizheted egy ASCII táblában +?> ]]> </programlisting> </informalexample> @@ -57,14 +59,17 @@ </para> <para> PHP 4-ben lehetõség van egy másik hozzárendelési módra: - <emphasis>változó referencia szerinti hozzárendelésére</emphasis>. + <link linkend="language.references">változó referencia szerinti + hozzárendelésére</link>. Ez azt jelenti, hogy az új változó egyszerûen hivatkozik (más szóval "alias lesz", vagy "rá mutat") az eredetire. Az új változón végzett változtatások az eredetit is érintik és fordítva. Ez azt is jelenti, hogy nem történik másolás; ekképpen a hozzárendelés gyorsabban történik meg. Igaz ugyan, hogy ez a sebességnövekedés csak "feszes" ciklusokban vagy - nagy tömböknél ill. objektumok átadásakor jelentkezik. + nagy <link linkend="language.types.array">tömböknél</link> ill. <link + linkend="language.types.object">objektumok</link> átadásakor + jelentkezik. </para> <para> Referencia szerinti értékadáshoz egyszerûen & jelet kell @@ -78,8 +83,8 @@ $ize = 'Bob'; // 'Bob' hozzárendelése $ize-hoz $bigyo = &$ize; // Hivatkozás $ize-ra $bigyo-ban. $bigyo = "Nevem $bigyo"; // $bigyo megváltoztatása... -echo $ize; // $ize is megváltozott echo $bigyo; +echo $ize; // $ize is megváltozott ?> ]]> </programlisting> @@ -117,587 +122,232 @@ <simpara> A PHP egy számos elõre definiált változót biztosít az bármely futó szkript számára. Sokat ezek közül nem lehet teljes pontossságal - dokumentálni, mert függnek a a futtató szervertõl, a használt verziótól, - a konfigurálástól, és más gyéb tényezõktõl. Néhány ilyen változó nem - elérhetõ, ha a PHP parancssorból fut. - </simpara> - <simpara> - E tényezõk ellenére az alábbi listában azok az elõre definiált - változók vannak felsorolva, amelyek a PHP 3 tipikus installálásakor elérhetõk - az <ulink url="&url.apache;">Apache</ulink> 1.3.6-ot használva. - </simpara> - <simpara> - Az összes elõre definiált változó kilistázható, és sok más hasznos - információt is közöl a <function>phpinfo</function>. + dokumentálni, mert függnek a a futtató szervertõl, a használt + verziótól, + a konfigurálástól, és egyéb tényezõktõl. Néhány ilyen változó nem + elérhetõ, ha a PHP + <link linkend="features.commandline">parancssorból</link> fut. + Ezen változókról találsz egy listát + <link linkend="reserved.variables">Fenntartott elõredefiniált + változók</link> c. részben. </simpara> - <note> + <warning> <simpara> - Ez a lista nem teljes, nem is ez a célja. Ez csak - egy útmutató arról, hogy milyen típusú elõre - definiált változók lehetnek. + A PHP 4.2.0 és késõbbi verzióiban a <link + linkend="ini.register-globals">register_globals</link> direktíva + alapértelmezett értéke <emphasis>off</emphasis>. Ez a PHP-nek egy + jelentõs + változása. A register_globals <emphasis>off</emphasis>-ra állítása + befolyásolja az elõredefiniált változók készletét a globális + hatáskörben. + Például a <varname>DOCUMENT_ROOT</varname> lekéréséhez a + <varname>$_SERVER['DOCUMENT_ROOT']</varname> formát kell használnod + <varname>$DOCUMENT_ROOT</varname> helyett, vagy + <literal>http://www.pelda.hu/teszt.php?id=3</literal> URL esetén + <varname>$_GET['id']</varname>-t az <varname>$id</varname> helyett, + vagy + <varname>$_ENV['HOME']</varname> alakot a <varname>$HOME</varname> + helyett. </simpara> - </note> - - <sect2 id="language.variables.predefined.apache"> - <title>Apache változók</title> - <simpara> - Ezek a változók az <ulink url="&url.apache;">Apache</ulink> - webszerver változói. Ha másik szerveren fut a PHP, nincs rá - garancia, hogy ugyanezek a változók akkor is rendelkezésre állnak: - némelyik hiányozhat, esetleg itt nem szereplõket is biztosíthat - a szerver. Számos a <ulink url="&url.cgispec;">CGI 1.1 - specifikációban</ulink> dokumentált változókra biztosan lehet alapozni. + Több információért olvasd el a <link + linkend="ini.register-globals">register_globals</link>-ról szóló + bejegyzést, a biztonságról szóló fejezetben a <link + linkend="security.globals">Register Globals használatáról</link> + szóló + részt, valamint a PHP <ulink url="&url.php.release4.1.0;">4.1.0 + </ulink> és <ulink url="&url.php.release4.2.0;">4.2.0</ulink> + verzióinak bejelentését. </simpara> <simpara> - Figyelni kell arra, hogy ha a PHP parancssorból (command line) használva - a változók töredékének van csak értelme, ha egyáltalán definiáltak ilyen - esetben. + A PHP-ben rendelkezésre álló fenntartott elõredefiniált változók, + mint + például a <link + linkend="language.variables.superglobals">szuperglobális + tömbök</link> használata ajánlottabb. </simpara> + </warning> + + <simpara> + A 4.1.0-s verziótól a PHP további elõredefiniált tömböket biztosít, + amelyek + webszerverektõl (ha van), környezetbõl, és felhasználótól származó + változókat tartalmaznak. Ezek az új tömbök elég sajátosak, mivel + automatikusan globálisak, azaz automatikusan rendelkezésre állnak + minden + hatáskörben. Ezért gyakran nevezik ezeket 'autoglobálisn' vagy + 'szuperglobális' tömböknek. (A felhasználónak nincs lehetõsége + szuperglobális változók definiálására.) A szuperglobális tömbök alább + vannak + felsorolva; viszont a PHP elõredefiniált változóinak tartalma és + természetüknek tárgyalása a <link + linkend="reserved.variables">Fenntartott + elõredefiniált változók</link> címû részben olvasható, ahol a régebbi + elõredefiniált változók (<varname>$HTTP_*_VARS</varname>) létezésérõl + is + tudomást szerezhetsz. + &avail.register-long-arrays; + </simpara> + + <note> + <title>Változó változók</title> <para> - <variablelist> - <varlistentry> - <term>$GATEWAY_INTERFACE</term> - <listitem> - <simpara> - A server CGI specifikációjának verziója. Pl.: 'CGI/1.1'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_NAME</term> - <listitem> - <simpara> - A gazdagép (host) neve, ami alatt a szkript fut. Ha - a szkript virtuális host-on fut, a virtuális host neve. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_SOFTWARE</term> - <listitem> - <simpara> - Serverazonosító sztring, amely a kérésekre (request) adott válasz (response) - fejlécében (header) szerepel. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_PROTOCOL</term> - <listitem> - <simpara> - Az oldal lekéréséhez használt protokoll neve - és verziója pl. 'HTTP/1.0' - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REQUEST_METHOD</term> - <listitem> - <simpara> - Az oldal eléréséhez használt kérési forma, pl.: 'GET', 'HEAD', 'POST', 'PUT'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$QUERY_STRING</term> - <listitem> - <simpara> - Keresési kérdés, az oldalt meghívó URL-ben a ? után szereplõ rész, ha létezik. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$DOCUMENT_ROOT</term> - <listitem> - <simpara> - A www dokumentumok fõkönyvtára, amely alatt a jelenlegi - szkript fut. Ez a szerver konfigurációs fájljában - meghatározott érték. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept:</literal> HTTP fejlécének - tartalma, ha van ilyen. Ebben adja meg a böngészõ, hogy milyen - formátumokat képes fogadni. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_CHARSET</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Charset:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'iso-8859-1,*,utf-8'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_ENCODING</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Encoding:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'gzip'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_LANGUAGE</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Language:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'en'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_CONNECTION</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Connection:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'Keep-Alive'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_HOST</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Host:</literal> HTTP fejlécének tartalma, - ha éppen van ilyen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_REFERER</term> - <listitem> - <simpara> - Annak az oldalnak az URL címe, ahonnan ide - került a látogató. Ezt a látogató böngészõprogramja - állítja be, de ezt nem minden böngészõ és nem mindig - teszi meg. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_USER_AGENT</term> - <listitem> - <simpara> - Az aktuális <literal>User_Agent:</literal> HTTP fejlécének tartalma, - ha van ilyen. Ez a string, amely meghatározza - az oldal megtekintéséhez használt böngészõt, pl. - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux - 2.2.9 i586)</computeroutput>. Sok más mellett - ezt az értéket a fel lehet használni arra, hogy a - <function>get_browser</function> fügvénnyel - az aktuális böngészõ képességeinek megfelelõen lehessen - kialakítani az oldal megjelenését. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REMOTE_ADDR</term> - <listitem> - <simpara> - Az az IP cím, ahonnan a látogató az oldalt lekérte. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REMOTE_PORT</term> - <listitem> - <simpara> - A látogató gépén a webszerverrel való kommunikációhoz - használt port száma. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SCRIPT_FILENAME</term> - <listitem> - <simpara> - A PHP szkript abszolút elérési útja a szerver gépen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_ADMIN</term> - <listitem> - <simpara> - A SERVER_ADMIN a kiszolgáló konfigurációs fájl direktíva - értéke (Apache alatt). Ha a szkript egy virtuális - host-on fut, akkor ez a virtuális host-hoz rendelt - érték. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_PORT</term> - <listitem> - <simpara> - A kiszolgálógépen a kiszolgáló kommunikációjában - használt port száma. Alapértelmezés szerint ez a '80', - de például SSL-t használva ez a biztonságos - HTTP portnak a száma lesz. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_SIGNATURE</term> - <listitem> - <simpara> - A kiszolgáló verziószámát és a virtuális - host-ot tartalmazó sztring, ha engedélyezett. - Ez a szöveg jelenik meg minden szerver által generált oldal alján. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PATH_INFO</term> - <listitem> - <simpara> - Hasonló értéket tartalmaz, mint a SCRIPT_NAME, de - CGI verzió esetén ez jobb lehet az önhivatkozó - kérdõívek készítésekor, mert egyes szervereken - a SCRIPT_NAME tartalmazza a PHP bináris meghívási útvonalát is. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PATH_TRANSLATED</term> - <listitem> - <simpara> - A szkript a fájlrendszer szerinti (nem a document root-hoz - viszonyított!) elérési útja. Ezt a kiszolgáló a virtuális->valós - átalakítás után határozza meg. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SCRIPT_NAME</term> - <listitem> - <simpara> - Az aktuális szkript elérési útja, ahogy az az URL-ben - megjelenik. Hasznos a saját magukra mutató oldalakhoz. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REQUEST_URI</term> - <listitem> - <simpara> - Az az URI, amellyel az oldalt lekérték. pl. '/index.html'. - </simpara> - </listitem> - </varlistentry> - </variablelist> + A szuperglobális változók nem használhatók + <link linkend="language.variables.variable">változó + változókként</link> + függvényekben és osztályok metódusaiban. </para> + </note> - </sect2> - - <sect2 id="language.variables.predefined.environment"> - <title>Környezeti változók</title> - - <simpara> - A PHP globális változói közé kerülnek a PHP feldolgozót - futtató környezet változói. Számos változót a shell - szolgáltat, ami alatt a PHP fut. Mivel más-más rendszerek - más-más shell-eket használnak, ezért egy pontos lista - összeállítása lehetetlen. A használt shell dokumentációjában - nézz utána az elõre definiált környezeti változóknak! - </simpara> - <simpara> - Más környezeti változók - beleértve a CGI változókat is - - attól függõen kerülnek be, hogy a PHP szerver - modulként fut vagy CGI feldolgozóként. - </simpara> - - </sect2> - - <sect2 id="language.variables.predefined.php"> - <title>PHP változók</title> - - <simpara> - Ezeket a PHP maga állítja elõ. A <varname>$HTTP_*_VARS</varname> - változók csak akkor állnak rendelkezésre, ha a - <link linkend="ini.track-vars">track_vars</link> - be van kapcsolva. Ha engedélyezted ezt a beállítást, - ezek a változók mindig létrejönnek, még ha üresek is. - Ez nem engedi a rosszindulatú felhasználóknak, hogy - meghamasítsák a változókat. - </simpara> - - <note> - <para> - A PHP 4.0.3 verziótól kezdve a <link - linkend="ini.track-vars">track_vars</link> mindig be van kapcsolva, - függetlenül a konfigurációs fájl beállításától. - </para> - </note> - - <note> - <para> - Az új szuper globális (Superglobals) változók 4.1.0 verziótól - használhatók. További részletekért lásd a <ulink - url="&url.php.release4.1.0;">4.1.0 verzió bejelentését</ulink> - Ezek a <varname>$_GET</varname>, <varname>$_POST</varname>, - <varname>$_ENV</varname>, <varname>$_SERVER</varname>, - <varname>$_COOKIE</varname>, <varname>$_REQUEST</varname> - <varname>$_FILES</varname> és a <varname>$_SESSION</varname> - tömbök, amelyek fesztelen megfogalmazásban <emphasis>szuper - globális</emphasis> jelzõvel illetik, mivel minden esetben - használhatók tekintet nélkül az aktuális érvényességi körre. - Emiatt a régi, nekik megfelelõ <varname>$HTTP_*_VARS</varname> - tömbök használata már nem javasolt. - </para> - </note> + <note> <para> - Ha a <link - linkend="ini.register-globals">register_globals</link> be van kapcsolva, - ezek a változók globális változókként is létrejönnek, függetlenül - a <varname>$HTTP_*_VARS</varname> tömböktõl. Nézd meg idevonatkozó - részletes információkért a biztonságról szóló <link - linkend="security.globals">Globálisan is elérhetõ változók - (Register Globals) használata</link> c. fejezetet! + Annak ellenére, hogy egyidõben létezhet a szuperglobális és a + HTTP_*_VARS + tömb, ezen nem azonosak, tehát az egyiknek a módosítása nem + változtatja + meg a másikat is. </para> + </note> - <para> - <variablelist> - <varlistentry> - <term>$argv</term> - <listitem> - <simpara> - A szkriptnek átadott argumentumok tömbje. Ha a szkript - parancssor alól futtatjuk, ez egy C-szerû hozzáférést - biztosít a parancssor argumentumokhoz. Ha GET - metódussal hívjuk, az URL kérdõjel utáni részét - (query string) tartalmazza. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$argc</term> - <listitem> - <simpara> - A parancssori argumentumok számát tartalmazza - (ha parancssorból futtatjuk). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PHP_SELF</term> - <listitem> - <simpara> - A most futó szkriptfájl neve, a document root-hoz - képest relatív alakban. Ha a PHP parancssorból - fut, ez a változó nem elérhetõ. Ez a változó - a kérés útvonal információját is tartalmazza, ha az - létezik, azaz a $PHP_SELF a "http://example.com/test.php/foo.bar" - címre a következõt fogja adni: "/test.php/foo.bar" - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_COOKIE_VARS</term> - <listitem> - <simpara> - HTTP cookie-kat (sütiket) tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_COOKIE</term> - <listitem> - <simpara> - HTTP cookie-kat (sütiket) tartalmazó asszociatív tömb, amely - minden hatókörben elérhetõ. PHP 4.1.0-ban került - a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_GET_VARS</term> - <listitem> - <simpara> - HTTP GET metódussal által szolgáltatott adatokat tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_GET</term> - <listitem> - <simpara> - HTTP GET metódussal által szolgáltatott adatokat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_POST_VARS</term> - <listitem> - <simpara> - HTTP POST metódussal által szolgáltatott adatokat tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_POST</term> - <listitem> - <simpara> - HTTP POST metódussal által szolgáltatott adatokat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_POST_FILES</term> - <listitem> - <simpara> - A HTTP POST metódussal feltöltött fájlokról tartalmaz információkat, asszociatív tömb. - Lásd a <link linkend="features.file-upload.post-method">POST metódusú - feltöltések</link> címû részt további információkért a - <varname>$HTTP_POST_FILES</varname> tartalmát és szerkezetét illetõen. - PHP 4.0.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_FILES</term> - <listitem> - <simpara> - A HTTP POST metódussal feltöltött fájlokról tartalmaz információkat, asszociatív tömb. - Lásd a <link linkend="features.file-upload.post-method">POST metódusú - feltöltések</link> címû részt további információkért a - <varname>$_POST</varname> tartalmát és szerkezetét illetõen. - Minden hatókörben elérhetõ. PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> + <para> + Ha bizonyos változók nincsenek megjelölve a <link + linkend="ini.variables-order">variables_order</link>-ben akkor a + megfelelõ + PHP elõredefiniált tömbök üresek. + </para> + <variablelist id="language.variables.superglobals"> + <title>PHP szuperglobális változók</title> <varlistentry> - <term>$HTTP_ENV_VARS</term> - <listitem> - <simpara> - A szülõ/futtató környezet aktuális változóit tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_ENV</term> - <listitem> - <simpara> - A szülõ/futtató környezet aktuális változóit tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - + <term><link + linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Minden olyan változóhoz tartalmaz egy referenciát, amely + pillanatnyilag + a szkript globális hatáskörében létezik. Ennek a tömbnek a kulcsai + a globális változók nevei. A <varname>$GLOBALS</varname> tömb a + PHP 3-tól létezik. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Olyan változók amelyeket a webszerver állított be vagy amelyek + szorosan összefüggenek a szkript futtatási környezetével. + Analógiája a régebbi <varname>$HTTP_SERVER_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + HTTP GET kérés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_GET_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + HTTP POST kérés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_POST_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> <varlistentry> - <term>$HTTP_SERVER_VARS</term> - <listitem> - <simpara> - A HTTP szervertõl érkezõ változókkal feltöltött asszociatív tömb. - Ezek a változók megfelelnek a fent említett Apache változóknak. - </simpara> - </listitem> - </varlistentry> - </variablelist> - - <variablelist> - <varlistentry> - <term>$_SERVER</term> - <listitem> + <term><link + linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + HTTP sütikbõl (cookie) származó változók. + Analógiája a régebbi <varname>$HTTP_COOKIE_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + HTTP post fájlfeltöltés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_POST_FILES</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + További információ a + <link linkend="features.file-upload.post-method">POST típusú + fájlfeltöltésrõl szóló fejezetben</link>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + A környezetbõl származó változók. + Analógiája a régebbi <varname>$HTTP_ENV_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + HTTP GET, POST és COOKIE bementekbõl származó változók, azaz + amelyekben nem lehet megbízni. A jelenléte és a változók tömbbe + való besorolásának sorrendje + a PHP <link linkend="ini.variables-order">variables_order</link> + konfigurációs direktívája szerint van definiálva. Ennek nincs + közvetlen + analógiája a PHP 4.1.0-nál elõbbi verzióiban. + Lásd még: <function>import_request_variables</function>. + </simpara> + <caution> <simpara> - A HTTP szervertõl érkezõ változókkal feltöltött asszociatív tömb, - amely minden hatókörben elérhetõ. PHP 4.1.0-ban került - a nyelvbe. + A PHP 4.3.0 óta a <varname>$_FILES</varname>-ban szereplõ + fájlinformációk nem szerepelnek a + <varname>$_REQUEST</varname>-ben. </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_SESSION_VARS</term> - <listitem> - <simpara> - Az aktuális szkripthez tartozó session változókat tartalmazó - asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_SESSION</term> - <listitem> - <simpara> - Az aktuális szkripthez tartozó session változókat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. A - <varname>_SESSION</varname> tömbben új bejegyzések létrehozásával - automatikusan regisztrálhatók értékek, mint a - <function>session_register</function> segítségével. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_REQUEST</term> - <listitem> + </caution> + <note> <simpara> - A GET, POST és Cookie változókból összeállított asszociatív tömb. - Más szóval, bármilyen a felhasználótól ügyféltõl érkezõ adatot - tartalmaz, ami biztonsági szempontból nem megbízható. - Minden hatókörben elérhetõ. PHP 4.1.0-ban került a nyelvbe. + <link linkend="features.commandline">Parancssori</link> futtatás + esetén ez <emphasis>nem</emphasis> tartalmazza az + <varname>argv</varname> and <varname>argc</varname> bejegyzéseket; + ezek a <varname>$_SERVER</varname> tömbben szerepelnek. </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Olyan változók, amelyek a szkript munkamanetéhez vannak rendelve. + Analógiája a régebbi <varname>$HTTP_SESSION_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + További információért lásd a <link + linkend="ref.session">Munkamenet kezelõ függvények</link> címû + részt. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect1> @@ -718,8 +368,10 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = 1; include "b.inc"; +?> ]]> </programlisting> </informalexample> @@ -735,6 +387,7 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = 1; /* globális hatáskör */ function Test () @@ -743,6 +396,7 @@ } Test(); +?> ]]> </programlisting> </informalexample> @@ -757,13 +411,20 @@ ha a függvényben újra nem definiáltad azt a változót. Ez problémák forrása lehet, ha az ember véletlenül megváltoztat egy globális változót. A PHP-ben a globális - változókat global kulcsszóval kell deklarálni a függvényekben, - például: + változókat global kulcsszóval kell deklarálni a függvényekben. </simpara> - <informalexample> - <programlisting role="php"> + <sect2 id="language.variables.scope.global"> + <title>A global kulcsszó</title> + <simpara> + Elõször nézzünk egy példát a <literal>global</literal> használatára: + </simpara> + <para> + <example> + <title>A global használata</title> + <programlisting role="php"> <![CDATA[ +<?php $a = 1; $b = 2; @@ -776,9 +437,11 @@ Ossszead(); echo $b; +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> A fenti szkript kiírja, hogy "3". <varname>$a</varname> @@ -789,13 +452,17 @@ <simpara> Globális változók elérésének másik módja a PHP által - definiált speciális <varname>$GLOBALS</varname> tömb használata. Az elõbbi - példával egyenértékû megoldás: + definiált speciális <varname>$GLOBALS</varname> tömb használata. Az + elõbbi példával egyenértékû megoldás: </simpara> - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>A <varname>$GLOBALS</varname> használata global + helyett</title> + <programlisting role="php"> <![CDATA[ +<?php $a = 1; $b = 2; @@ -806,16 +473,53 @@ Osszead(); echo $b; +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> A <varname>$GLOBALS</varname> asszociatív tömb, ahol a globális változó neve jelenti a kulcsot, és a változó értéke a tömbelem értéke. + Vedd észre, hogy a <varname>$GLOBALS</varname> tömb minden + hatáskörben létezik, mivel a $GLOBALS egy <link + linkend="language.variables.superglobals">szuperglobális + változó</link>. + A következõ példa a szuperglobális változók erejét szemlélteti. </simpara> + <para> + <example> + <title>Példa szuperglobális változók és a hatáskör + szemléltetésére</title> + <programlisting role="php"> +<![CDATA[ +<?php +function global_teszt() +{ + // A legtöbb elõredefiniált változó nem "szuper" és + // megkövetelik a 'global' használatát, hogy elérhetõek + // legyenek függvények helyi hatáskörében. + global $HTTP_POST_VARS; + + echo $HTTP_POST_VARS['nev']; + + // A szuperglobális változók elérhetõek bármilyen + // hatáskörben, és nem szükséges a 'global' kulcsszó. + // A szuperglobális változók a PHP 4.1.0-tõl használhatóak. + echo $_POST['nev']; +} +?> +]]> + </programlisting> + </example> + </para> + </sect2> + + <sect2 id="language.variables.scope.static"> + <title>Statikus változók használata</title> <simpara> A változók hatáskörének másik fontos lehetõsége a <emphasis>static</emphasis> (statikus) változó. A statikus @@ -823,19 +527,24 @@ belül, de két függvényhívás közt nem veszti el az értékét, a változó hatáskörébõl való kilépés esetén is megmarad az értéke: </simpara> + <para> + <example> + <title>Statikus változók szükségességét szemléltetõ példa</title> + <programlisting role="php"> - <informalexample> - <programlisting role="php"> <![CDATA[ +<?php function Test() { $a = 0; echo $a; $a++; } +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> Ez nagyon haszontalan függvény, mivel nem csinál mást, @@ -847,20 +556,23 @@ legyen - megmaradjon a számláló értéke -, az <varname>$a</varname> változót statikusnak kell deklarálni: </simpara> - - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>Példa statikus változók használatára</title> + <programlisting role="php"> <![CDATA[ +<?php function Test() { static $a = 0; echo $a; $a++; } +?> ]]> - </programlisting> - </informalexample> - + </programlisting> + </example> + </para> <simpara> Most már valahányszor meghívódik a Test() függvény, kiírja <varname>$a</varname> értékét, majd azt megnöveli eggyel. @@ -870,17 +582,21 @@ A statikus változókat a rekurzív függvények megvalósításában is felhasználhatjuk. Rekurzívnak nevezzük azt a függvényt, amely saját magát hívja meg. Ezt természetesen feltételhez kell kötni, - nehogy végtelen rekurzióba kerüljön a vezérlés és meghatározatlan idõre - a függvényen belül csapdába esik. Mindig meg kell bizonyosodni arról, hogy + nehogy végtelen rekurzióba kerüljön a vezérlés és meghatározatlan + idõre a függvényen belül csapdába esik. Mindig meg kell bizonyosodni + arról, hogy megfelelõ feltétel rendelkezésre áll a rekurzió befejezéséhez. A következõ függvény rekurzívan elszámol 10-ig a statikus <varname>$count</varname> változó segítségével: [A static kulcsszó nagyon fontos!] </simpara> - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>Statikus változók rekurzív függvényekkel</title> + <programlisting role="php"> <![CDATA[ +<?php function Test() { static $count = 0; @@ -892,10 +608,154 @@ } $count--; } +?> +]]> + </programlisting> + </example> + </para> + + <note> + <para> + Statikus változókat a fenti példákban szereplõ módon lehet + deklarálni. Ha olyan értéket próbálsz értékül adni neki, amely egy + kifejezés eredménye, az parse error-t fog okozni. + </para> + <para> + <example> + <title>Statikus változók deklarálása</title> + <programlisting role="php"> +<![CDATA[ +<?php +function ize(){ + static $int = 0; // jó + static $int = 1+2; // rossz (mivel ez egy kifejezés) + static $int = sqrt(121); // rossz (szintén kifejezés) + + $int++; + echo $int; +} +?> +]]> + </programlisting> + </example> + </para> + </note> + </sect2> + + <sect2 id="language.variables.scope.references"> + <title>Referenciák globális és statikus változókkal</title> + <simpara> + A <literal>PHP 4</literal>-et mûködtetõ Zend Engine 1, a <link + linkend="language.variables.scope.static">statikus</link> és <link + linkend="language.variables.scope.global">globális</link> változó + módosítókat <link linkend="language.references"> + referenciákkal</link> implementálja. Például egy valódi globális + változó beemelve egy függvény hatáskörébe a <literal>global</literal> + utasítással tulajdonképpen létrehoz egy referenciát a globális + változóhoz. Ez váratlan viselkedésmódhoz vezethet, amelyet a következõ + példa illusztrál: + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function test_global_ref() { + global $obj; + $obj = &new stdclass; +} + +function test_global_noref() { + global $obj; + $obj = new stdclass; +} + +test_global_ref(); +var_dump($obj); +test_global_noref(); +var_dump($obj); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + A példában szereplõ kód végrahajtása a következõ kimenetet produkálja: + </simpara> + + <screen> +NULL +object(stdClass)(0) { +} + </screen> + + <simpara> + Hasonló viselkedésmód jellemzi a <literal>static</literal> utasítást. + A referenciák nem statikusan vannak tárolva: + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function &get_instance_ref() { + static $obj; + + echo "Statikus objektum: "; + var_dump($obj); + if (!isset($obj)) { + // Hozzárendel egy referenciát a statikus változóhoz + $obj = &new stdclass; + } + $obj->property++; + return $obj; +} + +function &get_instance_noref() { + static $obj; + + echo "Statikus objektum: "; + var_dump($obj); + if (!isset($obj)) { + // Hozzárendeli az objektumot a statikus változóhoz + $obj = new stdclass; + } + $obj->property++; + return $obj; +} + +$obj1 = get_instance_ref(); +$still_obj1 = get_instance_ref(); +echo "\n"; +$obj2 = get_instance_noref(); +$still_obj2 = get_instance_noref(); +?> ]]> </programlisting> </informalexample> + <simpara> + A példa végrehajtása a következõ kimenetet eredményezi: + </simpara> + + <screen> +Statikus objektum: NULL +Statikus objektum: NULL + +Statikus objektum: NULL +Statikus objektum: object(stdClass)(1) { + ["property"]=> + int(1) +} + </screen> + + <simpara> + A példa azt szemlélteti, hogy amikor hozzárendelsz egy referenciát egy + statikus változóhoz, az nem <emphasis>lesz megjegyezve</emphasis> + amikor újra meghívod a <literal>&get_instance_ref()</literal> + függvényt. + </simpara> + </sect2> </sect1> <sect1 id="language.variables.variable"> @@ -910,7 +770,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = "hello"; +?> ]]> </programlisting> </informalexample> @@ -925,7 +787,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $$a = "világ"; +?> ]]> </programlisting> </informalexample> @@ -940,7 +804,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php echo "$a ${$a}"; +?> ]]> </programlisting> </informalexample> @@ -952,7 +818,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php echo "$a $hello"; +?> ]]> </programlisting> </informalexample> @@ -962,16 +830,29 @@ </simpara> <simpara> - Annak érdekében, hogy változó változókat tömbökkel együtt is használhassuk, - fel kell oldani a következõ kétértelmûséget. A <varname>$$a[1]</varname> - kifejezés kiértékelésekor a feldolgozónak tudnia kell, hogy ez a - <varname>$a[1]</varname> értékét tekintse a hivatkozott változó neveként, + Annak érdekében, hogy változó változókat tömbökkel együtt is + használhassuk, fel kell oldani a következõ kétértelmûséget. A + <varname>$$a[1]</varname> kifejezés kiértékelésekor a feldolgozónak + tudnia kell, hogy ez a <varname>$a[1]</varname> értékét tekintse a + hivatkozott változó neveként, vagy <varname>$$a</varname>-t - és ekkor és ennek a tömbnek 1. indexû elemére történt a hivatkozás. Az elsõ esetben <varname>${$a[1]}</varname>, míg a másodikban <varname>${$a}[1]</varname> írandó. </simpara> + <warning> + <simpara> + Jegyezd meg, hogy változó változókat nem használhatsz a PHP <link + linkend="language.variables.superglobals">szuperglobális + tömbjeiben</link>. Ez azt jelenti, hogy nem írhatsz olyan dolgokat + mint például <varname>${$_GET}</varname>. Ha szeretnéd kihasználni a + szuperglobális és a régi <varname>HTTP_*_VARS</varname> tömbök + lehetõségét, megpróbálhatsz <link + linkend="language.references">referenciákkal</link> hivatkozni rájuk. + </simpara> + </warning> + </sect1> <sect1 id="language.variables.external"> @@ -981,50 +862,99 @@ <title>HTML ûrlapok (GET és POST)</title> <simpara> - Egy HTML ûrlap (form) elküldésével az ûrlap összes beviteli mezõjének - értéke automatikusan elérhetõvé válik a szkript számára a PHP segítségével. - Ha a <link linkend="ini.track-vars">track_vars</link> - szolgáltatás be van kapcsolva, ezek a változók a - <varname>$HTTP_POST_VARS</varname>, - <varname>$HTTP_GET_VARS</varname>, és/vagy - <varname>$HTTP_POST_FILES</varname>, asszociatív tömbökben - foglalnak helyet a változók forrásának megfelelõen. + Egy HTML ûrlap (form) elküldésével az ûrlapból származó összes adat + automatikusan elérhetõvé válik a szkript számára a PHP segítségével. + Többféle mód létezik ezen információk elérésére: </simpara> <para> - További információkért ezekrõl a változókról olvasd el az <link - linkend="language.variables.predefined">Elõre definiált változók</link> - címû részt. + <example> + <title>Egy egyszerû HTML form</title> + <programlisting role="html"> +<![CDATA[ +<form action="ize.php" method="post"> + Nev: <input type="text" name="usernev" /><br /> + Email: <input type="text" name="email" /><br /> + <input type="submit" name="submit" value="Elküld" /> +</form> +]]> + </programlisting> + </example> </para> <para> + Az egyéni beállításaidtól függõen több mód is létezik HTML formok + által beküldött adatok elérésére. Íme néhány példa: + </para> + + <para> <example> - <title>Egyszerû ûrlap változó példája</title> - <programlisting role="php"> + <title>Egy egyszerû HTML POST ûrlapból származó adatok + elérése</title> + <programlisting role="html"> <![CDATA[ -<form action="foo.php" method="post"> - Name: <input type="text" name="usernev"><br> - <input type="submit"> -</form> +<?php +// PHP 4.1.0-tól használható + + echo $_POST['usernev']; + echo $_REQUEST['usernev']; + + import_request_variables('p', 'p_'); + echo $p_usernev; + +// PHP 3-tól használható. PHP 5.0.0 óta ezek a hosszú elõredefiniált +// változók letilthatók a register_long_arrays direktívával. + + echo $HTTP_POST_VARS['usernev']; + +// Használható, ha a register_globals PHP direktíva értéke = on. +// A PHP 4.2.0 óta a register_globals alapértelmezett értéke = off. +// E mód használata nem ajánlott. + + echo $usernev; +?> ]]> </programlisting> </example> </para> + <para> + Egy GET form használata hasonló, kivéve hogy a megfelelõ GET + elõredefiniált változókat kell használnod. A GET a QUERY_STRING-re + vonatkozik (az információ, ami az URL-ben a '?' után szerepel). + Például a <literal>http://www.pelda.hu/teszt.php?azon=3</literal> + tartalmaz egy GET adatot, amely <varname>$_GET['azon']</varname> + módon érhetõ el. + Lásd még: <link + linkend="reserved.variables.request">$_REQUEST</link>, + <function>import_request_variables</function> + </para> + + <note> + <para> + A <link linkend="language.variables.superglobals">szuperglobális + tömbök</link>, mint például a <varname>$_POST</varname> vagy a + <varname>$_GET</varname>, a PHP 4.1.0-tõl állnak rendelkezésre. + </para> + </note> <para> - Ha elküldjük a fenti ûrlapot, akkor a PHP létrehozza a - <varname>$HTTP_POST_VARS['usernev']</varname> változót. - Ha a <link linkend="ini.register-globals">register_globals</link> - beállítás aktív, akkor ez a változó elérhetõ lesz - <varname>$usernev</varname> globális változóként is. + Mint láttuk, a PHP 4.2.0 elõtt a <link + linkend="ini.register-globals">register_globals</link> + alapértelmezett értéke <emphasis>on</emphasis> volt, PHP 3-ban pedig + mindig be volt állítva. A PHP közösség azt javasolja mindenkinek, + hogy ne alapozzon erre a direktívára, mert az + <emphasis>off</emphasis>-ra állítását sokkal inkább részesítík + elõnyben; ennek megfelelõen érdemes programozni. </para> + <note> <para> A <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - konfigurációs beállítás hatással van a GET, POST és COOKIE metódusokkal - kapott értékekre. Bekapcsolva a (Ez a "PHP", biz'a!) szövegbõl - automágikusan (Ez a \"PHP\", biz\'a!) lesz, hogy megkönnyítse az adatbázisba - írást. Lásd még: <function>addslashes</function>, + konfigurációs beállítás hatással van a GET, POST és COOKIE + metódusokkal kapott értékekre. Bekapcsolva a (Ez a "PHP", biz'a!) + szövegbõl automágikusan (Ez a \"PHP\", biz\'a!) lesz, hogy + megkönnyítse az adatbázisba írást. Lásd még: + <function>addslashes</function>, <function>stripslashes</function> és <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>! </para> @@ -1032,10 +962,12 @@ <simpara> A PHP megérti és kezeli a tömbökbe rendezett ûrlapváltozókat. - (Lásd <link linkend="faq.html">related faq</link>!) + (Lásd <link linkend="faq.html">kapcsolódó Gy.I.K.</link>!) Hasznos lehet csoportosítani az összetartozó változókat, vagy az olyan ûrlapelemeket, ahol több lehetõség közül nem csak egy választható. + Példaképpen küldjünk el egy ûrlapot saját magának, és elküldéskor + jelenítsük meg az adatot. </simpara> <para> @@ -1043,17 +975,30 @@ <title>Összetettebb ûrlapváltozók</title> <programlisting role="php"> <![CDATA[ -<form action="array.php" method="post"> - Név: <input type="text" name="szemelyes[nev]"><br> - Email: <input type="text" name="szemelyes[email]"><br> - Sör: <br> - <select multiple name="ital[]"> - <option value="warthog">Warthog - <option value="guinness">Guinness - <option value="stuttgarter">Stuttgarter Schwabenbräu - </select> - <input type="submit"> +<?php +if (isset($_POST['muvelet']) && $_POST['muvelet'] == 'bekuldve') { + echo '<pre>'; + print_r($_POST); + echo '<a href="'. $_SERVER['PHP_SELF'] .'">Próbáld újra</a>'; + + echo '</pre>'; +} else { +?> +<form action="<?php echo $_SERVER['PHP_SELF']; ?>" method="post"> + Név: <input type="text" name="szemelyes[nev]" /><br /> + Email: <input type="text" name="szemelyes[email]" /><br /> + Sör: <br /> + <select multiple name="sor[]"> + <option value="warthog">Warthog</option> + <option value="guinness">Guinness</option> + <option value="stuttgarter">Stuttgarter Schwabenbräu</option> + </select><br /> + <input type="hidden" name="muvelet" value="bekuldve" /> + <input type="submit" name="submit" value="Küld!" /> </form> +<?php +} +?> ]]> </programlisting> </example> @@ -1073,9 +1018,9 @@ </simpara> <informalexample> - <programlisting role="php"> + <programlisting role="html"> <![CDATA[ -<input type="image" src="image.gif" name="elkuld"> +<input type="image" src="kep.gif" name="elkuld"> ]]> </programlisting> </informalexample> @@ -1085,7 +1030,8 @@ változó jut el: elkuld_x-et és elkuld_y-t. Ezek tartalmazzák a kattintás képen belüli koordinátáit. A tapasztaltabbak biztos megjegyeznék, hogy a változónevek nem aláhúzást, hanem pontot - tartalmaznak, de a PHP a pontot automatikusan aláhúzássá konvertálja. + tartalmaznak, de a PHP a pontot automatikusan aláhúzássá + konvertálja. </simpara> </sect3> @@ -1104,25 +1050,41 @@ A sütik a HTTP fejléc részei, így a SetCookie függvényt bármilyen kimenet generálása elõtt kell meghívni. Ugyanezt a megkötést kell betartani a <function>header</function> - függvénnyel. Bármilyen süti, amelyet a klienstõl érkezik, + függvénnyel. + A süti adatok a megfelelõ tömbökben találhatóak, mint például a + <varname>$_COOKIE</varname>, <varname>$HTTP_COOKIE_VARS</varname> + valamint a <varname>$_REQUEST</varname>. További részleteket és + példákat a kézikönyv <function>setcookie</function> oldalán találsz. + + <!--Bármilyen süti, amelyet a klienstõl érkezik, automatikusan egy PHP változóba kerül, úgy, mint a GET és - a POST metódus adatai. + a POST metódus adatai.--> </simpara> <simpara> - Ha több adatot akarsz rendelni egy sütihez, egyszerûen rakj - <emphasis>[]</emphasis>-t a cookie neve után. Például: + Ha több adatot akarsz rendelni egy sütiváltozóhoz, egyszerûen +tekintsd egy tömbnek. Például: </simpara> <informalexample> <programlisting role="php"> <![CDATA[ -setcookie("EnSutim[]", "tesztelem", time()+3600); +<?php + setcookie("Sutikem[ize]", "Teszt 1", time()+3600); + setcookie("Sutikem[bigyo]", "Teszt 2", time()+3600); +?> ]]> </programlisting> </informalexample> <simpara> + Ez két különbözõ süti, viszont a szkriptedben a Sutikem egyetlen tömb + lesz. Ha egy sütiben szeretnél tárolni összetett adatokat, + használhatod a <function>serialize</function> vagy az + <function>explode</function> függvényeket. + </simpara> + + <simpara> Vigyázz, mert a süti felülírja az elõzõ azonos nevû sütit, hacsak nem különbözik a path vagy a domain. Így pl. egy bevásárlókocsi megírásakor jó egy számlálót is elhelyezni, hogy @@ -1130,43 +1092,24 @@ </simpara> <example> - <title>SetCookie Példa</title> + <title>Példa a <function>setcookie</function> használatára</title> <programlisting role="php"> <![CDATA[ -$Szamlalo++; -setcookie("Szamlalo", $Szamlalo, time()+3600); -setcookie("Kocsi[$Szamlalo]", $elem, time()+3600); +<?php +if (isset($_COOKIE['szamlalo'])) { + $szamlalo = $_COOKIE['szamlalo'] + 1; +} else { + $szamlalo = 1; +} +setcookie("szamlalo", $szamlalo, time()+3600); +setcookie("Kosar[$szamlalo]", $elem, time()+3600); +?> ]]> </programlisting> </example> </sect2> - <sect2 id="language.variables.external.environment"> - <title>Környezeti változók</title> - - <para> - A PHP automatikusan létrehozza az elérhetõ környezeti változókat, - mint egyszerû PHP változókat. - - <informalexample> - <programlisting role="php"> -<![CDATA[ -echo $HOME; /* Megmutatja a HOME környezeti változót, ha van. */ -]]> - </programlisting> - </informalexample> - </para> - - <para> - Mivel az információ ami a GET, POST és Cookie mechanizmuson keresztül - jön, mind automatikusan PHP változókat generál, ezért néha jobb, ha - direkt a környezeti változókból olvassuk ki, hogy tudjuk, valójában - melyik változatból olvasunk. A <function>getenv</function> - függvényt lehet erre használni. A környezeti változókat be is - lehet állítani a <function>putenv</function> függvénnyel. - </para> - </sect2> <sect2 id="language.variables.external.dot-in-names"> <title>Pontok a bejövõ változónevekben</title> @@ -1174,16 +1117,18 @@ <para> Általában a PHP nem változtatja meg a változók neveit, amikor a szkript megkapja õket. A pont viszont nem érvényes karakter - egy PHP változóneven belül. Az ok megértéséért nézd a: + egy PHP változóneven belül. Az ok megértéséért nézd ezt: <programlisting role="php"> <![CDATA[ +<?php $varname.ext; /* érvénytelen változónév */ +?> ]]> </programlisting> Most az elemzõ lát egy <varname>$varname</varname> nevû változót, amelyet stringösszefûzõ operátor (.) követ, majd egy csupasz sztring: - az ext - idézõjel nélküli string, amely nem egyezik semmilyen ismert vagy - lefoglalt kulcsszóval. Ez nyilván nem a kívánt eredményt adná. + az ext - idézõjel nélküli string, amely nem egyezik semmilyen ismert + vagy lefoglalt kulcsszóval. Ez nyilván nem a kívánt eredményt adná. </para> <para> @@ -1201,11 +1146,13 @@ (általában) szükség szerint, nem mindig nyilvánvaló, hogy milyen típusú egy pillanatban egy adott változó. A PHP-nek számos függvénye van, amelyek egy változó típusát hivatottak - eldönteni. Ezek: - <function>gettype</function>, <function>is_long</function>, - <function>is_double</function>, <function>is_string</function>, - <function>is_array</function>, és - <function>is_object</function>. + eldönteni, mint például: + <function>gettype</function>, <function>is_array</function>, + <function>is_float</function>, <function>is_int</function>, + <function>is_object</function>, és + <function>is_string</function>. + Lásd még a + <link linkend="language.types">típusokról szóló fejezetet</link>. </para> </sect2>
http://cvs.php.net/diff.php/phpdoc-hu/language/variables.xml?r1=1.24&r2=1.25&ty=u Index: phpdoc-hu/language/variables.xml diff -u phpdoc-hu/language/variables.xml:1.24 phpdoc-hu/language/variables.xml:1.25 --- phpdoc-hu/language/variables.xml:1.24 Sun Jun 13 04:30:44 2004 +++ phpdoc-hu/language/variables.xml Fri Jul 9 07:43:49 2004 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-2"?> -<!-- EN-Revision: 1.35 Maintainer: goba Status: ready --> -<!-- CREDITS: kgergely,gerzson --> +<!-- EN-Revision: 1.78 Maintainer: goba Status: ready --> +<!-- CREDITS: kgergely,gerzson,bagilevi --> <chapter id="language.variables"> <title>Változók</title> @@ -33,14 +33,16 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $var = "Géza"; $Var = "János"; echo "$var, $Var"; // kiírja, hogy "Géza, János" $4site = 'ez nem jó'; // nem érvényes, mert számmal kezdõdik $_4site = 'ez ok'; // érvényes, aláhúzással kezdõdik -$täyte = 'mansikka'; // érvényes, az 'ä' az ASCII 228-as karaktere +$täyte = 'mansikka'; // érvényes, az 'ä' a kiterjesztett ASCII 228-as karaktere $tükörfúrógép = "árvíztûrõ"; // érvényes, ellenõrizheted egy ASCII táblában +?> ]]> </programlisting> </informalexample> @@ -57,14 +59,17 @@ </para> <para> PHP 4-ben lehetõség van egy másik hozzárendelési módra: - <emphasis>változó referencia szerinti hozzárendelésére</emphasis>. + <link linkend="language.references">változó referencia szerinti + hozzárendelésére</link>. Ez azt jelenti, hogy az új változó egyszerûen hivatkozik (más szóval "alias lesz", vagy "rá mutat") az eredetire. Az új változón végzett változtatások az eredetit is érintik és fordítva. Ez azt is jelenti, hogy nem történik másolás; ekképpen a hozzárendelés gyorsabban történik meg. Igaz ugyan, hogy ez a sebességnövekedés csak "feszes" ciklusokban vagy - nagy tömböknél ill. objektumok átadásakor jelentkezik. + nagy <link linkend="language.types.array">tömböknél</link> ill. <link + linkend="language.types.object">objektumok</link> átadásakor + jelentkezik. </para> <para> Referencia szerinti értékadáshoz egyszerûen & jelet kell @@ -78,8 +83,8 @@ $ize = 'Bob'; // 'Bob' hozzárendelése $ize-hoz $bigyo = &$ize; // Hivatkozás $ize-ra $bigyo-ban. $bigyo = "Nevem $bigyo"; // $bigyo megváltoztatása... -echo $ize; // $ize is megváltozott echo $bigyo; +echo $ize; // $ize is megváltozott ?> ]]> </programlisting> @@ -117,587 +122,232 @@ <simpara> A PHP egy számos elõre definiált változót biztosít az bármely futó szkript számára. Sokat ezek közül nem lehet teljes pontossságal - dokumentálni, mert függnek a a futtató szervertõl, a használt verziótól, - a konfigurálástól, és más gyéb tényezõktõl. Néhány ilyen változó nem - elérhetõ, ha a PHP parancssorból fut. - </simpara> - <simpara> - E tényezõk ellenére az alábbi listában azok az elõre definiált - változók vannak felsorolva, amelyek a PHP 3 tipikus installálásakor elérhetõk - az <ulink url="&url.apache;">Apache</ulink> 1.3.6-ot használva. - </simpara> - <simpara> - Az összes elõre definiált változó kilistázható, és sok más hasznos - információt is közöl a <function>phpinfo</function>. + dokumentálni, mert függnek a a futtató szervertõl, a használt + verziótól, + a konfigurálástól, és egyéb tényezõktõl. Néhány ilyen változó nem + elérhetõ, ha a PHP + <link linkend="features.commandline">parancssorból</link> fut. + Ezen változókról találsz egy listát + <link linkend="reserved.variables">Fenntartott elõredefiniált + változók</link> c. részben. </simpara> - <note> + <warning> <simpara> - Ez a lista nem teljes, nem is ez a célja. Ez csak - egy útmutató arról, hogy milyen típusú elõre - definiált változók lehetnek. + A PHP 4.2.0 és késõbbi verzióiban a <link + linkend="ini.register-globals">register_globals</link> direktíva + alapértelmezett értéke <emphasis>off</emphasis>. Ez a PHP-nek egy + jelentõs + változása. A register_globals <emphasis>off</emphasis>-ra állítása + befolyásolja az elõredefiniált változók készletét a globális + hatáskörben. + Például a <varname>DOCUMENT_ROOT</varname> lekéréséhez a + <varname>$_SERVER['DOCUMENT_ROOT']</varname> formát kell használnod + <varname>$DOCUMENT_ROOT</varname> helyett, vagy + <literal>http://www.pelda.hu/teszt.php?id=3</literal> URL esetén + <varname>$_GET['id']</varname>-t az <varname>$id</varname> helyett, + vagy + <varname>$_ENV['HOME']</varname> alakot a <varname>$HOME</varname> + helyett. </simpara> - </note> - - <sect2 id="language.variables.predefined.apache"> - <title>Apache változók</title> - <simpara> - Ezek a változók az <ulink url="&url.apache;">Apache</ulink> - webszerver változói. Ha másik szerveren fut a PHP, nincs rá - garancia, hogy ugyanezek a változók akkor is rendelkezésre állnak: - némelyik hiányozhat, esetleg itt nem szereplõket is biztosíthat - a szerver. Számos a <ulink url="&url.cgispec;">CGI 1.1 - specifikációban</ulink> dokumentált változókra biztosan lehet alapozni. + Több információért olvasd el a <link + linkend="ini.register-globals">register_globals</link>-ról szóló + bejegyzést, a biztonságról szóló fejezetben a <link + linkend="security.globals">Register Globals használatáról</link> + szóló + részt, valamint a PHP <ulink url="&url.php.release4.1.0;">4.1.0 + </ulink> és <ulink url="&url.php.release4.2.0;">4.2.0</ulink> + verzióinak bejelentését. </simpara> <simpara> - Figyelni kell arra, hogy ha a PHP parancssorból (command line) használva - a változók töredékének van csak értelme, ha egyáltalán definiáltak ilyen - esetben. + A PHP-ben rendelkezésre álló fenntartott elõredefiniált változók, + mint + például a <link + linkend="language.variables.superglobals">szuperglobális + tömbök</link> használata ajánlottabb. </simpara> + </warning> + + <simpara> + A 4.1.0-s verziótól a PHP további elõredefiniált tömböket biztosít, + amelyek + webszerverektõl (ha van), környezetbõl, és felhasználótól származó + változókat tartalmaznak. Ezek az új tömbök elég sajátosak, mivel + automatikusan globálisak, azaz automatikusan rendelkezésre állnak + minden + hatáskörben. Ezért gyakran nevezik ezeket 'autoglobálisn' vagy + 'szuperglobális' tömböknek. (A felhasználónak nincs lehetõsége + szuperglobális változók definiálására.) A szuperglobális tömbök alább + vannak + felsorolva; viszont a PHP elõredefiniált változóinak tartalma és + természetüknek tárgyalása a <link + linkend="reserved.variables">Fenntartott + elõredefiniált változók</link> címû részben olvasható, ahol a régebbi + elõredefiniált változók (<varname>$HTTP_*_VARS</varname>) létezésérõl + is + tudomást szerezhetsz. + &avail.register-long-arrays; + </simpara> + + <note> + <title>Változó változók</title> <para> - <variablelist> - <varlistentry> - <term>$GATEWAY_INTERFACE</term> - <listitem> - <simpara> - A server CGI specifikációjának verziója. Pl.: 'CGI/1.1'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_NAME</term> - <listitem> - <simpara> - A gazdagép (host) neve, ami alatt a szkript fut. Ha - a szkript virtuális host-on fut, a virtuális host neve. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_SOFTWARE</term> - <listitem> - <simpara> - Serverazonosító sztring, amely a kérésekre (request) adott válasz (response) - fejlécében (header) szerepel. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_PROTOCOL</term> - <listitem> - <simpara> - Az oldal lekéréséhez használt protokoll neve - és verziója pl. 'HTTP/1.0' - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REQUEST_METHOD</term> - <listitem> - <simpara> - Az oldal eléréséhez használt kérési forma, pl.: 'GET', 'HEAD', 'POST', 'PUT'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$QUERY_STRING</term> - <listitem> - <simpara> - Keresési kérdés, az oldalt meghívó URL-ben a ? után szereplõ rész, ha létezik. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$DOCUMENT_ROOT</term> - <listitem> - <simpara> - A www dokumentumok fõkönyvtára, amely alatt a jelenlegi - szkript fut. Ez a szerver konfigurációs fájljában - meghatározott érték. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept:</literal> HTTP fejlécének - tartalma, ha van ilyen. Ebben adja meg a böngészõ, hogy milyen - formátumokat képes fogadni. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_CHARSET</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Charset:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'iso-8859-1,*,utf-8'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_ENCODING</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Encoding:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'gzip'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_ACCEPT_LANGUAGE</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Accept-Language:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'en'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_CONNECTION</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Connection:</literal> HTTP fejlécének - tartalma, ha van ilyen. pl. 'Keep-Alive'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_HOST</term> - <listitem> - <simpara> - Az aktuális kérés <literal>Host:</literal> HTTP fejlécének tartalma, - ha éppen van ilyen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_REFERER</term> - <listitem> - <simpara> - Annak az oldalnak az URL címe, ahonnan ide - került a látogató. Ezt a látogató böngészõprogramja - állítja be, de ezt nem minden böngészõ és nem mindig - teszi meg. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_USER_AGENT</term> - <listitem> - <simpara> - Az aktuális <literal>User_Agent:</literal> HTTP fejlécének tartalma, - ha van ilyen. Ez a string, amely meghatározza - az oldal megtekintéséhez használt böngészõt, pl. - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux - 2.2.9 i586)</computeroutput>. Sok más mellett - ezt az értéket a fel lehet használni arra, hogy a - <function>get_browser</function> fügvénnyel - az aktuális böngészõ képességeinek megfelelõen lehessen - kialakítani az oldal megjelenését. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REMOTE_ADDR</term> - <listitem> - <simpara> - Az az IP cím, ahonnan a látogató az oldalt lekérte. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REMOTE_PORT</term> - <listitem> - <simpara> - A látogató gépén a webszerverrel való kommunikációhoz - használt port száma. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SCRIPT_FILENAME</term> - <listitem> - <simpara> - A PHP szkript abszolút elérési útja a szerver gépen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_ADMIN</term> - <listitem> - <simpara> - A SERVER_ADMIN a kiszolgáló konfigurációs fájl direktíva - értéke (Apache alatt). Ha a szkript egy virtuális - host-on fut, akkor ez a virtuális host-hoz rendelt - érték. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_PORT</term> - <listitem> - <simpara> - A kiszolgálógépen a kiszolgáló kommunikációjában - használt port száma. Alapértelmezés szerint ez a '80', - de például SSL-t használva ez a biztonságos - HTTP portnak a száma lesz. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SERVER_SIGNATURE</term> - <listitem> - <simpara> - A kiszolgáló verziószámát és a virtuális - host-ot tartalmazó sztring, ha engedélyezett. - Ez a szöveg jelenik meg minden szerver által generált oldal alján. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PATH_INFO</term> - <listitem> - <simpara> - Hasonló értéket tartalmaz, mint a SCRIPT_NAME, de - CGI verzió esetén ez jobb lehet az önhivatkozó - kérdõívek készítésekor, mert egyes szervereken - a SCRIPT_NAME tartalmazza a PHP bináris meghívási útvonalát is. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PATH_TRANSLATED</term> - <listitem> - <simpara> - A szkript a fájlrendszer szerinti (nem a document root-hoz - viszonyított!) elérési útja. Ezt a kiszolgáló a virtuális->valós - átalakítás után határozza meg. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$SCRIPT_NAME</term> - <listitem> - <simpara> - Az aktuális szkript elérési útja, ahogy az az URL-ben - megjelenik. Hasznos a saját magukra mutató oldalakhoz. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$REQUEST_URI</term> - <listitem> - <simpara> - Az az URI, amellyel az oldalt lekérték. pl. '/index.html'. - </simpara> - </listitem> - </varlistentry> - </variablelist> + A szuperglobális változók nem használhatók + <link linkend="language.variables.variable">változó + változókként</link> + függvényekben és osztályok metódusaiban. </para> + </note> - </sect2> - - <sect2 id="language.variables.predefined.environment"> - <title>Környezeti változók</title> - - <simpara> - A PHP globális változói közé kerülnek a PHP feldolgozót - futtató környezet változói. Számos változót a shell - szolgáltat, ami alatt a PHP fut. Mivel más-más rendszerek - más-más shell-eket használnak, ezért egy pontos lista - összeállítása lehetetlen. A használt shell dokumentációjában - nézz utána az elõre definiált környezeti változóknak! - </simpara> - <simpara> - Más környezeti változók - beleértve a CGI változókat is - - attól függõen kerülnek be, hogy a PHP szerver - modulként fut vagy CGI feldolgozóként. - </simpara> - - </sect2> - - <sect2 id="language.variables.predefined.php"> - <title>PHP változók</title> - - <simpara> - Ezeket a PHP maga állítja elõ. A <varname>$HTTP_*_VARS</varname> - változók csak akkor állnak rendelkezésre, ha a - <link linkend="ini.track-vars">track_vars</link> - be van kapcsolva. Ha engedélyezted ezt a beállítást, - ezek a változók mindig létrejönnek, még ha üresek is. - Ez nem engedi a rosszindulatú felhasználóknak, hogy - meghamasítsák a változókat. - </simpara> - - <note> - <para> - A PHP 4.0.3 verziótól kezdve a <link - linkend="ini.track-vars">track_vars</link> mindig be van kapcsolva, - függetlenül a konfigurációs fájl beállításától. - </para> - </note> - - <note> - <para> - Az új szuper globális (Superglobals) változók 4.1.0 verziótól - használhatók. További részletekért lásd a <ulink - url="&url.php.release4.1.0;">4.1.0 verzió bejelentését</ulink> - Ezek a <varname>$_GET</varname>, <varname>$_POST</varname>, - <varname>$_ENV</varname>, <varname>$_SERVER</varname>, - <varname>$_COOKIE</varname>, <varname>$_REQUEST</varname> - <varname>$_FILES</varname> és a <varname>$_SESSION</varname> - tömbök, amelyek fesztelen megfogalmazásban <emphasis>szuper - globális</emphasis> jelzõvel illetik, mivel minden esetben - használhatók tekintet nélkül az aktuális érvényességi körre. - Emiatt a régi, nekik megfelelõ <varname>$HTTP_*_VARS</varname> - tömbök használata már nem javasolt. - </para> - </note> + <note> <para> - Ha a <link - linkend="ini.register-globals">register_globals</link> be van kapcsolva, - ezek a változók globális változókként is létrejönnek, függetlenül - a <varname>$HTTP_*_VARS</varname> tömböktõl. Nézd meg idevonatkozó - részletes információkért a biztonságról szóló <link - linkend="security.globals">Globálisan is elérhetõ változók - (Register Globals) használata</link> c. fejezetet! + Annak ellenére, hogy egyidõben létezhet a szuperglobális és a + HTTP_*_VARS + tömb, ezen nem azonosak, tehát az egyiknek a módosítása nem + változtatja + meg a másikat is. </para> + </note> - <para> - <variablelist> - <varlistentry> - <term>$argv</term> - <listitem> - <simpara> - A szkriptnek átadott argumentumok tömbje. Ha a szkript - parancssor alól futtatjuk, ez egy C-szerû hozzáférést - biztosít a parancssor argumentumokhoz. Ha GET - metódussal hívjuk, az URL kérdõjel utáni részét - (query string) tartalmazza. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$argc</term> - <listitem> - <simpara> - A parancssori argumentumok számát tartalmazza - (ha parancssorból futtatjuk). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$PHP_SELF</term> - <listitem> - <simpara> - A most futó szkriptfájl neve, a document root-hoz - képest relatív alakban. Ha a PHP parancssorból - fut, ez a változó nem elérhetõ. Ez a változó - a kérés útvonal információját is tartalmazza, ha az - létezik, azaz a $PHP_SELF a "http://example.com/test.php/foo.bar" - címre a következõt fogja adni: "/test.php/foo.bar" - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_COOKIE_VARS</term> - <listitem> - <simpara> - HTTP cookie-kat (sütiket) tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_COOKIE</term> - <listitem> - <simpara> - HTTP cookie-kat (sütiket) tartalmazó asszociatív tömb, amely - minden hatókörben elérhetõ. PHP 4.1.0-ban került - a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_GET_VARS</term> - <listitem> - <simpara> - HTTP GET metódussal által szolgáltatott adatokat tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_GET</term> - <listitem> - <simpara> - HTTP GET metódussal által szolgáltatott adatokat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_POST_VARS</term> - <listitem> - <simpara> - HTTP POST metódussal által szolgáltatott adatokat tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_POST</term> - <listitem> - <simpara> - HTTP POST metódussal által szolgáltatott adatokat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_POST_FILES</term> - <listitem> - <simpara> - A HTTP POST metódussal feltöltött fájlokról tartalmaz információkat, asszociatív tömb. - Lásd a <link linkend="features.file-upload.post-method">POST metódusú - feltöltések</link> címû részt további információkért a - <varname>$HTTP_POST_FILES</varname> tartalmát és szerkezetét illetõen. - PHP 4.0.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_FILES</term> - <listitem> - <simpara> - A HTTP POST metódussal feltöltött fájlokról tartalmaz információkat, asszociatív tömb. - Lásd a <link linkend="features.file-upload.post-method">POST metódusú - feltöltések</link> címû részt további információkért a - <varname>$_POST</varname> tartalmát és szerkezetét illetõen. - Minden hatókörben elérhetõ. PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> + <para> + Ha bizonyos változók nincsenek megjelölve a <link + linkend="ini.variables-order">variables_order</link>-ben akkor a + megfelelõ + PHP elõredefiniált tömbök üresek. + </para> + <variablelist id="language.variables.superglobals"> + <title>PHP szuperglobális változók</title> <varlistentry> - <term>$HTTP_ENV_VARS</term> - <listitem> - <simpara> - A szülõ/futtató környezet aktuális változóit tartalmazó asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_ENV</term> - <listitem> - <simpara> - A szülõ/futtató környezet aktuális változóit tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - + <term><link + linkend="reserved.variables.globals">$GLOBALS</link></term> + <listitem> + <simpara> + Minden olyan változóhoz tartalmaz egy referenciát, amely + pillanatnyilag + a szkript globális hatáskörében létezik. Ennek a tömbnek a kulcsai + a globális változók nevei. A <varname>$GLOBALS</varname> tömb a + PHP 3-tól létezik. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.server">$_SERVER</link></term> + <listitem> + <simpara> + Olyan változók amelyeket a webszerver állított be vagy amelyek + szorosan összefüggenek a szkript futtatási környezetével. + Analógiája a régebbi <varname>$HTTP_SERVER_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.get">$_GET</link></term> + <listitem> + <simpara> + HTTP GET kérés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_GET_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.post">$_POST</link></term> + <listitem> + <simpara> + HTTP POST kérés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_POST_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> <varlistentry> - <term>$HTTP_SERVER_VARS</term> - <listitem> - <simpara> - A HTTP szervertõl érkezõ változókkal feltöltött asszociatív tömb. - Ezek a változók megfelelnek a fent említett Apache változóknak. - </simpara> - </listitem> - </varlistentry> - </variablelist> - - <variablelist> - <varlistentry> - <term>$_SERVER</term> - <listitem> + <term><link + linkend="reserved.variables.cookies">$_COOKIE</link></term> + <listitem> + <simpara> + HTTP sütikbõl (cookie) származó változók. + Analógiája a régebbi <varname>$HTTP_COOKIE_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link linkend="reserved.variables.files">$_FILES</link></term> + <listitem> + <simpara> + HTTP post fájlfeltöltés által létrejövõ változók. + Analógiája a régebbi <varname>$HTTP_POST_FILES</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + További információ a + <link linkend="features.file-upload.post-method">POST típusú + fájlfeltöltésrõl szóló fejezetben</link>. + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.environment">$_ENV</link></term> + <listitem> + <simpara> + A környezetbõl származó változók. + Analógiája a régebbi <varname>$HTTP_ENV_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.request">$_REQUEST</link></term> + <listitem> + <simpara> + HTTP GET, POST és COOKIE bementekbõl származó változók, azaz + amelyekben nem lehet megbízni. A jelenléte és a változók tömbbe + való besorolásának sorrendje + a PHP <link linkend="ini.variables-order">variables_order</link> + konfigurációs direktívája szerint van definiálva. Ennek nincs + közvetlen + analógiája a PHP 4.1.0-nál elõbbi verzióiban. + Lásd még: <function>import_request_variables</function>. + </simpara> + <caution> <simpara> - A HTTP szervertõl érkezõ változókkal feltöltött asszociatív tömb, - amely minden hatókörben elérhetõ. PHP 4.1.0-ban került - a nyelvbe. + A PHP 4.3.0 óta a <varname>$_FILES</varname>-ban szereplõ + fájlinformációk nem szerepelnek a + <varname>$_REQUEST</varname>-ben. </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$HTTP_SESSION_VARS</term> - <listitem> - <simpara> - Az aktuális szkripthez tartozó session változókat tartalmazó - asszociatív tömb. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_SESSION</term> - <listitem> - <simpara> - Az aktuális szkripthez tartozó session változókat tartalmazó - asszociatív tömb, amely minden hatókörben elérhetõ. A - <varname>_SESSION</varname> tömbben új bejegyzések létrehozásával - automatikusan regisztrálhatók értékek, mint a - <function>session_register</function> segítségével. - PHP 4.1.0-ban került a nyelvbe. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>$_REQUEST</term> - <listitem> + </caution> + <note> <simpara> - A GET, POST és Cookie változókból összeállított asszociatív tömb. - Más szóval, bármilyen a felhasználótól ügyféltõl érkezõ adatot - tartalmaz, ami biztonsági szempontból nem megbízható. - Minden hatókörben elérhetõ. PHP 4.1.0-ban került a nyelvbe. + <link linkend="features.commandline">Parancssori</link> futtatás + esetén ez <emphasis>nem</emphasis> tartalmazza az + <varname>argv</varname> and <varname>argc</varname> bejegyzéseket; + ezek a <varname>$_SERVER</varname> tömbben szerepelnek. </simpara> - </listitem> - </varlistentry> - </variablelist> - </para> - </sect2> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><link + linkend="reserved.variables.session">$_SESSION</link></term> + <listitem> + <simpara> + Olyan változók, amelyek a szkript munkamanetéhez vannak rendelve. + Analógiája a régebbi <varname>$HTTP_SESSION_VARS</varname> tömbnek + (amely még mindig rendelkezésre áll, de használata nem ajánlott). + További információért lásd a <link + linkend="ref.session">Munkamenet kezelõ függvények</link> címû + részt. + </simpara> + </listitem> + </varlistentry> + </variablelist> + </sect1> @@ -718,8 +368,10 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = 1; include "b.inc"; +?> ]]> </programlisting> </informalexample> @@ -735,6 +387,7 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = 1; /* globális hatáskör */ function Test () @@ -743,6 +396,7 @@ } Test(); +?> ]]> </programlisting> </informalexample> @@ -757,13 +411,20 @@ ha a függvényben újra nem definiáltad azt a változót. Ez problémák forrása lehet, ha az ember véletlenül megváltoztat egy globális változót. A PHP-ben a globális - változókat global kulcsszóval kell deklarálni a függvényekben, - például: + változókat global kulcsszóval kell deklarálni a függvényekben. </simpara> - <informalexample> - <programlisting role="php"> + <sect2 id="language.variables.scope.global"> + <title>A global kulcsszó</title> + <simpara> + Elõször nézzünk egy példát a <literal>global</literal> használatára: + </simpara> + <para> + <example> + <title>A global használata</title> + <programlisting role="php"> <![CDATA[ +<?php $a = 1; $b = 2; @@ -776,9 +437,11 @@ Ossszead(); echo $b; +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> A fenti szkript kiírja, hogy "3". <varname>$a</varname> @@ -789,13 +452,17 @@ <simpara> Globális változók elérésének másik módja a PHP által - definiált speciális <varname>$GLOBALS</varname> tömb használata. Az elõbbi - példával egyenértékû megoldás: + definiált speciális <varname>$GLOBALS</varname> tömb használata. Az + elõbbi példával egyenértékû megoldás: </simpara> - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>A <varname>$GLOBALS</varname> használata global + helyett</title> + <programlisting role="php"> <![CDATA[ +<?php $a = 1; $b = 2; @@ -806,16 +473,53 @@ Osszead(); echo $b; +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> A <varname>$GLOBALS</varname> asszociatív tömb, ahol a globális változó neve jelenti a kulcsot, és a változó értéke a tömbelem értéke. + Vedd észre, hogy a <varname>$GLOBALS</varname> tömb minden + hatáskörben létezik, mivel a $GLOBALS egy <link + linkend="language.variables.superglobals">szuperglobális + változó</link>. + A következõ példa a szuperglobális változók erejét szemlélteti. </simpara> + <para> + <example> + <title>Példa szuperglobális változók és a hatáskör + szemléltetésére</title> + <programlisting role="php"> +<![CDATA[ +<?php +function global_teszt() +{ + // A legtöbb elõredefiniált változó nem "szuper" és + // megkövetelik a 'global' használatát, hogy elérhetõek + // legyenek függvények helyi hatáskörében. + global $HTTP_POST_VARS; + + echo $HTTP_POST_VARS['nev']; + + // A szuperglobális változók elérhetõek bármilyen + // hatáskörben, és nem szükséges a 'global' kulcsszó. + // A szuperglobális változók a PHP 4.1.0-tõl használhatóak. + echo $_POST['nev']; +} +?> +]]> + </programlisting> + </example> + </para> + </sect2> + + <sect2 id="language.variables.scope.static"> + <title>Statikus változók használata</title> <simpara> A változók hatáskörének másik fontos lehetõsége a <emphasis>static</emphasis> (statikus) változó. A statikus @@ -823,19 +527,24 @@ belül, de két függvényhívás közt nem veszti el az értékét, a változó hatáskörébõl való kilépés esetén is megmarad az értéke: </simpara> + <para> + <example> + <title>Statikus változók szükségességét szemléltetõ példa</title> + <programlisting role="php"> - <informalexample> - <programlisting role="php"> <![CDATA[ +<?php function Test() { $a = 0; echo $a; $a++; } +?> ]]> - </programlisting> - </informalexample> + </programlisting> + </example> + </para> <simpara> Ez nagyon haszontalan függvény, mivel nem csinál mást, @@ -847,20 +556,23 @@ legyen - megmaradjon a számláló értéke -, az <varname>$a</varname> változót statikusnak kell deklarálni: </simpara> - - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>Példa statikus változók használatára</title> + <programlisting role="php"> <![CDATA[ +<?php function Test() { static $a = 0; echo $a; $a++; } +?> ]]> - </programlisting> - </informalexample> - + </programlisting> + </example> + </para> <simpara> Most már valahányszor meghívódik a Test() függvény, kiírja <varname>$a</varname> értékét, majd azt megnöveli eggyel. @@ -870,17 +582,21 @@ A statikus változókat a rekurzív függvények megvalósításában is felhasználhatjuk. Rekurzívnak nevezzük azt a függvényt, amely saját magát hívja meg. Ezt természetesen feltételhez kell kötni, - nehogy végtelen rekurzióba kerüljön a vezérlés és meghatározatlan idõre - a függvényen belül csapdába esik. Mindig meg kell bizonyosodni arról, hogy + nehogy végtelen rekurzióba kerüljön a vezérlés és meghatározatlan + idõre a függvényen belül csapdába esik. Mindig meg kell bizonyosodni + arról, hogy megfelelõ feltétel rendelkezésre áll a rekurzió befejezéséhez. A következõ függvény rekurzívan elszámol 10-ig a statikus <varname>$count</varname> változó segítségével: [A static kulcsszó nagyon fontos!] </simpara> - <informalexample> - <programlisting role="php"> + <para> + <example> + <title>Statikus változók rekurzív függvényekkel</title> + <programlisting role="php"> <![CDATA[ +<?php function Test() { static $count = 0; @@ -892,10 +608,154 @@ } $count--; } +?> +]]> + </programlisting> + </example> + </para> + + <note> + <para> + Statikus változókat a fenti példákban szereplõ módon lehet + deklarálni. Ha olyan értéket próbálsz értékül adni neki, amely egy + kifejezés eredménye, az parse error-t fog okozni. + </para> + <para> + <example> + <title>Statikus változók deklarálása</title> + <programlisting role="php"> +<![CDATA[ +<?php +function ize(){ + static $int = 0; // jó + static $int = 1+2; // rossz (mivel ez egy kifejezés) + static $int = sqrt(121); // rossz (szintén kifejezés) + + $int++; + echo $int; +} +?> +]]> + </programlisting> + </example> + </para> + </note> + </sect2> + + <sect2 id="language.variables.scope.references"> + <title>Referenciák globális és statikus változókkal</title> + <simpara> + A <literal>PHP 4</literal>-et mûködtetõ Zend Engine 1, a <link + linkend="language.variables.scope.static">statikus</link> és <link + linkend="language.variables.scope.global">globális</link> változó + módosítókat <link linkend="language.references"> + referenciákkal</link> implementálja. Például egy valódi globális + változó beemelve egy függvény hatáskörébe a <literal>global</literal> + utasítással tulajdonképpen létrehoz egy referenciát a globális + változóhoz. Ez váratlan viselkedésmódhoz vezethet, amelyet a következõ + példa illusztrál: + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function test_global_ref() { + global $obj; + $obj = &new stdclass; +} + +function test_global_noref() { + global $obj; + $obj = new stdclass; +} + +test_global_ref(); +var_dump($obj); +test_global_noref(); +var_dump($obj); +?> +]]> + </programlisting> + </informalexample> + + <simpara> + A példában szereplõ kód végrahajtása a következõ kimenetet produkálja: + </simpara> + + <screen> +NULL +object(stdClass)(0) { +} + </screen> + + <simpara> + Hasonló viselkedésmód jellemzi a <literal>static</literal> utasítást. + A referenciák nem statikusan vannak tárolva: + </simpara> + + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +function &get_instance_ref() { + static $obj; + + echo "Statikus objektum: "; + var_dump($obj); + if (!isset($obj)) { + // Hozzárendel egy referenciát a statikus változóhoz + $obj = &new stdclass; + } + $obj->property++; + return $obj; +} + +function &get_instance_noref() { + static $obj; + + echo "Statikus objektum: "; + var_dump($obj); + if (!isset($obj)) { + // Hozzárendeli az objektumot a statikus változóhoz + $obj = new stdclass; + } + $obj->property++; + return $obj; +} + +$obj1 = get_instance_ref(); +$still_obj1 = get_instance_ref(); +echo "\n"; +$obj2 = get_instance_noref(); +$still_obj2 = get_instance_noref(); +?> ]]> </programlisting> </informalexample> + <simpara> + A példa végrehajtása a következõ kimenetet eredményezi: + </simpara> + + <screen> +Statikus objektum: NULL +Statikus objektum: NULL + +Statikus objektum: NULL +Statikus objektum: object(stdClass)(1) { + ["property"]=> + int(1) +} + </screen> + + <simpara> + A példa azt szemlélteti, hogy amikor hozzárendelsz egy referenciát egy + statikus változóhoz, az nem <emphasis>lesz megjegyezve</emphasis> + amikor újra meghívod a <literal>&get_instance_ref()</literal> + függvényt. + </simpara> + </sect2> </sect1> <sect1 id="language.variables.variable"> @@ -910,7 +770,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $a = "hello"; +?> ]]> </programlisting> </informalexample> @@ -925,7 +787,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php $$a = "világ"; +?> ]]> </programlisting> </informalexample> @@ -940,7 +804,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php echo "$a ${$a}"; +?> ]]> </programlisting> </informalexample> @@ -952,7 +818,9 @@ <informalexample> <programlisting role="php"> <![CDATA[ +<?php echo "$a $hello"; +?> ]]> </programlisting> </informalexample> @@ -962,16 +830,29 @@ </simpara> <simpara> - Annak érdekében, hogy változó változókat tömbökkel együtt is használhassuk, - fel kell oldani a következõ kétértelmûséget. A <varname>$$a[1]</varname> - kifejezés kiértékelésekor a feldolgozónak tudnia kell, hogy ez a - <varname>$a[1]</varname> értékét tekintse a hivatkozott változó neveként, + Annak érdekében, hogy változó változókat tömbökkel együtt is + használhassuk, fel kell oldani a következõ kétértelmûséget. A + <varname>$$a[1]</varname> kifejezés kiértékelésekor a feldolgozónak + tudnia kell, hogy ez a <varname>$a[1]</varname> értékét tekintse a + hivatkozott változó neveként, vagy <varname>$$a</varname>-t - és ekkor és ennek a tömbnek 1. indexû elemére történt a hivatkozás. Az elsõ esetben <varname>${$a[1]}</varname>, míg a másodikban <varname>${$a}[1]</varname> írandó. </simpara> + <warning> + <simpara> + Jegyezd meg, hogy változó változókat nem használhatsz a PHP <link + linkend="language.variables.superglobals">szuperglobális + tömbjeiben</link>. Ez azt jelenti, hogy nem írhatsz olyan dolgokat + mint például <varname>${$_GET}</varname>. Ha szeretnéd kihasználni a + szuperglobális és a régi <varname>HTTP_*_VARS</varname> tömbök + lehetõségét, megpróbálhatsz <link + linkend="language.references">referenciákkal</link> hivatkozni rájuk. + </simpara> + </warning> + </sect1> <sect1 id="language.variables.external"> @@ -981,50 +862,99 @@ <title>HTML ûrlapok (GET és POST)</title> <simpara> - Egy HTML ûrlap (form) elküldésével az ûrlap összes beviteli mezõjének - értéke automatikusan elérhetõvé válik a szkript számára a PHP segítségével. - Ha a <link linkend="ini.track-vars">track_vars</link> - szolgáltatás be van kapcsolva, ezek a változók a - <varname>$HTTP_POST_VARS</varname>, - <varname>$HTTP_GET_VARS</varname>, és/vagy - <varname>$HTTP_POST_FILES</varname>, asszociatív tömbökben - foglalnak helyet a változók forrásának megfelelõen. + Egy HTML ûrlap (form) elküldésével az ûrlapból származó összes adat + automatikusan elérhetõvé válik a szkript számára a PHP segítségével. + Többféle mód létezik ezen információk elérésére: </simpara> <para> - További információkért ezekrõl a változókról olvasd el az <link - linkend="language.variables.predefined">Elõre definiált változók</link> - címû részt. + <example> + <title>Egy egyszerû HTML form</title> + <programlisting role="html"> +<![CDATA[ +<form action="ize.php" method="post"> + Nev: <input type="text" name="usernev" /><br /> + Email: <input type="text" name="email" /><br /> + <input type="submit" name="submit" value="Elküld" /> +</form> +]]> + </programlisting> + </example> </para> <para> + Az egyéni beállításaidtól függõen több mód is létezik HTML formok + által beküldött adatok elérésére. Íme néhány példa: + </para> + + <para> <example> - <title>Egyszerû ûrlap változó példája</title> - <programlisting role="php"> + <title>Egy egyszerû HTML POST ûrlapból származó adatok + elérése</title> + <programlisting role="html"> <![CDATA[ -<form action="foo.php" method="post"> - Name: <input type="text" name="usernev"><br> - <input type="submit"> -</form> +<?php +// PHP 4.1.0-tól használható + + echo $_POST['usernev']; + echo $_REQUEST['usernev']; + + import_request_variables('p', 'p_'); + echo $p_usernev; + +// PHP 3-tól használható. PHP 5.0.0 óta ezek a hosszú elõredefiniált +// változók letilthatók a register_long_arrays direktívával. + + echo $HTTP_POST_VARS['usernev']; + +// Használható, ha a register_globals PHP direktíva értéke = on. +// A PHP 4.2.0 óta a register_globals alapértelmezett értéke = off. +// E mód használata nem ajánlott. + + echo $usernev; +?> ]]> </programlisting> </example> </para> + <para> + Egy GET form használata hasonló, kivéve hogy a megfelelõ GET + elõredefiniált változókat kell használnod. A GET a QUERY_STRING-re + vonatkozik (az információ, ami az URL-ben a '?' után szerepel). + Például a <literal>http://www.pelda.hu/teszt.php?azon=3</literal> + tartalmaz egy GET adatot, amely <varname>$_GET['azon']</varname> + módon érhetõ el. + Lásd még: <link + linkend="reserved.variables.request">$_REQUEST</link>, + <function>import_request_variables</function> + </para> + + <note> + <para> + A <link linkend="language.variables.superglobals">szuperglobális + tömbök</link>, mint például a <varname>$_POST</varname> vagy a + <varname>$_GET</varname>, a PHP 4.1.0-tõl állnak rendelkezésre. + </para> + </note> <para> - Ha elküldjük a fenti ûrlapot, akkor a PHP létrehozza a - <varname>$HTTP_POST_VARS['usernev']</varname> változót. - Ha a <link linkend="ini.register-globals">register_globals</link> - beállítás aktív, akkor ez a változó elérhetõ lesz - <varname>$usernev</varname> globális változóként is. + Mint láttuk, a PHP 4.2.0 elõtt a <link + linkend="ini.register-globals">register_globals</link> + alapértelmezett értéke <emphasis>on</emphasis> volt, PHP 3-ban pedig + mindig be volt állítva. A PHP közösség azt javasolja mindenkinek, + hogy ne alapozzon erre a direktívára, mert az + <emphasis>off</emphasis>-ra állítását sokkal inkább részesítík + elõnyben; ennek megfelelõen érdemes programozni. </para> + <note> <para> A <link linkend="ini.magic-quotes-gpc">magic_quotes_gpc</link> - konfigurációs beállítás hatással van a GET, POST és COOKIE metódusokkal - kapott értékekre. Bekapcsolva a (Ez a "PHP", biz'a!) szövegbõl - automágikusan (Ez a \"PHP\", biz\'a!) lesz, hogy megkönnyítse az adatbázisba - írást. Lásd még: <function>addslashes</function>, + konfigurációs beállítás hatással van a GET, POST és COOKIE + metódusokkal kapott értékekre. Bekapcsolva a (Ez a "PHP", biz'a!) + szövegbõl automágikusan (Ez a \"PHP\", biz\'a!) lesz, hogy + megkönnyítse az adatbázisba írást. Lásd még: + <function>addslashes</function>, <function>stripslashes</function> és <link linkend="ini.magic-quotes-sybase">magic_quotes_sybase</link>! </para> @@ -1032,10 +962,12 @@ <simpara> A PHP megérti és kezeli a tömbökbe rendezett ûrlapváltozókat. - (Lásd <link linkend="faq.html">related faq</link>!) + (Lásd <link linkend="faq.html">kapcsolódó Gy.I.K.</link>!) Hasznos lehet csoportosítani az összetartozó változókat, vagy az olyan ûrlapelemeket, ahol több lehetõség közül nem csak egy választható. + Példaképpen küldjünk el egy ûrlapot saját magának, és elküldéskor + jelenítsük meg az adatot. </simpara> <para> @@ -1043,17 +975,30 @@ <title>Összetettebb ûrlapváltozók</title> <programlisting role="php"> <![CDATA[ -<form action="array.php" method="post"> - Név: <input type="text" name="szemelyes[nev]"><br> - Email: <input type="text" name="szemelyes[email]"><br> - Sör: <br> - <select multiple name="ital[]"> - <option value="warthog">Warthog - <option value="guinness">Guinness - <option value="stuttgarter">Stuttgarter Schwabenbräu - </select> - <input type="submit"> +<?php +if (isset($_POST['muvelet']) && $_POST['muvelet'] == 'bekuldve') { + echo '<pre>'; + print_r($_POST); + echo '<a href="'. $_SERVER['PHP_SELF'] .'">Próbáld újra</a>'; + + echo '</pre>'; +} else { +?> +<form action="<?php echo $_SERVER['PHP_SELF']; ?>" method="post"> + Név: <input type="text" name="szemelyes[nev]" /><br /> + Email: <input type="text" name="szemelyes[email]" /><br /> + Sör: <br /> + <select multiple name="sor[]"> + <option value="warthog">Warthog</option> + <option value="guinness">Guinness</option> + <option value="stuttgarter">Stuttgarter Schwabenbräu</option> + </select><br /> + <input type="hidden" name="muvelet" value="bekuldve" /> + <input type="submit" name="submit" value="Küld!" /> </form> +<?php +} +?> ]]> </programlisting> </example> @@ -1073,9 +1018,9 @@ </simpara> <informalexample> - <programlisting role="php"> + <programlisting role="html"> <![CDATA[ -<input type="image" src="image.gif" name="elkuld"> +<input type="image" src="kep.gif" name="elkuld"> ]]> </programlisting> </informalexample> @@ -1085,7 +1030,8 @@ változó jut el: elkuld_x-et és elkuld_y-t. Ezek tartalmazzák a kattintás képen belüli koordinátáit. A tapasztaltabbak biztos megjegyeznék, hogy a változónevek nem aláhúzást, hanem pontot - tartalmaznak, de a PHP a pontot automatikusan aláhúzássá konvertálja. + tartalmaznak, de a PHP a pontot automatikusan aláhúzássá + konvertálja. </simpara> </sect3> @@ -1104,25 +1050,41 @@ A sütik a HTTP fejléc részei, így a SetCookie függvényt bármilyen kimenet generálása elõtt kell meghívni. Ugyanezt a megkötést kell betartani a <function>header</function> - függvénnyel. Bármilyen süti, amelyet a klienstõl érkezik, + függvénnyel. + A süti adatok a megfelelõ tömbökben találhatóak, mint például a + <varname>$_COOKIE</varname>, <varname>$HTTP_COOKIE_VARS</varname> + valamint a <varname>$_REQUEST</varname>. További részleteket és + példákat a kézikönyv <function>setcookie</function> oldalán találsz. + + <!--Bármilyen süti, amelyet a klienstõl érkezik, automatikusan egy PHP változóba kerül, úgy, mint a GET és - a POST metódus adatai. + a POST metódus adatai.--> </simpara> <simpara> - Ha több adatot akarsz rendelni egy sütihez, egyszerûen rakj - <emphasis>[]</emphasis>-t a cookie neve után. Például: + Ha több adatot akarsz rendelni egy sütiváltozóhoz, egyszerûen +tekintsd egy tömbnek. Például: </simpara> <informalexample> <programlisting role="php"> <![CDATA[ -setcookie("EnSutim[]", "tesztelem", time()+3600); +<?php + setcookie("Sutikem[ize]", "Teszt 1", time()+3600); + setcookie("Sutikem[bigyo]", "Teszt 2", time()+3600); +?> ]]> </programlisting> </informalexample> <simpara> + Ez két különbözõ süti, viszont a szkriptedben a Sutikem egyetlen tömb + lesz. Ha egy sütiben szeretnél tárolni összetett adatokat, + használhatod a <function>serialize</function> vagy az + <function>explode</function> függvényeket. + </simpara> + + <simpara> Vigyázz, mert a süti felülírja az elõzõ azonos nevû sütit, hacsak nem különbözik a path vagy a domain. Így pl. egy bevásárlókocsi megírásakor jó egy számlálót is elhelyezni, hogy @@ -1130,43 +1092,24 @@ </simpara> <example> - <title>SetCookie Példa</title> + <title>Példa a <function>setcookie</function> használatára</title> <programlisting role="php"> <![CDATA[ -$Szamlalo++; -setcookie("Szamlalo", $Szamlalo, time()+3600); -setcookie("Kocsi[$Szamlalo]", $elem, time()+3600); +<?php +if (isset($_COOKIE['szamlalo'])) { + $szamlalo = $_COOKIE['szamlalo'] + 1; +} else { + $szamlalo = 1; +} +setcookie("szamlalo", $szamlalo, time()+3600); +setcookie("Kosar[$szamlalo]", $elem, time()+3600); +?> ]]> </programlisting> </example> </sect2> - <sect2 id="language.variables.external.environment"> - <title>Környezeti változók</title> - - <para> - A PHP automatikusan létrehozza az elérhetõ környezeti változókat, - mint egyszerû PHP változókat. - - <informalexample> - <programlisting role="php"> -<![CDATA[ -echo $HOME; /* Megmutatja a HOME környezeti változót, ha van. */ -]]> - </programlisting> - </informalexample> - </para> - - <para> - Mivel az információ ami a GET, POST és Cookie mechanizmuson keresztül - jön, mind automatikusan PHP változókat generál, ezért néha jobb, ha - direkt a környezeti változókból olvassuk ki, hogy tudjuk, valójában - melyik változatból olvasunk. A <function>getenv</function> - függvényt lehet erre használni. A környezeti változókat be is - lehet állítani a <function>putenv</function> függvénnyel. - </para> - </sect2> <sect2 id="language.variables.external.dot-in-names"> <title>Pontok a bejövõ változónevekben</title> @@ -1174,16 +1117,18 @@ <para> Általában a PHP nem változtatja meg a változók neveit, amikor a szkript megkapja õket. A pont viszont nem érvényes karakter - egy PHP változóneven belül. Az ok megértéséért nézd a: + egy PHP változóneven belül. Az ok megértéséért nézd ezt: <programlisting role="php"> <![CDATA[ +<?php $varname.ext; /* érvénytelen változónév */ +?> ]]> </programlisting> Most az elemzõ lát egy <varname>$varname</varname> nevû változót, amelyet stringösszefûzõ operátor (.) követ, majd egy csupasz sztring: - az ext - idézõjel nélküli string, amely nem egyezik semmilyen ismert vagy - lefoglalt kulcsszóval. Ez nyilván nem a kívánt eredményt adná. + az ext - idézõjel nélküli string, amely nem egyezik semmilyen ismert + vagy lefoglalt kulcsszóval. Ez nyilván nem a kívánt eredményt adná. </para> <para> @@ -1201,11 +1146,13 @@ (általában) szükség szerint, nem mindig nyilvánvaló, hogy milyen típusú egy pillanatban egy adott változó. A PHP-nek számos függvénye van, amelyek egy változó típusát hivatottak - eldönteni. Ezek: - <function>gettype</function>, <function>is_long</function>, - <function>is_double</function>, <function>is_string</function>, - <function>is_array</function>, és - <function>is_object</function>. + eldönteni, mint például: + <function>gettype</function>, <function>is_array</function>, + <function>is_float</function>, <function>is_int</function>, + <function>is_object</function>, és + <function>is_string</function>. + Lásd még a + <link linkend="language.types">típusokról szóló fejezetet</link>. </para> </sect2>