Preddefinované premenné

Premenné servera : $_SERVER

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_SERVER_VARS .

$_SERVER je pole obsahujúce informácie o hlavičkách , cestách a umiestneniach skriptu . Položky v tomto poli vytvára webserver . Nie je žiadna záruka , že každý webserver vude poskytovať niektoré z nich ; servery môžu niektoré vynehať alebo poskytovať iné , tu neuvedené . Veľké množstvo týchto premenných je vysvetlených na CGI 1.1 špecifikácii , takže mali by ste očakávať tie .

Toto je ' superglobálna ' alebo automaticky globálna premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť global $_SERVER ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_SERVER_VARS .

$HTTP_SERVER_VARS obsahuje rovnaké počiatočné informácie , ale nie je autoglobálna . ( Všimnite si , že $HTTP_SERVER_VARS a $_SERVER odlišné premenné , a tak ich aj PHP spracováva )

Ak je nastavená direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej oblasti skriptu ; t.j. , oddelí polia $_SERVER a $HTTP_SERVER_VARS . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Niektoré z následujúcich elementov môžete , ale nemusíte nájsť v $_SERVER . Niektoré z nich , ak vôbec , budú k dispozícii ( alebo budú mať nejaký význam ) , ak PHP beží v príkazovom riadku .

' PHP_SELF '

Názov súboru práve spracovávaného skriptu , vztažný na koreň dokumentu . Na príklad , $_SERVER[ 'PHP_SELF' ] v skripte na adrese http : / /example.com / test.php / foo.bar by bol / test.php / foo.bar .

Ak PHP beží ako procesor príkazového riadku , táto premenná nie je dostupná .

' argv '

Pole argumentov predané skriptu . Keď je skript spustený v príkazovom riadku , toto dáva C-štýlom prístup k parametrom príkazového riadka . Keď sa volá cez metódu GET , bude obsahovať reťazec dotazu .

' argc '

Obsahuje počet parametrov príkazového riadka predaných skriptu ( ak beží v príkazovom riadku ) .

' GATEWAY_INTERFACE '

akú revíziu CGI špecifikácie server používa ; t.j . ' CGI / 1.1 ' .

' SERVER_NAME '

Názov hostu servera , pod ktorým sa aktuálny skript spracováva . Ak skript beží na virtuálnom hoste , toto bude hodnota definovaná pre virtuálny host .

' SERVER_SOFTWARE '

Identifikačný reťazec servera , udaný v hlavičkách , keď odpovedá na požiadavky .

' SERVER_PROTOCOL '

Názov a revízia informačného protokolu , cez ktorý sa stránka požadovala ; t.j . ' HTTP / 1.0 ' ;

' REQUEST_METHOD '

Ktorá metóda požiadavky sa použila na prístu ku stránke ; t.j . ' GET ' , ' HEAD ' , ' POST ' , ' PUT ' .

' QUERY_STRING '

Reťazec dotazu , ak je , cez ktorý sa stránka sprístupnila .

' DOCUMENT_ROOT '

Koreňový adresár dokumentu , pod ktorým sa skript spracováva , ako je definované v konfiguračnom súbore servera .

' HTTP_ACCEPT '

Obsah hlavičky Accept : z aktuálnej požiadavky , ak nejaká je .

' HTTP_ACCEPT_CHARSET '

Obsah hlavičky Accept-Charset : z aktuálnej požiadavky , ak nejaká je . Príklad : ' iso-8859-1,*,utf-8 ' .

' HTTP_ACCEPT_ENCODING '

Obsah hlavičky Accept-Encoding : z aktuálnej požiadavky , ak nejaká je . Príklad : ' gzip ' .

' HTTP_ACCEPT_LANGUAGE '

Obsah hlavičky Accept-Language : z aktuálnej požiadavky , ak nejaká je . Príklad : ' en ' .

' HTTP_CONNECTION '

Obsah hlavičky Connection : z aktuálnej požiadavky , ak nejaká je . Príklad : ' Keep-Alive ' .

' HTTP_HOST '

Obsah hlavičky Host : z aktuálnej požiadavky , ak nejaká je .

' HTTP_REFERER '

Adresa stránky ( ak je ) , ktorá odkazovala užívateľského agenta na aktuálnu stránku . Toto nastaví užívateľský agent . Nie všetky užívateľské agenty toto nastavia a niektoré poskytujú možnosť modifikovať HTTP_REFERER ako vlastnosť . V skratke , nedá sa tomu naozaj veriť .

' HTTP_USER_AGENT '

