cvs: phpdoc-de /appendices reserved.xml
| From: | Philip Olson | Date: | Mon, 16 Jun 2008 03:58:51 +0000 |
| Subject: | cvs: phpdoc-de /appendices reserved.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2675@lists.php.net to get a copy of this message | ||
philip Mon Jun 16 03:58:51 2008 UTC
Modified files:
/phpdoc-de/appendices reserved.xml
Log:
Help complete the transition to language/predefined/variables/*
http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/reserved.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-de/appendices/reserved.xml diff -u phpdoc-de/appendices/reserved.xml:1.19 phpdoc-de/appendices/reserved.xml:1.20 --- phpdoc-de/appendices/reserved.xml:1.19 Mon Mar 10 10:41:06 2008 +++ phpdoc-de/appendices/reserved.xml Mon Jun 16 03:58:50 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <!-- EN-Revision: 1.72 Maintainer: hholzgra Status: working --> <appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -288,879 +288,6 @@ </table> </sect1> - <sect1 xml:id="reserved.variables"> - <title>Vordefinierte Variablen</title> - - <para> - Seit PHP 4.1.0 wird empfohlen, - <link linkend="language.variables.external">externe Variablen</link> - über die Superglobals, die weiter unten beschrieben werden, abzufragen. - Davor war man entweder auf die <link linkend="ini.register-globals">register_globals</link> - -Einstelliung oder die Langformen der vordefinierten PHP-Arrays - (<varname>$HTTP_*_VARS</varname>) angewiesen. - - - &avail.register-long-arrays; - </para> - - <sect2 xml:id="reserved.variables.server"> - <title>Server-Variablen: <varname>$_SERVER</varname></title> - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie stattdessen <varname>$HTTP_SERVER_VARS</varname>. - </simpara> - </note> - - <simpara> - <varname>$_SERVER</varname> ist ein Array, in dem Informationen über - Header, Pfade oder den Speicherort des Skripts gespeichert sind. Die - Einträge dieses Arrays werden vom Webserver generiert. Es gibt keine - Garantie, dass jeder Webserver alle diese Einträge erzeugt. Manche - Server werden Einträge auslassen oder andere einfügen, die hier - nicht aufgeführt sind. Ein grosser Teil dieser Variablen stammt aus - der <link xlink:href="&url.cgispec;">CGI 1.1 Spezifikation</link>. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_SERVER;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_SERVER_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_SERVER_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_SERVER_VARS</varname> und <varname>$_SERVER</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_SERVER</varname> - und <varname>$HTTP_SERVER_VARS</varname> Arrays. Lesen Sie für weitere - Informationen das Kapitel über Sicherheit - <link linkend="security.globals">Verwendung von Register Globals</link>. - Diese individuellen globalen Variablen sind nicht automatisch global. - </simpara> - - <simpara> - Möglicherweise finden Sie das eine oder andere der folgenden - Elemente nicht in <varname>$_SERVER</varname>. Beachten Sie, dass nur - wenige, falls überhaupt, verfügbar sind (oder von Bedeutung - sind) wenn sie PHP auf der Kommandozeile betreiben. - </simpara> - - <para> - <variablelist> - <varlistentry> - <term>'<varname>PHP_SELF</varname>'</term> - <listitem> - <simpara> - Der Name des aktuell ausgeführten Skripts, relativ zum - Wurzelverzeichnis des Servers. Zum Beispiel gibt - <varname>$_SERVER['PHP_SELF']</varname> in einem Skript mit der - Adresse <filename>http://example.com/test.php/foo.bar</filename> - den Namen <filename>/test.php/foo.bar</filename> zurück. - </simpara> - <simpara> - Falls PHP auf der Kommandozeile ausgeführt wird, ist diese - Variable nicht verfügbar. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>argv</varname>'</term> - <listitem> - <simpara> - In diesem Array sind die Argumente enthalten, die an ein Skript - übergeben wurden. Wenn das Skript auf der Kommandozeile - ausgeführt wird, haben Sie einen C-ähnlichen Zugriff auf die - Kommandozeilenparameter. Wenn es mit der GET-Methode - aufgerufen wird, enthält das Array den Abfragestring. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>argc</varname>'</term> - <listitem> - <simpara> - Enthält die Anzahl der Kommandozeilenparameter, die an das - Skript übergeben wurden (falls es von der Kommandozeile aus - aufgerufen wurde). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>GATEWAY_INTERFACE</varname>'</term> - <listitem> - <simpara> - Die vom Server genutzte Revision der CGI Spezifikation, - zB. '<literal>CGI/1.1</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_ADDR</varname>'</term> - <listitem> - <simpara> - Die IP-Adresse des Servers unter der das aktuelle Script - ausgeführt wird. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_NAME</varname>'</term> - <listitem> - <simpara> - Der Name des Server Hosts unter dem das aktuelle Skript - ausgeführt wird. Falls das Skript unter einem virtuellen Host - läuft, wird der Name, der für diesen virtuellen Host vergeben - wurde, angezeigt. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_SOFTWARE</varname>'</term> - <listitem> - <simpara> - Die Identifikation des Servers, mit der sich ein Server im - Header bei der Beantwortung einer Anforderung identifiziert. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_PROTOCOL</varname>'</term> - <listitem> - <simpara> - Name und Versionsnummer des Protokolls, über das die Seite - angefordert wurde. Z. B. '<literal>HTTP/1.0</literal>'; - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_METHOD</varname>'</term> - <listitem> - <simpara> - Die HTTP-Methode mit der auf die Seite zugegriffen wurde, zB. '<literal>GET</literal>', - '<literal>HEAD</literal>', '<literal>POST</literal>', '<literal>PUT</literal>'. - </simpara> - <note> - <para> - Ist die Zugriffsmethode <literal>HEAD</literal> so wird das Skript - nach dem Senden der Header (also mit der ersten nicht von der Ausgabepufferung - abgefangenen Ausgabe) beendet. - </para> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_TIME</varname>'</term> - <listitem> - <simpara> - Der Startzeitpunkt des Requests. Verfügbar seit PHP 5.1.0 - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>QUERY_STRING</varname>'</term> - <listitem> - <simpara> - Der Query-String, falls vorhanden, mit dem auf die Seite zugegriffen wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>DOCUMENT_ROOT</varname>'</term> - <listitem> - <simpara> - Das Wurzelverzeichnis des Webservers, unter dem das aktuelle - Skript ausgeführt wird, so wie es in der Konfigurationsdatei des - Webservers hinterlegt ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept:</literal>-Headers der aktuellen - Anforderung, falls dieser Header vorhanden ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Charset:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Z. B. - '<literal>iso-8859-1,*,utf-8</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_ENCODING</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Encoding:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Beispiel: - '<literal>gzip</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_LANGUAGE</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Language:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Beispiel: - '<literal>en</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_CONNECTION</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Connection:</literal>-Headers der - aktuellen anforderung, so vorhanden. Beispiel: '<literal>Keep-Alive</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_HOST</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Host:</literal>-Headers der aktuellen Anforderung, - so vorhanden. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_REFERER</varname>'</term> - <listitem> - <simpara> - Die Adresse der Seite (falls es eine gibt), die den Browser auf - die aktuelle Seite verwies. Dieser Header wird vom Browser - gesetzt, aber nicht von allen. Einige Browser bieten die - Möglichkeit, den <varname>HTTP_REFERER</varname> zu - modifizieren. Kurz, auf diesen Header kann man sich nicht - verlassen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_USER_AGENT</varname>'</term> - <listitem> - <simpara> - Inhald des <literal>User-Agent:</literal> Headers des - aktuellen Requests falls vorhanden. Dieser String beschreibt - den auf die Seite zugreifenden Client. Ein typisches Beispiel ist - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)</computeroutput>. - Sie können diesen unter anderem im Zusammenhang mit der Funktion - <function>get_browser</function> benutzen um die Ausgaben Ihres - Scripts an die Fähigkeiten des Clients anzupassen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTPS</varname>'</term> - <listitem> - <simpara> - Dieser Eintrag ist gesetzt wenn der Zugriff auf das Script über das - HTTPS Protokoll erfolgte. - protocol. - </simpara> - <simpara> - Wenn das ISAPI des IIS genutzt wird so ist diese Variable auch bei - nicht-HTTPS Zugriffen gesetzt und enthält in diesem Fall den Wert - <literal>off</literal>. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_ADDR</varname>'</term> - <listitem> - <simpara> - Die IP-Adresse des Rechners, der die aktuelle Seite angefordert hat. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_HOST</varname>'</term> - <listitem> - <simpara> - Der Hostname des Servers, von dem die aktuelle Seite geladen - wurde. Der reverse dns lookup basiert auf dem - <varname>REMOTE_ADDR</varname>-Header. - </simpara> - <note> - <simpara> - Um diese Variable zu erzeugen, muss Ihr Webserver entsprechend - eingestellt sein. Zum Beispiel muss beim Apache - <literal>HostnameLookups On</literal> in der &httpd.conf; aktiv - sein. Siehe auch unter <function>gethostbyaddr</function>. - </simpara> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_PORT</varname>'</term> - <listitem> - <simpara> - Der Port über den der Rechner des Benutzers mit dem Webserver - kommuniziert. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SCRIPT_FILENAME</varname>'</term> - <listitem> - <para> - Der absolute Pfadname des aktuell ausgeführten Skripts. - <note> - <para> - Falls das Skript auf der Kommandozeile mit einem relativen - Pfad aufgerufen wird, wie z. B. <filename>file.php</filename> - oder <filename>../file.php</filename>, enthält - <varname>$_SERVER['SCRIPT_FILENAME']</varname> den relativen - Pfad, den der Benutzer angegeben hat. - </para> - </note> - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_ADMIN</varname>'</term> - <listitem> - <simpara> - Der Wert, der in der Server Konfiguration der Direktive - SERVER_ADMIN (bei Apache) zugewiesen wurde. Falls das Skript - unter einem virtuellen Host läuft, wird der Wert angegeben, der - für diesen virtuellen Host angegeben wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_PORT</varname>'</term> - <listitem> - <simpara> - Der Port, den der Server zur Kommunikation benutzt. Bei - Standardinstallationen ist dies der Port - '<literal>80</literal>'. Bei Verwendung von SSH ändert sich der - Wert zu Ihrem definierten SSH Port. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_SIGNATURE</varname>'</term> - <listitem> - <simpara> - Ein String, der bei Seiten, die vom Server generiert wurden, die - Server Version und den Namen des virtuellen Hosts enthält, falls - diese Option aktiviert ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PATH_TRANSLATED</varname>'</term> - <listitem> - <simpara> - Filesystem- (not document root-) based path to the current - script, after the server has done any virtual-to-real - mapping. - </simpara> - <note> - <simpara> - As of PHP 4.3.2, <envar>PATH_TRANSLATED</envar> is no longer set - implicitly under the Apache 2 <acronym>SAPI</acronym> in contrast - to the situation in Apache 1, where it's set to the same value as - the <envar>SCRIPT_FILENAME</envar> server variable when it's not - populated by Apache. This change was made to comply with the - <acronym>CGI</acronym> specification that - <envar>PATH_TRANSLATED</envar> should only exist if - <envar>PATH_INFO</envar> is defined. - </simpara> - <simpara> - Apache 2 users may use <literal>AcceptPathInfo = On</literal> inside - <filename>httpd.conf</filename> to define <envar>PATH_INFO</envar>. - </simpara> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SCRIPT_NAME</varname>'</term> - <listitem> - <simpara> - Contains the current script's path. This is useful for pages - which need to point to themselves. - The <link linkend="language.constants.predefined">__FILE__</link> - constant contains the full path and filename of the current (i.e. - included) file. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_URI</varname>'</term> - <listitem> - <simpara> - The URI which was given in order to access this page; for - instance, '<literal>/index.html</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_DIGEST</varname>'</term> - <listitem> - <simpara> - When running under Apache as module doing Digest HTTP authentication - this variable is set to the 'Authorization' header sent by the - client (which you should then use to make the appropriate - validation). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_USER</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Benutzernamen, der vom Anwender - angegeben wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_PW</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable das Passwort, das vom Anwender angegeben - wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>AUTH_TYPE</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Authentifizierungs-Typ. - </simpara> - </listitem> - </varlistentry> - - </variablelist> - </para> - - </sect2> - - <sect2 xml:id="reserved.variables.environment"> - <title>Umgebungsvariablen: <varname>$_ENV</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_ENV_VARS</varname>. - </simpara> - </note> - - <simpara> - Diese Variablen werden aus der Systemumgebung, in der der Parser - läuft in den globalen Namensraum Von PHP importiert. Viele davon - werden vom System generiert, unter dem der Parser läuft und - unterschiedliche Systeme benutzen unterschiedliche - Umgebungsvariablen. Eine verbindliche Liste anzugeben ist daher - unmöglich. Schauen Sie in der Dokumentation Ihres Systems nach den - dort definierten Umgebungsvaraiblen. - </simpara> - - <simpara> - Andere Umgebungsvariablen einschließlich der CGI-Variablen, sind hier - aufgeführt, egal ob PHP als Servermodul oder CGI Prozess läuft. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_ENV;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_ENV_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_ENV_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_ENV_VARS</varname> und <varname>$_ENV</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_ENV</varname> und - <varname>$HTTP_ENV_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.cookies"> - <title>HTTP Cookies: <varname>$_COOKIE</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_COOKIE_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - HTTP-Cookies übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_COOKIE;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_COOKIE_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_COOKIE_VARS</varname> contains the same initial - information, but is not an autoglobal. (Note that - <varname>HTTP_COOKIE_VARS</varname> and <varname>$_COOKIE</varname> - are different variables and that PHP handles them as such) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_COOKIE</varname> und - <varname>$HTTP_COOKIE_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.get"> - <title>HTTP GET Variablen: <varname>$_GET</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_GET_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - der GET-Methode übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_GET;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_GET_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_GET_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_GET_VARS</varname> und <varname>$_GET</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_GET</varname> und - <varname>$HTTP_GET_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.post"> - <title>HTTP POST Variablen: <varname>$_POST</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_POST_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - der POST-Methode übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_POST;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_POST_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_POST_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_POST_VARS</varname> und <varname>$_POST</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_POST</varname> und - <varname>$HTTP_POST_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.files"> - <title>Variablen für HTTP Dateiuploads: <varname>$_FILES</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_POST_FILES</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Elementen, die in das aktuelle Skript - mit der HTTP-POST-Methode hochgeladen wurden. Es ist automatisch global - in allen Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_FILES;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_POST_FILES</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_POST_FILES</varname> enthält dieselben Informationen, - ist aber nicht autoglobal. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_FILES</varname> und - <varname>$HTTP_POST_FILES</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.request"> - <title>Variablen einer Anforderung: <varname>$_REQUEST</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 neu eingeführt. Es gibt kein - entsprechendes Array in älteren Versionen. - </simpara> - </note> - <note> - <simpara> - Vor der PHP Version 4.3.0 waren die Informationen des Arrays - <varname>$_FILES</varname> auch im Array - <varname>$_REQUEST</varname> enthalten. - </simpara> - </note> - - <simpara> - Ein assoziatives Aray, das die Inhalte der Arrays - <varname>$_GET</varname>, <varname>$_POST</varname> und - <varname>$_COOKIE</varname> enthält. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_REQUEST;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, - sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von dem Array <varname>$_REQUEST</varname>. - Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.session"> - <title>Session Variablen: <varname>$_SESSION</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_SESSION_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array, das die Sessionvariablen für das aktuelle - Skript enthält. Mehr über die Verwendung dieses Arrays finden Sie bei - der Dokumentation zu den <link linkend="ref.session">Session Funktionen</link>. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_SESSION;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_SESSION_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_SESSION_VARS</varname> enthält dieselben - Informationen, ist aber nicht automatisch global. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals"> - register_globals</link> gesetzt ist, - sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_SESSION</varname> - und <varname>$HTTP_SESSION_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.globals"> - <title>Globale Variablen: <varname>$GLOBALS</varname></title> - - <simpara> - Ein assoziatives Array, das Referenzen zu allen Variablen, die - gegenwärtig im globalen Gültigkeitsbereich des Skripts definiert - sind. Die Variablennamen sind die Indizes dieses Arrays. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $GLOBALS;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen. - </simpara> - - </sect2> - - <sect2 xml:id="reserved.variables.phperrormsg"> - <title>Die letzte Fehlermeldung: <varname>$php_errormsg</varname></title> - <simpara> - <varname>$php_errormsg</varname> ist eine Variable, die den Text der - zuletzt aufgetretenen PHP Fehlermeldung enthält. Hierauf kann nur in - dem Gültigkeitsbereich zugegriffen werden, in dem der Fehler auftrat, - und nur dann, wenn die Direktive <link - linkend="ini.track-errors">track_errors</link> - in der Konfiguration aktiviert ist (standardmäßig ist diese Direktive - deaktiviert). - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.httprawpostdata"> - <title>Raw POST data: <varname>$HTTP_RAW_POST_DATA</varname></title> - <para> - <varname>$HTTP_RAW_POST_DATA</varname> enthält die unverarbeiteten - POST Daten. - Siehe auch <link linkend="ini.always-populate-raw-post-data" - >always_populate_raw_post_data</link> - </para> - </sect2> - - <sect2 xml:id="reserved.variables.httpresponseheader"> - <title>HTTP Response Header: <varname>$http_response_header</varname></title> - <para> - Das <varname>$http_response_header</varname> Array ähnelt - der <function>get_headers</function> Funktion. Wenn der - <link linkend="wrappers.http">HTTP Wrapper</link> genutzt - wird wird die <varname>$http_response_header</varname> - Variable mit den HTTP Response Headern gefüllt. - </para> - </sect2> - </sect1> - <sect1 xml:id="reserved.classes"> <title>Vordefinierte Klassen</title>
http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/reserved.xml?r1=1.19&r2=1.20&diff_format=u Index: phpdoc-de/appendices/reserved.xml diff -u phpdoc-de/appendices/reserved.xml:1.19 phpdoc-de/appendices/reserved.xml:1.20 --- phpdoc-de/appendices/reserved.xml:1.19 Mon Mar 10 10:41:06 2008 +++ phpdoc-de/appendices/reserved.xml Mon Jun 16 03:58:50 2008 @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.19 $ --> +<!-- $Revision: 1.20 $ --> <!-- EN-Revision: 1.72 Maintainer: hholzgra Status: working --> <appendix xml:id="reserved" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -288,879 +288,6 @@ </table> </sect1> - <sect1 xml:id="reserved.variables"> - <title>Vordefinierte Variablen</title> - - <para> - Seit PHP 4.1.0 wird empfohlen, - <link linkend="language.variables.external">externe Variablen</link> - über die Superglobals, die weiter unten beschrieben werden, abzufragen. - Davor war man entweder auf die <link linkend="ini.register-globals">register_globals</link> - -Einstelliung oder die Langformen der vordefinierten PHP-Arrays - (<varname>$HTTP_*_VARS</varname>) angewiesen. - - - &avail.register-long-arrays; - </para> - - <sect2 xml:id="reserved.variables.server"> - <title>Server-Variablen: <varname>$_SERVER</varname></title> - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie stattdessen <varname>$HTTP_SERVER_VARS</varname>. - </simpara> - </note> - - <simpara> - <varname>$_SERVER</varname> ist ein Array, in dem Informationen über - Header, Pfade oder den Speicherort des Skripts gespeichert sind. Die - Einträge dieses Arrays werden vom Webserver generiert. Es gibt keine - Garantie, dass jeder Webserver alle diese Einträge erzeugt. Manche - Server werden Einträge auslassen oder andere einfügen, die hier - nicht aufgeführt sind. Ein grosser Teil dieser Variablen stammt aus - der <link xlink:href="&url.cgispec;">CGI 1.1 Spezifikation</link>. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_SERVER;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_SERVER_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_SERVER_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_SERVER_VARS</varname> und <varname>$_SERVER</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_SERVER</varname> - und <varname>$HTTP_SERVER_VARS</varname> Arrays. Lesen Sie für weitere - Informationen das Kapitel über Sicherheit - <link linkend="security.globals">Verwendung von Register Globals</link>. - Diese individuellen globalen Variablen sind nicht automatisch global. - </simpara> - - <simpara> - Möglicherweise finden Sie das eine oder andere der folgenden - Elemente nicht in <varname>$_SERVER</varname>. Beachten Sie, dass nur - wenige, falls überhaupt, verfügbar sind (oder von Bedeutung - sind) wenn sie PHP auf der Kommandozeile betreiben. - </simpara> - - <para> - <variablelist> - <varlistentry> - <term>'<varname>PHP_SELF</varname>'</term> - <listitem> - <simpara> - Der Name des aktuell ausgeführten Skripts, relativ zum - Wurzelverzeichnis des Servers. Zum Beispiel gibt - <varname>$_SERVER['PHP_SELF']</varname> in einem Skript mit der - Adresse <filename>http://example.com/test.php/foo.bar</filename> - den Namen <filename>/test.php/foo.bar</filename> zurück. - </simpara> - <simpara> - Falls PHP auf der Kommandozeile ausgeführt wird, ist diese - Variable nicht verfügbar. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>argv</varname>'</term> - <listitem> - <simpara> - In diesem Array sind die Argumente enthalten, die an ein Skript - übergeben wurden. Wenn das Skript auf der Kommandozeile - ausgeführt wird, haben Sie einen C-ähnlichen Zugriff auf die - Kommandozeilenparameter. Wenn es mit der GET-Methode - aufgerufen wird, enthält das Array den Abfragestring. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>argc</varname>'</term> - <listitem> - <simpara> - Enthält die Anzahl der Kommandozeilenparameter, die an das - Skript übergeben wurden (falls es von der Kommandozeile aus - aufgerufen wurde). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>GATEWAY_INTERFACE</varname>'</term> - <listitem> - <simpara> - Die vom Server genutzte Revision der CGI Spezifikation, - zB. '<literal>CGI/1.1</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_ADDR</varname>'</term> - <listitem> - <simpara> - Die IP-Adresse des Servers unter der das aktuelle Script - ausgeführt wird. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_NAME</varname>'</term> - <listitem> - <simpara> - Der Name des Server Hosts unter dem das aktuelle Skript - ausgeführt wird. Falls das Skript unter einem virtuellen Host - läuft, wird der Name, der für diesen virtuellen Host vergeben - wurde, angezeigt. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_SOFTWARE</varname>'</term> - <listitem> - <simpara> - Die Identifikation des Servers, mit der sich ein Server im - Header bei der Beantwortung einer Anforderung identifiziert. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_PROTOCOL</varname>'</term> - <listitem> - <simpara> - Name und Versionsnummer des Protokolls, über das die Seite - angefordert wurde. Z. B. '<literal>HTTP/1.0</literal>'; - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_METHOD</varname>'</term> - <listitem> - <simpara> - Die HTTP-Methode mit der auf die Seite zugegriffen wurde, zB. '<literal>GET</literal>', - '<literal>HEAD</literal>', '<literal>POST</literal>', '<literal>PUT</literal>'. - </simpara> - <note> - <para> - Ist die Zugriffsmethode <literal>HEAD</literal> so wird das Skript - nach dem Senden der Header (also mit der ersten nicht von der Ausgabepufferung - abgefangenen Ausgabe) beendet. - </para> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_TIME</varname>'</term> - <listitem> - <simpara> - Der Startzeitpunkt des Requests. Verfügbar seit PHP 5.1.0 - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>QUERY_STRING</varname>'</term> - <listitem> - <simpara> - Der Query-String, falls vorhanden, mit dem auf die Seite zugegriffen wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>DOCUMENT_ROOT</varname>'</term> - <listitem> - <simpara> - Das Wurzelverzeichnis des Webservers, unter dem das aktuelle - Skript ausgeführt wird, so wie es in der Konfigurationsdatei des - Webservers hinterlegt ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept:</literal>-Headers der aktuellen - Anforderung, falls dieser Header vorhanden ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Charset:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Z. B. - '<literal>iso-8859-1,*,utf-8</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_ENCODING</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Encoding:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Beispiel: - '<literal>gzip</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_ACCEPT_LANGUAGE</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Accept-Language:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Beispiel: - '<literal>en</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_CONNECTION</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Connection:</literal>-Headers der - aktuellen anforderung, so vorhanden. Beispiel: '<literal>Keep-Alive</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_HOST</varname>'</term> - <listitem> - <simpara> - Der Inhalt des <literal>Host:</literal>-Headers der aktuellen Anforderung, - so vorhanden. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_REFERER</varname>'</term> - <listitem> - <simpara> - Die Adresse der Seite (falls es eine gibt), die den Browser auf - die aktuelle Seite verwies. Dieser Header wird vom Browser - gesetzt, aber nicht von allen. Einige Browser bieten die - Möglichkeit, den <varname>HTTP_REFERER</varname> zu - modifizieren. Kurz, auf diesen Header kann man sich nicht - verlassen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTP_USER_AGENT</varname>'</term> - <listitem> - <simpara> - Inhald des <literal>User-Agent:</literal> Headers des - aktuellen Requests falls vorhanden. Dieser String beschreibt - den auf die Seite zugreifenden Client. Ein typisches Beispiel ist - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 i586)</computeroutput>. - Sie können diesen unter anderem im Zusammenhang mit der Funktion - <function>get_browser</function> benutzen um die Ausgaben Ihres - Scripts an die Fähigkeiten des Clients anzupassen. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>HTTPS</varname>'</term> - <listitem> - <simpara> - Dieser Eintrag ist gesetzt wenn der Zugriff auf das Script über das - HTTPS Protokoll erfolgte. - protocol. - </simpara> - <simpara> - Wenn das ISAPI des IIS genutzt wird so ist diese Variable auch bei - nicht-HTTPS Zugriffen gesetzt und enthält in diesem Fall den Wert - <literal>off</literal>. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_ADDR</varname>'</term> - <listitem> - <simpara> - Die IP-Adresse des Rechners, der die aktuelle Seite angefordert hat. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_HOST</varname>'</term> - <listitem> - <simpara> - Der Hostname des Servers, von dem die aktuelle Seite geladen - wurde. Der reverse dns lookup basiert auf dem - <varname>REMOTE_ADDR</varname>-Header. - </simpara> - <note> - <simpara> - Um diese Variable zu erzeugen, muss Ihr Webserver entsprechend - eingestellt sein. Zum Beispiel muss beim Apache - <literal>HostnameLookups On</literal> in der &httpd.conf; aktiv - sein. Siehe auch unter <function>gethostbyaddr</function>. - </simpara> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REMOTE_PORT</varname>'</term> - <listitem> - <simpara> - Der Port über den der Rechner des Benutzers mit dem Webserver - kommuniziert. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SCRIPT_FILENAME</varname>'</term> - <listitem> - <para> - Der absolute Pfadname des aktuell ausgeführten Skripts. - <note> - <para> - Falls das Skript auf der Kommandozeile mit einem relativen - Pfad aufgerufen wird, wie z. B. <filename>file.php</filename> - oder <filename>../file.php</filename>, enthält - <varname>$_SERVER['SCRIPT_FILENAME']</varname> den relativen - Pfad, den der Benutzer angegeben hat. - </para> - </note> - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_ADMIN</varname>'</term> - <listitem> - <simpara> - Der Wert, der in der Server Konfiguration der Direktive - SERVER_ADMIN (bei Apache) zugewiesen wurde. Falls das Skript - unter einem virtuellen Host läuft, wird der Wert angegeben, der - für diesen virtuellen Host angegeben wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_PORT</varname>'</term> - <listitem> - <simpara> - Der Port, den der Server zur Kommunikation benutzt. Bei - Standardinstallationen ist dies der Port - '<literal>80</literal>'. Bei Verwendung von SSH ändert sich der - Wert zu Ihrem definierten SSH Port. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SERVER_SIGNATURE</varname>'</term> - <listitem> - <simpara> - Ein String, der bei Seiten, die vom Server generiert wurden, die - Server Version und den Namen des virtuellen Hosts enthält, falls - diese Option aktiviert ist. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PATH_TRANSLATED</varname>'</term> - <listitem> - <simpara> - Filesystem- (not document root-) based path to the current - script, after the server has done any virtual-to-real - mapping. - </simpara> - <note> - <simpara> - As of PHP 4.3.2, <envar>PATH_TRANSLATED</envar> is no longer set - implicitly under the Apache 2 <acronym>SAPI</acronym> in contrast - to the situation in Apache 1, where it's set to the same value as - the <envar>SCRIPT_FILENAME</envar> server variable when it's not - populated by Apache. This change was made to comply with the - <acronym>CGI</acronym> specification that - <envar>PATH_TRANSLATED</envar> should only exist if - <envar>PATH_INFO</envar> is defined. - </simpara> - <simpara> - Apache 2 users may use <literal>AcceptPathInfo = On</literal> inside - <filename>httpd.conf</filename> to define <envar>PATH_INFO</envar>. - </simpara> - </note> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>SCRIPT_NAME</varname>'</term> - <listitem> - <simpara> - Contains the current script's path. This is useful for pages - which need to point to themselves. - The <link linkend="language.constants.predefined">__FILE__</link> - constant contains the full path and filename of the current (i.e. - included) file. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>REQUEST_URI</varname>'</term> - <listitem> - <simpara> - The URI which was given in order to access this page; for - instance, '<literal>/index.html</literal>'. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_DIGEST</varname>'</term> - <listitem> - <simpara> - When running under Apache as module doing Digest HTTP authentication - this variable is set to the 'Authorization' header sent by the - client (which you should then use to make the appropriate - validation). - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_USER</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Benutzernamen, der vom Anwender - angegeben wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>PHP_AUTH_PW</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable das Passwort, das vom Anwender angegeben - wurde. - </simpara> - </listitem> - </varlistentry> - - <varlistentry> - <term>'<varname>AUTH_TYPE</varname>'</term> - <listitem> - <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Authentifizierungs-Typ. - </simpara> - </listitem> - </varlistentry> - - </variablelist> - </para> - - </sect2> - - <sect2 xml:id="reserved.variables.environment"> - <title>Umgebungsvariablen: <varname>$_ENV</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_ENV_VARS</varname>. - </simpara> - </note> - - <simpara> - Diese Variablen werden aus der Systemumgebung, in der der Parser - läuft in den globalen Namensraum Von PHP importiert. Viele davon - werden vom System generiert, unter dem der Parser läuft und - unterschiedliche Systeme benutzen unterschiedliche - Umgebungsvariablen. Eine verbindliche Liste anzugeben ist daher - unmöglich. Schauen Sie in der Dokumentation Ihres Systems nach den - dort definierten Umgebungsvaraiblen. - </simpara> - - <simpara> - Andere Umgebungsvariablen einschließlich der CGI-Variablen, sind hier - aufgeführt, egal ob PHP als Servermodul oder CGI Prozess läuft. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_ENV;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_ENV_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_ENV_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_ENV_VARS</varname> und <varname>$_ENV</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_ENV</varname> und - <varname>$HTTP_ENV_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.cookies"> - <title>HTTP Cookies: <varname>$_COOKIE</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_COOKIE_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - HTTP-Cookies übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_COOKIE;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_COOKIE_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_COOKIE_VARS</varname> contains the same initial - information, but is not an autoglobal. (Note that - <varname>HTTP_COOKIE_VARS</varname> and <varname>$_COOKIE</varname> - are different variables and that PHP handles them as such) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_COOKIE</varname> und - <varname>$HTTP_COOKIE_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.get"> - <title>HTTP GET Variablen: <varname>$_GET</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_GET_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - der GET-Methode übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_GET;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_GET_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_GET_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_GET_VARS</varname> und <varname>$_GET</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_GET</varname> und - <varname>$HTTP_GET_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.post"> - <title>HTTP POST Variablen: <varname>$_POST</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_POST_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Variablen, das an das aktuelle Skript mit - der POST-Methode übergeben wurde. Es ist automatisch global in allen - Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_POST;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_POST_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_POST_VARS</varname> enthält dieselben Informationen - ist aber nicht automatisch global. (Beachten Sie, dass - <varname>$HTTP_POST_VARS</varname> und <varname>$_POST</varname> - verschiedene Variablen sind, die von PHP auch so behandelt werden.) - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_POST</varname> und - <varname>$HTTP_POST_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.files"> - <title>Variablen für HTTP Dateiuploads: <varname>$_FILES</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_POST_FILES</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array mit Elementen, die in das aktuelle Skript - mit der HTTP-POST-Methode hochgeladen wurden. Es ist automatisch global - in allen Gültigkeitsbereichen. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_FILES;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_POST_FILES</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_POST_FILES</varname> enthält dieselben Informationen, - ist aber nicht autoglobal. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_FILES</varname> und - <varname>$HTTP_POST_FILES</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.request"> - <title>Variablen einer Anforderung: <varname>$_REQUEST</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 neu eingeführt. Es gibt kein - entsprechendes Array in älteren Versionen. - </simpara> - </note> - <note> - <simpara> - Vor der PHP Version 4.3.0 waren die Informationen des Arrays - <varname>$_FILES</varname> auch im Array - <varname>$_REQUEST</varname> enthalten. - </simpara> - </note> - - <simpara> - Ein assoziatives Aray, das die Inhalte der Arrays - <varname>$_GET</varname>, <varname>$_POST</varname> und - <varname>$_COOKIE</varname> enthält. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_REQUEST;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals">register_globals</link> - gesetzt ist, - sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von dem Array <varname>$_REQUEST</varname>. - Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.session"> - <title>Session Variablen: <varname>$_SESSION</varname></title> - - <note> - <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_SESSION_VARS</varname>. - </simpara> - </note> - - <simpara> - Ein assoziatives Array, das die Sessionvariablen für das aktuelle - Skript enthält. Mehr über die Verwendung dieses Arrays finden Sie bei - der Dokumentation zu den <link linkend="ref.session">Session Funktionen</link>. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $_SESSION;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen, so wie es bei - <varname>$HTTP_SESSION_VARS</varname> notwendig ist. - </simpara> - - <simpara> - <varname>$HTTP_SESSION_VARS</varname> enthält dieselben - Informationen, ist aber nicht automatisch global. - </simpara> - - <simpara> - Falls die Direktive <link linkend="ini.register-globals"> - register_globals</link> gesetzt ist, - sind diese Variablen auch im globalen Sichbarkeitsbereich eines - Skripts verfügbar, d.h., unabhängig von den <varname>$_SESSION</varname> - und <varname>$HTTP_SESSION_VARS</varname> - Arrays. Lesen Sie für weitere Informationen das Kapitel über - Sicherheit <link linkend="security.globals">Verwendung von - Register Globals</link>. Diese individuellen globalen Variablen - sind nicht automatisch global. - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.globals"> - <title>Globale Variablen: <varname>$GLOBALS</varname></title> - - <simpara> - Ein assoziatives Array, das Referenzen zu allen Variablen, die - gegenwärtig im globalen Gültigkeitsbereich des Skripts definiert - sind. Die Variablennamen sind die Indizes dieses Arrays. - </simpara> - - <simpara> - Dies ist eine 'superglobale' oder automatisch globale Variable. Das - bedeutet, dass die Variable in allen Sichtbarkeitsbereichen eines - Skripts verfügbar ist. Sie brauchen dieses Array nicht mit - <command>global $GLOBALS;</command> in Funktionen oder Methoden - importieren, um darauf zuzugreifen. - </simpara> - - </sect2> - - <sect2 xml:id="reserved.variables.phperrormsg"> - <title>Die letzte Fehlermeldung: <varname>$php_errormsg</varname></title> - <simpara> - <varname>$php_errormsg</varname> ist eine Variable, die den Text der - zuletzt aufgetretenen PHP Fehlermeldung enthält. Hierauf kann nur in - dem Gültigkeitsbereich zugegriffen werden, in dem der Fehler auftrat, - und nur dann, wenn die Direktive <link - linkend="ini.track-errors">track_errors</link> - in der Konfiguration aktiviert ist (standardmäßig ist diese Direktive - deaktiviert). - </simpara> - </sect2> - - <sect2 xml:id="reserved.variables.httprawpostdata"> - <title>Raw POST data: <varname>$HTTP_RAW_POST_DATA</varname></title> - <para> - <varname>$HTTP_RAW_POST_DATA</varname> enthält die unverarbeiteten - POST Daten. - Siehe auch <link linkend="ini.always-populate-raw-post-data" - >always_populate_raw_post_data</link> - </para> - </sect2> - - <sect2 xml:id="reserved.variables.httpresponseheader"> - <title>HTTP Response Header: <varname>$http_response_header</varname></title> - <para> - Das <varname>$http_response_header</varname> Array ähnelt - der <function>get_headers</function> Funktion. Wenn der - <link linkend="wrappers.http">HTTP Wrapper</link> genutzt - wird wird die <varname>$http_response_header</varname> - Variable mit den HTTP Response Headern gefüllt. - </para> - </sect2> - </sect1> - <sect1 xml:id="reserved.classes"> <title>Vordefinierte Klassen</title>