Obsah hlavičky User_Agent : z aktuálnej požiadavky , ak nejaká je . Je to reťazec zaznamenavajúci existenciu užívateľského agenta , ktorý sprístupňuje stránku . Typický príklad je : Medzi iným , túto hodnotu môžete použiť s get_browser( ) k prispôsobeniu výstupu vašej stránky schopnostiam užívateľského agenta .

' REMOTE_ADDR '

IP adresa , z ktorej si užívateľ prezerá aktuálnu stránku .

' REMOTE_PORT '

Port používaný na komunikáciu s web serverom na počítači užívateľa .

' SCRIPT_FILENAME '

Absolutná cesta k práve spracovávaného skriptu .

' SERVER_ADMIN '

Hodnota daná SERVER_ADMIN ( pre Apache ) direktívu v konfiguračnom súbore web servera . Ak skript beží na virtuálnom hoste , bude to hodnota definovaná pre tento virtuálny host .

' SERVER_PORT '

Port na počítači servera používaný web serverom na komunikáciu . Pre default nastavenie to bude ' 80 ' ; použitie SSL , na príklad , to zmení na čokoľvek , čo váš definovaný bezpečný HTTP port je .

' SERVER_SIGNATURE '

Reťazec obsahujúci verziu servera a názov virtuálneho hostu , ktoré sa pridajú na na serverom-generované stránky , ak je to aktivované .

' PATH_TRANSLATED '

Cesta súborového systému ( nie koreňového dokumentu ) k aktuálnemu skriptu , po tom , čo server urobil nejaké virtual-to-real mapovanie .

' SCRIPT_NAME '

Obsahuje cestu k aktuálnemu skriptu . Je to užitočné pre stránky , ktoré musia ukazovať samé na seba .

' REQUEST_URI '

URI , ktorá bola daná , aby bol k tejto stránke prístup ; na príklad ' / index.html ' .

' PHP_AUTH_USER '

Keď bežíte pod Apache ako modulom vykonávajúcim HTTP autentifikácie , táto premenná je nastavená na meno poskytnuté užívateľom .

' PHP_AUTH_PW '

Keď bežíte pod Apache ako modulom vykonávajúcim HTTP autentifikácie , táto premenná je nastavená na heslo poskytnuté užívateľom .

' PHP_AUTH_TYPE '

Keď bežíte pod Apache ako modulom vykonávajúcim HTTP autentifiácie , táto premenná je nastavená na typ autentifikácie .



Enviromentálne premenné : $_ENV

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_ENV_VARS .

Tieto premenné su importované do globálnej oblasti mien PHP z prostredia , pod ktorým beží PHP parser . Mnoho je poskytovaných shellom , pod ktorým beží PHP a na rôznych systémoch zaiste bežia rôzne druhy shellov , definitívy zoznam nie je možný . Prosím , pozrite si dokumentáciu k vášmu shellu o zozname definovaných enviromentálnych premenných .

Iné enviromentálne premenné zahŕňajú premenné CGI , ktoré tam umiestnené bez ohľadu na to , či PHP beží ako server modul alebo CGI procesor .

Toto je ' superglobálna ' , alebo automatická globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globálu $_ENV ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_ENV_VARS .

$HTTP_ENV_VARS obsahuje rovnaké počiatočné informácie , ale nie autoglobálna . ( Všimnite si , že HTTP_ENV_VARS a $_ENV rôzne premenné , a tak ich aj PHP spracováva )

Ak je nastavená direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej oblasti skriptu ; t.j. , oddelí polia $_ENV a $HTTP_ENV_VARS . Súvisiace informácie s pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

HTTP Cookies : $_COOKIE

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_COOKIE_VARS .

Asociatívne pole premenných predaných aktuálnemu skriptu cez HTTP cookies . Automaticky globálna v akejkoľvek oblasti .

Toto je ' superglobálna ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globalu $_COOKIE ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_COOKIE_VARS .

$HTTP_COOKIE_VARS obsahuje rovnaké počiatočné informácie , ale nie je autoglobálna . ( Všimnite si , že HTTP_COOKIE_VARS a $_COOKIE rôzne premenné , a tak ich aj PHP spracováva )

Ak je nastavená direktíva register_globals , potom tieto premenné sa tiež sprístupnia v globálnej oblasti skriptu ; t.j . oddelí polia $_COOKIE and $HTTP_COOKIE_VARS . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Premenné HTTP GET : $_GET

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_GET_VARS .

Asociatívne pole premenných predaných aktuálnemu skriptu cez metódu HTTP GET . Automaticky globálna v akejkoľvek oblasti .

Toto je ' superglobálna ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globálu $_GET ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_GET_VARS .

$HTTP_GET_VARS obsahuje rovnaké počiatočné informácie , ale nie je autoglobálna . ( Všimnite si , že HTTP_GET_VARS a $_GET rôzne premenné , a tak ich aj PHP spracováva )

Ak je nastavená direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej oblasti skriptu ; t.j. , oddelí polia $_GET a $HTTP_GET_VARS . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Premenné HTTP POST : $_POST

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_POST_VARS .

Asociatívne pole premenných predaných aktuálnemu skriptu cez metódu HTTP POST . Automaticky globálna v akejkoľvek oblasti .

Toto je ' superglobála ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastich po celom skripte . Nemusíte použiť globálu $_POST ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_POST_VARS .

$HTTP_POST_VARS obsahuje rovnaké počiatočné informácie , ale nie je autoglobálna . ( Všimnite si , že HTTP_POST_VARS a $_POST rôzne premenné , a tak ich aj PHP spracováva )

ak je nastavená direktíva register_globals , potom sa tieto premenné tiež spístupnia v globálnej oblsti skriptu ; t.j. , oddelí polia $_POST a $HTTP_POST_VARS . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Premenné HTTP File upload : $_FILES

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_POST_FILES .

Asociatívne pole prvkov uploadovaných aktuálnemu skriptu cez metódu HTTP POST . Automaticky globálna v akejkoľvek oblasti .

toto je ' superglobálna ' , alebo automaticky globálna , premenná . To jednoducho znamená , žee je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globálu $_FILES ; , aby ste ju sprístupnili vo funkciách a metódach , ako to robíte s $HTTP_POST_FILES .

$HTTP_POST_FILES obsahuje rovnaké počiatočné informácie , ale nie je autoglobálna .

ak je nastavené direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej obasti skriptu ; t.j. , oddelí polia $_FILES a $HTTP_POST_FILES . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Premenné požiadavky : $_REQUEST

Poznámka : Predstavené v 4.1.0 . V skorších verziách nie je žiadne ekvivalentné pole .

Asociatívne pole pozostávajúce z obsahu $_GET , $_POST a $_COOKIE .

Poznámka : V PHP 4.3.0 , $_FILES bola tiež zahrnutá do $_REQUEST .

Toto je ' superglobálna ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globálu $_REQUEST ; , aby ste ju sprístupnili vo funkciách a metódach .

Ak je nastavená direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej oblasti skriptu ; t.j. , oddelí pole $_REQUEST . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Relačné premenné : $_SESSION

Poznámka : Predstavené v 4.1.0 . V skorších verziách používajte $HTTP_SESSION_VARS .

Asociatívne pole obsahujúce premenné dostupné aktuálnemu skriptu . Pozrite si dokumentáciu Relačné funkcie pre informácie , ako sa používa .

Toto je ' superglobílna ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastich po celom skripte . Nemusíte použiť globálu $_SESSION ; , aby ste ju sprístnili vo funkicichá a metódach , ako to robíte s $HTTP_SESSION_VARS .

$HTTP_SESSION_VARS obsahuje rovnaké informácie , ale nie je autoglobálna .

Ak je nastavená direktíva register_globals , potom sa tieto premenné tiež sprístupnia v globálnej oblasti skriptu ; t.j. , oddelí polia $_SESSION a $HTTP_SESSION_VARS . Súvisiace informácie si pozrite v kapitole bezpečnosti pod titulkom Používanie globálov registra . Tieto individuálne globály nie autoglobály .

Globálne premenné : $GLOBALS

Poznámka: $GLOBALS je dostupná od PHP 3.0.0.

Asociatívne pole obsahujúce relačné odkazy na všetky premenné , ktoré aktuálne definované v globálnej oblasti skriptu . Názvy premenných kľúče poľa .

Toto je ' superglobálna ' , alebo automaticky globálna , premenná . To jednoducho znamená , že je dostupná vo všetkých oblastiach po celom skripte . Nemusíte použiť globálu $GLOBALS ; , aby ste ju sprístupnili vo funkciách a metodach .

Predošlá chybová správa : $php_errormsg

$php_errormsg je premenná obsahujúca text poslednej chybovej správy vygenerovanej PHP-čkom . Táto premenná bude dostupná iba v oblasti , v ktorej sa chyba vyskytla a iba ak je zapnutá konfiguračná voľba track_errors ( defaultne je vypnutá ) .