cvs: phpdoc-de /appendices reserved.xml
| From: | Hartmut Holzgraefe | Date: | Wed, 21 Mar 2007 17:57:07 +0000 |
| Subject: | cvs: phpdoc-de /appendices reserved.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2082@lists.php.net to get a copy of this message | ||
hholzgra Wed Mar 21 17:57:07 2007 UTC
Modified files:
/phpdoc-de/appendices reserved.xml
Log:
translation update (work in progres)
http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/reserved.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-de/appendices/reserved.xml diff -u phpdoc-de/appendices/reserved.xml:1.13 phpdoc-de/appendices/reserved.xml:1.14 --- phpdoc-de/appendices/reserved.xml:1.13 Sat Jan 20 13:22:55 2007 +++ phpdoc-de/appendices/reserved.xml Wed Mar 21 17:57:06 2007 @@ -1,29 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.37 Maintainer: mk Status: ready --> - +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.64 Maintainer: hholzgra Status: working --> + <appendix id="reserved"> - <title>Reservierte Wörter in PHP</title> + <title>Liste der reservierten Wörter</title> <para> - Nachfolgend finden Sie eine Liste der vordefinierten Namen in PHP. - Sie sollten keinen dieser Namen in Ihren Skripten verwenden. Die Liste - enthält Schlüsselwörter, vordefinierte Konstanten und Klassennamen. - Die Liste ist nicht vollständig. + Die folgenden Listen enthält in PHP vordefinierten Bezeichner. + Sie sollten die reservierten Worte aus diesen Listen keinesfalls + in eigenen Scripten als Bezeichner benutzen. Die Listen enthält + Schlüsselworte, vordefinierte Variablen, Konstanten und Klassennamen. + Beachten Sie bitte auch das diese Listen nicht unbedingt vollständig + sind. </para> <sect1 id="reserved.keywords"> - <title>Liste der Schlüsselwörter</title> + <title>Liste der Schlüsselworte</title> <simpara> - Diese Wörter haben in PHP eine spezielle Bedeutung. Einige sehen aus - wie Funktionen, andere sehen aus wie Konstanten usw., sie sind aber - weder das eine noch das andere, sondern es sind Sprachkonstrukte. Sie - können keines der folgenden Wörter als Namen für Konstanten, Klassen - oder Funktionen benutzen. Als Vaiablennamen dürfen Sie die Namen - benutzen, was aber zu Verwirrungen führen kann. + Die folgenden Begriffe haben in PHP eine spezielle Bedeutung. + Einige von ihnen sehen aus wie Funktionen, Konstanten usw., + in Wirklichkeit handelt es sich aber um Sprachkonstrukte. + Keines der folgenden Worte kann als Name für eine benutzerdefinierte + Konstante, Klasse, Funktion oder Methode genutzt werden. Die Nutzung + als Variablenname ist in der Regel möglich, sollte aber unterlassen + werden um Verwirrung zu vermeiden. </simpara> <table> - <title>PHP Schlüsselwörter</title> + <title>PHP Schlüsselworte</title> <tgroup cols="5"> <tbody> <row> @@ -40,10 +43,7 @@ <link linkend="language.constants.predefined">__FILE__</link> </entry> <entry> - <link linkend="reserved.classes.php5">exception</link> - </entry> - <entry> - <link linkend="reserved.classes.php5">php_user_filter</link> + <link linkend="reserved.classes.php5">exception</link> (PHP 5) </entry> </row> <row> @@ -65,13 +65,10 @@ </row> <row> <entry> - <link linkend="migration.old-function">cfunction</link> - </entry> - <entry> <link linkend="keyword.class">class</link> </entry> <entry> - const + <link linkend="language.oop5.constants">const</link> </entry> <entry> <link linkend="control-structures.continue">continue</link> @@ -79,11 +76,11 @@ <entry> <link linkend="control-structures.declare">declare</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.switch">default</link> </entry> + </row> + <row> <entry> <function>die</function> </entry> @@ -96,11 +93,11 @@ <entry> <link linkend="control-structures.else">else</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.elseif">elseif</link> </entry> + </row> + <row> <entry> <function>empty</function> </entry> @@ -113,11 +110,11 @@ <entry> <link linkend="control-structures.alternative-syntax">endforeach</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.alternative-syntax">endif</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.alternative-syntax">endswitch</link> </entry> @@ -125,16 +122,16 @@ <link linkend="control-structures.alternative-syntax">endwhile</link> </entry> <entry> - <link linkend="function.eval">eval</link> + <function>eval</function> </entry> <entry> <function>exit</function> </entry> - </row> - <row> <entry> <link linkend="keyword.class">extends</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.for">for</link> </entry> @@ -147,11 +144,11 @@ <entry> <link linkend="language.variables.scope">global</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.if">if</link> </entry> + </row> + <row> <entry> <function>include</function> </entry> @@ -164,14 +161,11 @@ <entry> <function>list</function> </entry> - </row> - <row> <entry> <link linkend="keyword.class">new</link> </entry> - <entry> - <link linkend="migration.old-function">old_function</link> - </entry> + </row> + <row> <entry> <function>print</function> </entry> @@ -181,14 +175,14 @@ <entry> <function>require_once</function> </entry> - </row> - <row> <entry> <function>return</function> </entry> <entry> <link linkend="language.variables.scope">static</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.switch">switch</link> </entry> @@ -198,14 +192,14 @@ <entry> use </entry> - </row> - <row> <entry> <link linkend="keyword.class">var</link> </entry> <entry> <link linkend="control-structures.while">while</link> </entry> + </row> + <row> <entry> <link linkend="language.constants.predefined">__FUNCTION__</link> </entry> @@ -215,6 +209,62 @@ <entry> <link linkend="language.constants.predefined">__METHOD__</link> </entry> + <entry> + <link linkend="language.oop5.final">final</link> (PHP 5) + </entry> + <entry> + <link linkend="reserved.classes.php5">php_user_filter</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.oop5.interfaces">interface</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.interfaces">implements</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.basic">extends</link> + </entry> + <entry> + <link linkend="language.oop5.visibility">public</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.visibility">private</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.oop5.visibility">protected</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.abstract">abstract</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.cloning">clone</link> (PHP 5) + </entry> + <entry> + <link linkend="language.exceptions">try</link> (PHP 5) + </entry> + <entry> + <link linkend="language.exceptions">catch</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.exceptions">throw</link> (PHP 5) + </entry> + <entry> + <link linkend="migration.old-function">cfunction</link> (PHP 4 only) + </entry> + <entry> + <link linkend="migration.old-function">old_function</link> (PHP 4 only) + </entry> + <entry> + <link linkend="keyword.class">this</link> (PHP 5 only) + </entry> + <entry> + </entry> </row> </tbody> </tgroup> @@ -225,67 +275,65 @@ <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. - - + Since PHP 4.1.0, the preferred method for retrieving + <link linkend="language.variables.external">external variables</link> is + with the superglobals mentioned below. Before this time, people relied + on either <link linkend="ini.register-globals">register_globals</link> + or the long predefined PHP arrays (<varname>$HTTP_*_VARS</varname>). + &avail.register-long-arrays; </para> <sect2 id="reserved.variables.server"> - <title>Server Variablen: <varname>$_SERVER</varname></title> + <title>Server variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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 <ulink url="&url.cgispec;">CGI 1.1 Spezifikation</ulink>. + <varname>$_SERVER</varname> is an array containing information + such as headers, paths, and script locations. The entries in this + array are created by the web server. There is no guarantee that + every web server will provide any of these; servers may omit some, + or provide others not listed here. That said, a large number of + these variables are accounted for in the <ulink + url="&url.cgispec;">CGI 1.1 specification</ulink>, so you should + be able to expect those. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_SERVER;</command> to access it within functions or methods, as + you do with <varname>$HTTP_SERVER_VARS</varname>. </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.) + <varname>$HTTP_SERVER_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_SERVER_VARS</varname> and <varname>$_SERVER</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_SERVER</varname> and <varname>$HTTP_SERVER_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </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. + You may or may not find any of the following elements in + $_SERVER. Note that few, if any, of these will be available (or + indeed have any meaning) if running PHP on the command line. </simpara> <para> @@ -294,15 +342,18 @@ <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. + The filename of the currently executing script, relative to + the document root. For instance, + <varname>$_SERVER['PHP_SELF']</varname> in a script at the + address <filename>http://example.com/test.php/foo.bar</filename> + would be <filename>/test.php/foo.bar</filename>. + The <link linkend="language.constants.predefined">__FILE__</link> + constant contains the full path and filename of the current (i.e. + included) file. </simpara> <simpara> - Falls PHP auf der Kommandozeile ausgeführt wird, ist diese - Variable nicht verfügbar. + If PHP is running as a command-line processor this variable contains + the script name since PHP 4.3.0. Previously it was not available. </simpara> </listitem> </varlistentry> @@ -311,11 +362,10 @@ <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. + Array of arguments passed to the script. When the script is + run on the command line, this gives C-style access to the + command line parameters. When called via the GET method, this + will contain the query string. </simpara> </listitem> </varlistentry> @@ -324,19 +374,28 @@ <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). + Contains the number of command line parameters passed to the + script (if run on the command line). </simpara> </listitem> </varlistentry> - + <varlistentry> <term>'<varname>GATEWAY_INTERFACE</varname>'</term> <listitem> <simpara> - Gibt an, welche Version der CGI Spezifikation der Server - benutzt, beispielsweise '<literal>CGI/1.1</literal>'. + What revision of the CGI specification the server is using; + i.e. '<literal>CGI/1.1</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_ADDR</varname>'</term> + <listitem> + <simpara> + The IP address of the server under which the current script is + executing. </simpara> </listitem> </varlistentry> @@ -345,10 +404,9 @@ <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. + The name of the server host under which the current script is + executing. If the script is running on a virtual host, this + will be the value defined for that virtual host. </simpara> </listitem> </varlistentry> @@ -357,8 +415,8 @@ <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. + Server identification string, given in the headers when + responding to requests. </simpara> </listitem> </varlistentry> @@ -367,8 +425,8 @@ <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>'; + Name and revision of the information protocol via which the + page was requested; i.e. '<literal>HTTP/1.0</literal>'; </simpara> </listitem> </varlistentry> @@ -377,19 +435,33 @@ <term>'<varname>REQUEST_METHOD</varname>'</term> <listitem> <simpara> - Welche Anforderungsmethode benutzt wurde, um auf die Seite - zuzugreifen, z. B. '<literal>GET</literal>', + Which request method was used to access the page; i.e. '<literal>GET</literal>', '<literal>HEAD</literal>', '<literal>POST</literal>', '<literal>PUT</literal>'. </simpara> + <note> + <para> + PHP script is terminated after sending headers (it means after + producing any output without output buffering) if the request method + was <literal>HEAD</literal>. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REQUEST_TIME</varname>'</term> + <listitem> + <simpara> + The timestamp of the start of the request. Available since PHP 5.1.0. + </simpara> </listitem> </varlistentry> - + <varlistentry> <term>'<varname>QUERY_STRING</varname>'</term> <listitem> <simpara> - Der Abfragestring, falls vorhanden, mit dem die Seite - angefordert wurde. + The query string, if any, via which the page was accessed. </simpara> </listitem> </varlistentry> @@ -398,9 +470,8 @@ <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. + The document root directory under which the current script is + executing, as defined in the server's configuration file. </simpara> </listitem> </varlistentry> @@ -409,8 +480,8 @@ <term>'<varname>HTTP_ACCEPT</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Accept:</literal>-Headers der aktuellen - Anforderung, falls dieser Header vorhanden ist. + Contents of the <literal>Accept:</literal> header from the + current request, if there is one. </simpara> </listitem> </varlistentry> @@ -419,8 +490,8 @@ <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Accept-Charset:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Z. B. + Contents of the <literal>Accept-Charset:</literal> header + from the current request, if there is one. Example: '<literal>iso-8859-1,*,utf-8</literal>'. </simpara> </listitem> @@ -430,9 +501,8 @@ <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>'. + Contents of the <literal>Accept-Encoding:</literal> header + from the current request, if there is one. Example: '<literal>gzip</literal>'. </simpara> </listitem> </varlistentry> @@ -441,9 +511,8 @@ <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>'. + Contents of the <literal>Accept-Language:</literal> header + from the current request, if there is one. Example: '<literal>en</literal>'. </simpara> </listitem> </varlistentry> @@ -452,8 +521,8 @@ <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>'. + Contents of the <literal>Connection:</literal> header from + the current request, if there is one. Example: '<literal>Keep-Alive</literal>'. </simpara> </listitem> </varlistentry> @@ -462,8 +531,8 @@ <term>'<varname>HTTP_HOST</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Host:</literal>-Headers der aktuellen Anforderung, - so vorhanden. + Contents of the <literal>Host:</literal> header from the + current request, if there is one. </simpara> </listitem> </varlistentry> @@ -472,12 +541,11 @@ <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. + The address of the page (if any) which referred the user + agent to the current page. This is set by the user agent. Not + all user agents will set this, and some provide the ability + to modify <varname>HTTP_REFERER</varname> as a feature. In + short, it cannot really be trusted. </simpara> </listitem> </varlistentry> @@ -486,14 +554,29 @@ <term>'<varname>HTTP_USER_AGENT</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>User_Agent:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Dies ist ein String, der - den Typ und Namen des Browsers angibt, der auf die Seite - zugreift. Ein typisches Beispiel ist: - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 - i586)</computeroutput>. Unter anderem kann man diesen Wert mit - <function>get_browser</function> auslesen, um die Ausgabe einer - Seite auf den verwendeten Browser abzustimmen. + Contents of the <literal>User-Agent:</literal> header from + the current request, if there is one. This is a string + denoting the user agent being which is accessing the page. A + typical example is: <computeroutput>Mozilla/4.5 [en] (X11; U; + Linux 2.2.9 i586)</computeroutput>. Among other things, you + can use this value with <function>get_browser</function> to + tailor your page's output to the capabilities of the user + agent. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTPS</varname>'</term> + <listitem> + <simpara> + Set to a non-empty value if the script was queried through the HTTPS + protocol. + </simpara> + <simpara> + Note that when using ISAPI with IIS, the value will be + <literal>off</literal> if the request was not made through the HTTPS + protocol. </simpara> </listitem> </varlistentry> @@ -502,7 +585,8 @@ <term>'<varname>REMOTE_ADDR</varname>'</term> <listitem> <simpara> - Die IP-Adresse des Rechners, der die aktuelle Seite angefordert hat. + The IP address from which the user is viewing the current + page. </simpara> </listitem> </varlistentry> @@ -511,16 +595,16 @@ <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. + The Host name from which the user is viewing the current + page. The reverse dns lookup is based off the + <varname>REMOTE_ADDR</varname> of the user. </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>. + Your web server must be configured to create this variable. For + example in Apache you'll need <literal>HostnameLookups On</literal> + inside &httpd.conf; for it to exist. See also + <function>gethostbyaddr</function>. </simpara> </note> </listitem> @@ -530,8 +614,8 @@ <term>'<varname>REMOTE_PORT</varname>'</term> <listitem> <simpara> - Der Port, Über den der Rechner des Benutzers mit dem Webserver - kommuniziert. + The port being used on the user's machine to communicate with + the web server. </simpara> </listitem> </varlistentry> @@ -540,14 +624,14 @@ <term>'<varname>SCRIPT_FILENAME</varname>'</term> <listitem> <para> - Der absolute Pfadname des aktuell ausgeführten Skripts. + The absolute pathname of the currently executing script. <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. + If a script is executed with the CLI, as a relative path, + such as <filename>file.php</filename> or + <filename>../file.php</filename>, + <varname>$_SERVER['SCRIPT_FILENAME']</varname> will + contain the relative path specified by the user. </para> </note> </para> @@ -558,10 +642,10 @@ <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. + The value given to the SERVER_ADMIN (for Apache) directive in + the web server configuration file. If the script is running + on a virtual host, this will be the value defined for that + virtual host. </simpara> </listitem> </varlistentry> @@ -570,10 +654,10 @@ <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. + The port on the server machine being used by the web server + for communication. For default setups, this will be '<literal>80</literal>'; + using SSL, for instance, will change this to whatever your + defined secure HTTP port is. </simpara> </listitem> </varlistentry> @@ -582,9 +666,8 @@ <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. + String containing the server version and virtual host name + which are added to server-generated pages, if enabled. </simpara> </listitem> </varlistentry> @@ -593,10 +676,26 @@ <term>'<varname>PATH_TRANSLATED</varname>'</term> <listitem> <simpara> - Der Pfad zur aktuellen Datei im Dateisystem (nicht relativ zum - Wurzelverzeichnis des Webserbers), nachdem der Server eventuelle - Umwandlungen vom virtuellen ins reale System vorgenommen hat. + 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> @@ -604,8 +703,11 @@ <term>'<varname>SCRIPT_NAME</varname>'</term> <listitem> <simpara> - Enthält den Pfad des aktuellen Skripts. Das ist nützlich für - Programme, die sich selber referenzieren. + 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> @@ -614,7 +716,20 @@ <term>'<varname>REQUEST_URI</varname>'</term> <listitem> <simpara> - Der URI mit dem diese Seite aufgerufen wurde. Z. B. '<literal>/index.html</literal>'. + 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> @@ -623,9 +738,9 @@ <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. + When running under Apache or IIS (ISAPI on PHP 5) as module doing + HTTP authentication this variable is set to the username provided by + the user. </simpara> </listitem> </varlistentry> @@ -634,9 +749,9 @@ <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. + When running under Apache or IIS (ISAPI on PHP 5) as module doing + HTTP authentication this variable is set to the password provided by + the user. </simpara> </listitem> </varlistentry> @@ -645,66 +760,66 @@ <term>'<varname>AUTH_TYPE</varname>'</term> <listitem> <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Authentifizierungs-Typ. + When running under Apache as module doing HTTP authenticated this + variable is set to the authentication type. </simpara> </listitem> </varlistentry> </variablelist> </para> + </sect2> <sect2 id="reserved.variables.environment"> - <title>Umgebungsvariablen: <varname>$_ENV</varname></title> + <title>Environment variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + These variables are imported into PHP's global namespace from the + environment under which the PHP parser is running. Many are + provided by the shell under which PHP is running and different + systems are likely running different kinds of shells, a + definitive list is impossible. Please see your shell's + documentation for a list of defined environment variables. </simpara> <simpara> - Andere Umgebungsvariablen einschließlich der CGI-Variablen, sind hier - aufgeführt, egal ob PHP als Servermodul oder CGI Prozess läuft. + Other environment variables include the CGI variables, placed + there regardless of whether PHP is running as a server module or + CGI processor. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_ENV;</command> to access it within functions or methods, as + you do with <varname>$HTTP_ENV_VARS</varname>. </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.) + <varname>$HTTP_ENV_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_ENV_VARS</varname> and <varname>$_ENV</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_ENV</varname> and <varname>$HTTP_ENV_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> @@ -713,309 +828,305 @@ <note> <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_COOKIE_VARS</varname>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via HTTP cookies. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_COOKIE;</command> to access it within functions or methods, as + you do with <varname>$HTTP_COOKIE_VARS</varname>. </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> + information, but is not a superglobal. (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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_COOKIE</varname> and <varname>$HTTP_COOKIE_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.get"> - <title>HTTP GET Variablen: <varname>$_GET</varname></title> + <title>HTTP GET variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via the HTTP GET method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_GET;</command> to access it within functions or methods, as + you do with <varname>$HTTP_GET_VARS</varname>. </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.) + <varname>$HTTP_GET_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_GET_VARS</varname> and <varname>$_GET</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_GET</varname> and <varname>$HTTP_GET_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.post"> - <title>HTTP POST Variablen: <varname>$_POST</varname></title> + <title>HTTP POST variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via the HTTP POST method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_POST;</command> to access it within functions or methods, as + you do with <varname>$HTTP_POST_VARS</varname>. </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.) + <varname>$HTTP_POST_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_POST_VARS</varname> and <varname>$_POST</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_POST</varname> and <varname>$HTTP_POST_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.files"> - <title>Variablen für HTTP Dateiuploads: <varname>$_FILES</varname></title> + <title>HTTP File upload variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of items uploaded to the current script + via the HTTP POST method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_FILES;</command> to access it within functions or methods, as + you do with <varname>$HTTP_POST_FILES</varname>. </simpara> <simpara> - <varname>$HTTP_POST_FILES</varname> enthält dieselben Informationen, - ist aber nicht autoglobal. + <varname>$HTTP_POST_FILES</varname> contains the same + information, but is not a superglobal. (Note that + <varname>$HTTP_POST_FILES</varname> and <varname>$_FILES</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_FILES</varname> and <varname>$HTTP_POST_FILES</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.request"> - <title>Variablen einer Anforderung: <varname>$_REQUEST</varname></title> + <title>Request variables: <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. + Introduced in 4.1.0. There is no equivalent array in earlier + versions. </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. + Prior to PHP 4.3.0, <varname>$_FILES</varname> information was + also included in <varname>$_REQUEST</varname>. </simpara> </note> <simpara> - Ein assoziatives Aray, das die Inhalte der Arrays - <varname>$_GET</varname>, <varname>$_POST</varname> und - <varname>$_COOKIE</varname> enthält. + An associative array consisting of the contents of + <varname>$_GET</varname>, <varname>$_POST</varname>, + and <varname>$_COOKIE</varname>. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_REQUEST;</command> to access it within functions or methods. </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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_REQUEST</varname> array. For related information, see + the security chapter titled <link + linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.session"> - <title>Session Variablen: <varname>$_SESSION</varname></title> + <title>Session variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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>. + An associative array containing session variables available to + the current script. See the <link linkend="ref.session">Session + functions</link> documentation for more information on how this + is used. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_SESSION;</command> to access it within functions or methods, as + you do with <varname>$HTTP_SESSION_VARS</varname>. </simpara> <simpara> - <varname>$HTTP_SESSION_VARS</varname> enthält dieselben - Informationen, ist aber nicht automatisch global. + <varname>$HTTP_SESSION_VARS</varname> contains the same + information, but is not a superglobal. (Note that + <varname>$HTTP_SESSION_VARS</varname> and <varname>$_SESSION</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_SESSION</varname> and <varname>$HTTP_SESSION_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.globals"> - <title>Globale Variablen: <varname>$GLOBALS</varname></title> + <title>Global variables: <varname>$GLOBALS</varname></title> <note> <simpara> - <varname>$GLOBALS</varname> steht seit PHP 3.0.0 zur Verfügung. + <varname>$GLOBALS</varname> has been available since PHP 3.0.0. </simpara> </note> <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. + An associative array containing references to all variables which + are currently defined in the global scope of the script. The + variable names are the keys of the array. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $GLOBALS;</command> to access it within functions or methods. </simpara> </sect2> <sect2 id="reserved.variables.phperrormsg"> - <title>Die letzte Fehlermeldung: <varname>$php_errormsg</varname></title> + <title>The previous error message: <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). + <varname>$php_errormsg</varname> is a variable containing the + text of the last error message generated by PHP. This variable + will only be available within the scope in which the error + occurred, and only if the <link + linkend="ini.track-errors">track_errors</link> configuration + option is turned on (it defaults to off). </simpara> </sect2> </sect1> <sect1 id="reserved.classes"> - <title>Vordefinierte Klassen</title> + <title>Predefined Classes</title> + <para> + This section lists standard predefined classes. Miscellaneous extensions + define other classes which are described in their reference. + </para> <sect2 id="reserved.classes.standard"> - <title>Standardmäßig definierte Klassen</title> + <title>Standard Defined Classes</title> <simpara> - Diese Klassen sind im Standard Funktionsumfang einer PHP Distribution enthalten. + These classes are defined in the standard set of functions included + in the PHP build. </simpara> <variablelist> @@ -1023,7 +1134,7 @@ <term><classname>Directory</classname></term> <listitem> <simpara> - Die Klasse, aus der <link linkend="class.dir">dir</link> instantiiert wird. + The class from which <link linkend="class.dir">dir</link> is instantiated. </simpara> </listitem> </varlistentry> @@ -1045,11 +1156,11 @@ </sect2> <sect2 id="reserved.classes.php5"> - <title>Vordefinierte Klassen in PHP 5</title> + <title>Predefined classes as of PHP 5</title> <simpara> - Diese zusätzlichen vordefinierten Klassen wurden mit PHP 5.0.0 - eingeführt. + These additional predefined classes were introduced in + PHP 5.0.0 </simpara> <variablelist> @@ -1070,167 +1181,6 @@ </variablelist> </sect2> - <sect2 id="reserved.classes.ming"> - <title>Definierte <link linkend="ref.ming">Ming</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.ming">Ming</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>swfshape</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swffill</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfgradient</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfbitmap</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swftext</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swftextfield</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swffont</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfdisplayitem</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfmovie</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfbutton</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfaction</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfmorph</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfsprite</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="reserved.classes.oci8"> - <title>Definierte <link linkend="ref.oci8">Oracle 8</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.oci8">Oracle 8</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>OCI-Lob</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>OCI-Collection</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="reserved.classes.qtdom"> - <title>Definierte <link linkend="ref.qtdom">qtdom</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.qtdom">qtdom</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>QDomDocument</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>QDomNode</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> &appendices.reserved.constants;
http://cvs.php.net/viewvc.cgi/phpdoc-de/appendices/reserved.xml?r1=1.13&r2=1.14&diff_format=u Index: phpdoc-de/appendices/reserved.xml diff -u phpdoc-de/appendices/reserved.xml:1.13 phpdoc-de/appendices/reserved.xml:1.14 --- phpdoc-de/appendices/reserved.xml:1.13 Sat Jan 20 13:22:55 2007 +++ phpdoc-de/appendices/reserved.xml Wed Mar 21 17:57:06 2007 @@ -1,29 +1,32 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.13 $ --> -<!-- EN-Revision: 1.37 Maintainer: mk Status: ready --> - +<!-- $Revision: 1.14 $ --> +<!-- EN-Revision: 1.64 Maintainer: hholzgra Status: working --> + <appendix id="reserved"> - <title>Reservierte Wörter in PHP</title> + <title>Liste der reservierten Wörter</title> <para> - Nachfolgend finden Sie eine Liste der vordefinierten Namen in PHP. - Sie sollten keinen dieser Namen in Ihren Skripten verwenden. Die Liste - enthält Schlüsselwörter, vordefinierte Konstanten und Klassennamen. - Die Liste ist nicht vollständig. + Die folgenden Listen enthält in PHP vordefinierten Bezeichner. + Sie sollten die reservierten Worte aus diesen Listen keinesfalls + in eigenen Scripten als Bezeichner benutzen. Die Listen enthält + Schlüsselworte, vordefinierte Variablen, Konstanten und Klassennamen. + Beachten Sie bitte auch das diese Listen nicht unbedingt vollständig + sind. </para> <sect1 id="reserved.keywords"> - <title>Liste der Schlüsselwörter</title> + <title>Liste der Schlüsselworte</title> <simpara> - Diese Wörter haben in PHP eine spezielle Bedeutung. Einige sehen aus - wie Funktionen, andere sehen aus wie Konstanten usw., sie sind aber - weder das eine noch das andere, sondern es sind Sprachkonstrukte. Sie - können keines der folgenden Wörter als Namen für Konstanten, Klassen - oder Funktionen benutzen. Als Vaiablennamen dürfen Sie die Namen - benutzen, was aber zu Verwirrungen führen kann. + Die folgenden Begriffe haben in PHP eine spezielle Bedeutung. + Einige von ihnen sehen aus wie Funktionen, Konstanten usw., + in Wirklichkeit handelt es sich aber um Sprachkonstrukte. + Keines der folgenden Worte kann als Name für eine benutzerdefinierte + Konstante, Klasse, Funktion oder Methode genutzt werden. Die Nutzung + als Variablenname ist in der Regel möglich, sollte aber unterlassen + werden um Verwirrung zu vermeiden. </simpara> <table> - <title>PHP Schlüsselwörter</title> + <title>PHP Schlüsselworte</title> <tgroup cols="5"> <tbody> <row> @@ -40,10 +43,7 @@ <link linkend="language.constants.predefined">__FILE__</link> </entry> <entry> - <link linkend="reserved.classes.php5">exception</link> - </entry> - <entry> - <link linkend="reserved.classes.php5">php_user_filter</link> + <link linkend="reserved.classes.php5">exception</link> (PHP 5) </entry> </row> <row> @@ -65,13 +65,10 @@ </row> <row> <entry> - <link linkend="migration.old-function">cfunction</link> - </entry> - <entry> <link linkend="keyword.class">class</link> </entry> <entry> - const + <link linkend="language.oop5.constants">const</link> </entry> <entry> <link linkend="control-structures.continue">continue</link> @@ -79,11 +76,11 @@ <entry> <link linkend="control-structures.declare">declare</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.switch">default</link> </entry> + </row> + <row> <entry> <function>die</function> </entry> @@ -96,11 +93,11 @@ <entry> <link linkend="control-structures.else">else</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.elseif">elseif</link> </entry> + </row> + <row> <entry> <function>empty</function> </entry> @@ -113,11 +110,11 @@ <entry> <link linkend="control-structures.alternative-syntax">endforeach</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.alternative-syntax">endif</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.alternative-syntax">endswitch</link> </entry> @@ -125,16 +122,16 @@ <link linkend="control-structures.alternative-syntax">endwhile</link> </entry> <entry> - <link linkend="function.eval">eval</link> + <function>eval</function> </entry> <entry> <function>exit</function> </entry> - </row> - <row> <entry> <link linkend="keyword.class">extends</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.for">for</link> </entry> @@ -147,11 +144,11 @@ <entry> <link linkend="language.variables.scope">global</link> </entry> - </row> - <row> <entry> <link linkend="control-structures.if">if</link> </entry> + </row> + <row> <entry> <function>include</function> </entry> @@ -164,14 +161,11 @@ <entry> <function>list</function> </entry> - </row> - <row> <entry> <link linkend="keyword.class">new</link> </entry> - <entry> - <link linkend="migration.old-function">old_function</link> - </entry> + </row> + <row> <entry> <function>print</function> </entry> @@ -181,14 +175,14 @@ <entry> <function>require_once</function> </entry> - </row> - <row> <entry> <function>return</function> </entry> <entry> <link linkend="language.variables.scope">static</link> </entry> + </row> + <row> <entry> <link linkend="control-structures.switch">switch</link> </entry> @@ -198,14 +192,14 @@ <entry> use </entry> - </row> - <row> <entry> <link linkend="keyword.class">var</link> </entry> <entry> <link linkend="control-structures.while">while</link> </entry> + </row> + <row> <entry> <link linkend="language.constants.predefined">__FUNCTION__</link> </entry> @@ -215,6 +209,62 @@ <entry> <link linkend="language.constants.predefined">__METHOD__</link> </entry> + <entry> + <link linkend="language.oop5.final">final</link> (PHP 5) + </entry> + <entry> + <link linkend="reserved.classes.php5">php_user_filter</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.oop5.interfaces">interface</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.interfaces">implements</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.basic">extends</link> + </entry> + <entry> + <link linkend="language.oop5.visibility">public</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.visibility">private</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.oop5.visibility">protected</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.abstract">abstract</link> (PHP 5) + </entry> + <entry> + <link linkend="language.oop5.cloning">clone</link> (PHP 5) + </entry> + <entry> + <link linkend="language.exceptions">try</link> (PHP 5) + </entry> + <entry> + <link linkend="language.exceptions">catch</link> (PHP 5) + </entry> + </row> + <row> + <entry> + <link linkend="language.exceptions">throw</link> (PHP 5) + </entry> + <entry> + <link linkend="migration.old-function">cfunction</link> (PHP 4 only) + </entry> + <entry> + <link linkend="migration.old-function">old_function</link> (PHP 4 only) + </entry> + <entry> + <link linkend="keyword.class">this</link> (PHP 5 only) + </entry> + <entry> + </entry> </row> </tbody> </tgroup> @@ -225,67 +275,65 @@ <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. - - + Since PHP 4.1.0, the preferred method for retrieving + <link linkend="language.variables.external">external variables</link> is + with the superglobals mentioned below. Before this time, people relied + on either <link linkend="ini.register-globals">register_globals</link> + or the long predefined PHP arrays (<varname>$HTTP_*_VARS</varname>). + &avail.register-long-arrays; </para> <sect2 id="reserved.variables.server"> - <title>Server Variablen: <varname>$_SERVER</varname></title> + <title>Server variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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 <ulink url="&url.cgispec;">CGI 1.1 Spezifikation</ulink>. + <varname>$_SERVER</varname> is an array containing information + such as headers, paths, and script locations. The entries in this + array are created by the web server. There is no guarantee that + every web server will provide any of these; servers may omit some, + or provide others not listed here. That said, a large number of + these variables are accounted for in the <ulink + url="&url.cgispec;">CGI 1.1 specification</ulink>, so you should + be able to expect those. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_SERVER;</command> to access it within functions or methods, as + you do with <varname>$HTTP_SERVER_VARS</varname>. </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.) + <varname>$HTTP_SERVER_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_SERVER_VARS</varname> and <varname>$_SERVER</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_SERVER</varname> and <varname>$HTTP_SERVER_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </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. + You may or may not find any of the following elements in + $_SERVER. Note that few, if any, of these will be available (or + indeed have any meaning) if running PHP on the command line. </simpara> <para> @@ -294,15 +342,18 @@ <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. + The filename of the currently executing script, relative to + the document root. For instance, + <varname>$_SERVER['PHP_SELF']</varname> in a script at the + address <filename>http://example.com/test.php/foo.bar</filename> + would be <filename>/test.php/foo.bar</filename>. + The <link linkend="language.constants.predefined">__FILE__</link> + constant contains the full path and filename of the current (i.e. + included) file. </simpara> <simpara> - Falls PHP auf der Kommandozeile ausgeführt wird, ist diese - Variable nicht verfügbar. + If PHP is running as a command-line processor this variable contains + the script name since PHP 4.3.0. Previously it was not available. </simpara> </listitem> </varlistentry> @@ -311,11 +362,10 @@ <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. + Array of arguments passed to the script. When the script is + run on the command line, this gives C-style access to the + command line parameters. When called via the GET method, this + will contain the query string. </simpara> </listitem> </varlistentry> @@ -324,19 +374,28 @@ <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). + Contains the number of command line parameters passed to the + script (if run on the command line). </simpara> </listitem> </varlistentry> - + <varlistentry> <term>'<varname>GATEWAY_INTERFACE</varname>'</term> <listitem> <simpara> - Gibt an, welche Version der CGI Spezifikation der Server - benutzt, beispielsweise '<literal>CGI/1.1</literal>'. + What revision of the CGI specification the server is using; + i.e. '<literal>CGI/1.1</literal>'. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>SERVER_ADDR</varname>'</term> + <listitem> + <simpara> + The IP address of the server under which the current script is + executing. </simpara> </listitem> </varlistentry> @@ -345,10 +404,9 @@ <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. + The name of the server host under which the current script is + executing. If the script is running on a virtual host, this + will be the value defined for that virtual host. </simpara> </listitem> </varlistentry> @@ -357,8 +415,8 @@ <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. + Server identification string, given in the headers when + responding to requests. </simpara> </listitem> </varlistentry> @@ -367,8 +425,8 @@ <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>'; + Name and revision of the information protocol via which the + page was requested; i.e. '<literal>HTTP/1.0</literal>'; </simpara> </listitem> </varlistentry> @@ -377,19 +435,33 @@ <term>'<varname>REQUEST_METHOD</varname>'</term> <listitem> <simpara> - Welche Anforderungsmethode benutzt wurde, um auf die Seite - zuzugreifen, z. B. '<literal>GET</literal>', + Which request method was used to access the page; i.e. '<literal>GET</literal>', '<literal>HEAD</literal>', '<literal>POST</literal>', '<literal>PUT</literal>'. </simpara> + <note> + <para> + PHP script is terminated after sending headers (it means after + producing any output without output buffering) if the request method + was <literal>HEAD</literal>. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>REQUEST_TIME</varname>'</term> + <listitem> + <simpara> + The timestamp of the start of the request. Available since PHP 5.1.0. + </simpara> </listitem> </varlistentry> - + <varlistentry> <term>'<varname>QUERY_STRING</varname>'</term> <listitem> <simpara> - Der Abfragestring, falls vorhanden, mit dem die Seite - angefordert wurde. + The query string, if any, via which the page was accessed. </simpara> </listitem> </varlistentry> @@ -398,9 +470,8 @@ <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. + The document root directory under which the current script is + executing, as defined in the server's configuration file. </simpara> </listitem> </varlistentry> @@ -409,8 +480,8 @@ <term>'<varname>HTTP_ACCEPT</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Accept:</literal>-Headers der aktuellen - Anforderung, falls dieser Header vorhanden ist. + Contents of the <literal>Accept:</literal> header from the + current request, if there is one. </simpara> </listitem> </varlistentry> @@ -419,8 +490,8 @@ <term>'<varname>HTTP_ACCEPT_CHARSET</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Accept-Charset:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Z. B. + Contents of the <literal>Accept-Charset:</literal> header + from the current request, if there is one. Example: '<literal>iso-8859-1,*,utf-8</literal>'. </simpara> </listitem> @@ -430,9 +501,8 @@ <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>'. + Contents of the <literal>Accept-Encoding:</literal> header + from the current request, if there is one. Example: '<literal>gzip</literal>'. </simpara> </listitem> </varlistentry> @@ -441,9 +511,8 @@ <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>'. + Contents of the <literal>Accept-Language:</literal> header + from the current request, if there is one. Example: '<literal>en</literal>'. </simpara> </listitem> </varlistentry> @@ -452,8 +521,8 @@ <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>'. + Contents of the <literal>Connection:</literal> header from + the current request, if there is one. Example: '<literal>Keep-Alive</literal>'. </simpara> </listitem> </varlistentry> @@ -462,8 +531,8 @@ <term>'<varname>HTTP_HOST</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>Host:</literal>-Headers der aktuellen Anforderung, - so vorhanden. + Contents of the <literal>Host:</literal> header from the + current request, if there is one. </simpara> </listitem> </varlistentry> @@ -472,12 +541,11 @@ <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. + The address of the page (if any) which referred the user + agent to the current page. This is set by the user agent. Not + all user agents will set this, and some provide the ability + to modify <varname>HTTP_REFERER</varname> as a feature. In + short, it cannot really be trusted. </simpara> </listitem> </varlistentry> @@ -486,14 +554,29 @@ <term>'<varname>HTTP_USER_AGENT</varname>'</term> <listitem> <simpara> - Der Inhalt des <literal>User_Agent:</literal>-Headers der - aktuellen Anforderung, so vorhanden. Dies ist ein String, der - den Typ und Namen des Browsers angibt, der auf die Seite - zugreift. Ein typisches Beispiel ist: - <computeroutput>Mozilla/4.5 [en] (X11; U; Linux 2.2.9 - i586)</computeroutput>. Unter anderem kann man diesen Wert mit - <function>get_browser</function> auslesen, um die Ausgabe einer - Seite auf den verwendeten Browser abzustimmen. + Contents of the <literal>User-Agent:</literal> header from + the current request, if there is one. This is a string + denoting the user agent being which is accessing the page. A + typical example is: <computeroutput>Mozilla/4.5 [en] (X11; U; + Linux 2.2.9 i586)</computeroutput>. Among other things, you + can use this value with <function>get_browser</function> to + tailor your page's output to the capabilities of the user + agent. + </simpara> + </listitem> + </varlistentry> + + <varlistentry> + <term>'<varname>HTTPS</varname>'</term> + <listitem> + <simpara> + Set to a non-empty value if the script was queried through the HTTPS + protocol. + </simpara> + <simpara> + Note that when using ISAPI with IIS, the value will be + <literal>off</literal> if the request was not made through the HTTPS + protocol. </simpara> </listitem> </varlistentry> @@ -502,7 +585,8 @@ <term>'<varname>REMOTE_ADDR</varname>'</term> <listitem> <simpara> - Die IP-Adresse des Rechners, der die aktuelle Seite angefordert hat. + The IP address from which the user is viewing the current + page. </simpara> </listitem> </varlistentry> @@ -511,16 +595,16 @@ <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. + The Host name from which the user is viewing the current + page. The reverse dns lookup is based off the + <varname>REMOTE_ADDR</varname> of the user. </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>. + Your web server must be configured to create this variable. For + example in Apache you'll need <literal>HostnameLookups On</literal> + inside &httpd.conf; for it to exist. See also + <function>gethostbyaddr</function>. </simpara> </note> </listitem> @@ -530,8 +614,8 @@ <term>'<varname>REMOTE_PORT</varname>'</term> <listitem> <simpara> - Der Port, Über den der Rechner des Benutzers mit dem Webserver - kommuniziert. + The port being used on the user's machine to communicate with + the web server. </simpara> </listitem> </varlistentry> @@ -540,14 +624,14 @@ <term>'<varname>SCRIPT_FILENAME</varname>'</term> <listitem> <para> - Der absolute Pfadname des aktuell ausgeführten Skripts. + The absolute pathname of the currently executing script. <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. + If a script is executed with the CLI, as a relative path, + such as <filename>file.php</filename> or + <filename>../file.php</filename>, + <varname>$_SERVER['SCRIPT_FILENAME']</varname> will + contain the relative path specified by the user. </para> </note> </para> @@ -558,10 +642,10 @@ <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. + The value given to the SERVER_ADMIN (for Apache) directive in + the web server configuration file. If the script is running + on a virtual host, this will be the value defined for that + virtual host. </simpara> </listitem> </varlistentry> @@ -570,10 +654,10 @@ <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. + The port on the server machine being used by the web server + for communication. For default setups, this will be '<literal>80</literal>'; + using SSL, for instance, will change this to whatever your + defined secure HTTP port is. </simpara> </listitem> </varlistentry> @@ -582,9 +666,8 @@ <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. + String containing the server version and virtual host name + which are added to server-generated pages, if enabled. </simpara> </listitem> </varlistentry> @@ -593,10 +676,26 @@ <term>'<varname>PATH_TRANSLATED</varname>'</term> <listitem> <simpara> - Der Pfad zur aktuellen Datei im Dateisystem (nicht relativ zum - Wurzelverzeichnis des Webserbers), nachdem der Server eventuelle - Umwandlungen vom virtuellen ins reale System vorgenommen hat. + 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> @@ -604,8 +703,11 @@ <term>'<varname>SCRIPT_NAME</varname>'</term> <listitem> <simpara> - Enthält den Pfad des aktuellen Skripts. Das ist nützlich für - Programme, die sich selber referenzieren. + 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> @@ -614,7 +716,20 @@ <term>'<varname>REQUEST_URI</varname>'</term> <listitem> <simpara> - Der URI mit dem diese Seite aufgerufen wurde. Z. B. '<literal>/index.html</literal>'. + 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> @@ -623,9 +738,9 @@ <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. + When running under Apache or IIS (ISAPI on PHP 5) as module doing + HTTP authentication this variable is set to the username provided by + the user. </simpara> </listitem> </varlistentry> @@ -634,9 +749,9 @@ <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. + When running under Apache or IIS (ISAPI on PHP 5) as module doing + HTTP authentication this variable is set to the password provided by + the user. </simpara> </listitem> </varlistentry> @@ -645,66 +760,66 @@ <term>'<varname>AUTH_TYPE</varname>'</term> <listitem> <simpara> - Wenn HTTP-Authentifizierung mit Apache als Modul benutzt wird, - enthält diese Variable den Authentifizierungs-Typ. + When running under Apache as module doing HTTP authenticated this + variable is set to the authentication type. </simpara> </listitem> </varlistentry> </variablelist> </para> + </sect2> <sect2 id="reserved.variables.environment"> - <title>Umgebungsvariablen: <varname>$_ENV</varname></title> + <title>Environment variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + These variables are imported into PHP's global namespace from the + environment under which the PHP parser is running. Many are + provided by the shell under which PHP is running and different + systems are likely running different kinds of shells, a + definitive list is impossible. Please see your shell's + documentation for a list of defined environment variables. </simpara> <simpara> - Andere Umgebungsvariablen einschließlich der CGI-Variablen, sind hier - aufgeführt, egal ob PHP als Servermodul oder CGI Prozess läuft. + Other environment variables include the CGI variables, placed + there regardless of whether PHP is running as a server module or + CGI processor. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_ENV;</command> to access it within functions or methods, as + you do with <varname>$HTTP_ENV_VARS</varname>. </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.) + <varname>$HTTP_ENV_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_ENV_VARS</varname> and <varname>$_ENV</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_ENV</varname> and <varname>$HTTP_ENV_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> @@ -713,309 +828,305 @@ <note> <simpara> - Dieses Array wurde mit PHP 4.1.0 eingeführt. In älteren Versionen - benutzen Sie das Array <varname>$HTTP_COOKIE_VARS</varname>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via HTTP cookies. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_COOKIE;</command> to access it within functions or methods, as + you do with <varname>$HTTP_COOKIE_VARS</varname>. </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> + information, but is not a superglobal. (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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_COOKIE</varname> and <varname>$HTTP_COOKIE_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.get"> - <title>HTTP GET Variablen: <varname>$_GET</varname></title> + <title>HTTP GET variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via the HTTP GET method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_GET;</command> to access it within functions or methods, as + you do with <varname>$HTTP_GET_VARS</varname>. </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.) + <varname>$HTTP_GET_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_GET_VARS</varname> and <varname>$_GET</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_GET</varname> and <varname>$HTTP_GET_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.post"> - <title>HTTP POST Variablen: <varname>$_POST</varname></title> + <title>HTTP POST variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of variables passed to the current script + via the HTTP POST method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_POST;</command> to access it within functions or methods, as + you do with <varname>$HTTP_POST_VARS</varname>. </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.) + <varname>$HTTP_POST_VARS</varname> contains the same initial + information, but is not a superglobal. (Note that + <varname>$HTTP_POST_VARS</varname> and <varname>$_POST</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_POST</varname> and <varname>$HTTP_POST_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.files"> - <title>Variablen für HTTP Dateiuploads: <varname>$_FILES</varname></title> + <title>HTTP File upload variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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. + An associative array of items uploaded to the current script + via the HTTP POST method. Automatically global in any scope. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_FILES;</command> to access it within functions or methods, as + you do with <varname>$HTTP_POST_FILES</varname>. </simpara> <simpara> - <varname>$HTTP_POST_FILES</varname> enthält dieselben Informationen, - ist aber nicht autoglobal. + <varname>$HTTP_POST_FILES</varname> contains the same + information, but is not a superglobal. (Note that + <varname>$HTTP_POST_FILES</varname> and <varname>$_FILES</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_FILES</varname> and <varname>$HTTP_POST_FILES</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.request"> - <title>Variablen einer Anforderung: <varname>$_REQUEST</varname></title> + <title>Request variables: <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. + Introduced in 4.1.0. There is no equivalent array in earlier + versions. </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. + Prior to PHP 4.3.0, <varname>$_FILES</varname> information was + also included in <varname>$_REQUEST</varname>. </simpara> </note> <simpara> - Ein assoziatives Aray, das die Inhalte der Arrays - <varname>$_GET</varname>, <varname>$_POST</varname> und - <varname>$_COOKIE</varname> enthält. + An associative array consisting of the contents of + <varname>$_GET</varname>, <varname>$_POST</varname>, + and <varname>$_COOKIE</varname>. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_REQUEST;</command> to access it within functions or methods. </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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_REQUEST</varname> array. For related information, see + the security chapter titled <link + linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.session"> - <title>Session Variablen: <varname>$_SESSION</varname></title> + <title>Session variables: <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>. + Introduced in 4.1.0. In earlier versions, use + <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>. + An associative array containing session variables available to + the current script. See the <link linkend="ref.session">Session + functions</link> documentation for more information on how this + is used. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $_SESSION;</command> to access it within functions or methods, as + you do with <varname>$HTTP_SESSION_VARS</varname>. </simpara> <simpara> - <varname>$HTTP_SESSION_VARS</varname> enthält dieselben - Informationen, ist aber nicht automatisch global. + <varname>$HTTP_SESSION_VARS</varname> contains the same + information, but is not a superglobal. (Note that + <varname>$HTTP_SESSION_VARS</varname> and <varname>$_SESSION</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>$_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. + If the <link + linkend="ini.register-globals">register_globals</link> directive + is set, then these variables will also be made available in the + global scope of the script; i.e., separate from the + <varname>$_SESSION</varname> and <varname>$HTTP_SESSION_VARS</varname> + arrays. For related information, see the security chapter titled + <link linkend="security.globals">Using Register + Globals</link>. These individual globals are not superglobals. </simpara> </sect2> <sect2 id="reserved.variables.globals"> - <title>Globale Variablen: <varname>$GLOBALS</varname></title> + <title>Global variables: <varname>$GLOBALS</varname></title> <note> <simpara> - <varname>$GLOBALS</varname> steht seit PHP 3.0.0 zur Verfügung. + <varname>$GLOBALS</varname> has been available since PHP 3.0.0. </simpara> </note> <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. + An associative array containing references to all variables which + are currently defined in the global scope of the script. The + variable names are the keys of the array. </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. + This is a 'superglobal', or automatic global, variable. This + simply means that it is available in all scopes throughout a + script. You don't need to do a <command>global + $GLOBALS;</command> to access it within functions or methods. </simpara> </sect2> <sect2 id="reserved.variables.phperrormsg"> - <title>Die letzte Fehlermeldung: <varname>$php_errormsg</varname></title> + <title>The previous error message: <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). + <varname>$php_errormsg</varname> is a variable containing the + text of the last error message generated by PHP. This variable + will only be available within the scope in which the error + occurred, and only if the <link + linkend="ini.track-errors">track_errors</link> configuration + option is turned on (it defaults to off). </simpara> </sect2> </sect1> <sect1 id="reserved.classes"> - <title>Vordefinierte Klassen</title> + <title>Predefined Classes</title> + <para> + This section lists standard predefined classes. Miscellaneous extensions + define other classes which are described in their reference. + </para> <sect2 id="reserved.classes.standard"> - <title>Standardmäßig definierte Klassen</title> + <title>Standard Defined Classes</title> <simpara> - Diese Klassen sind im Standard Funktionsumfang einer PHP Distribution enthalten. + These classes are defined in the standard set of functions included + in the PHP build. </simpara> <variablelist> @@ -1023,7 +1134,7 @@ <term><classname>Directory</classname></term> <listitem> <simpara> - Die Klasse, aus der <link linkend="class.dir">dir</link> instantiiert wird. + The class from which <link linkend="class.dir">dir</link> is instantiated. </simpara> </listitem> </varlistentry> @@ -1045,11 +1156,11 @@ </sect2> <sect2 id="reserved.classes.php5"> - <title>Vordefinierte Klassen in PHP 5</title> + <title>Predefined classes as of PHP 5</title> <simpara> - Diese zusätzlichen vordefinierten Klassen wurden mit PHP 5.0.0 - eingeführt. + These additional predefined classes were introduced in + PHP 5.0.0 </simpara> <variablelist> @@ -1070,167 +1181,6 @@ </variablelist> </sect2> - <sect2 id="reserved.classes.ming"> - <title>Definierte <link linkend="ref.ming">Ming</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.ming">Ming</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>swfshape</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swffill</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfgradient</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfbitmap</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swftext</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swftextfield</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swffont</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfdisplayitem</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfmovie</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfbutton</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfaction</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfmorph</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>swfsprite</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="reserved.classes.oci8"> - <title>Definierte <link linkend="ref.oci8">Oracle 8</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.oci8">Oracle 8</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>OCI-Lob</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>OCI-Collection</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - - <sect2 id="reserved.classes.qtdom"> - <title>Definierte <link linkend="ref.qtdom">qtdom</link> Klassen</title> - - <simpara> - Diese Klassen sind in der <link linkend="ref.qtdom">qtdom</link> - Erweiterung definiert und sind nur verfügbar, wenn diese Erweiterung - entweder einkompiliert oder zur Laufzeit dynamisch in PHP geladen - wurde. - </simpara> - - <variablelist> - <varlistentry> - <term><classname>QDomDocument</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - <varlistentry> - <term><classname>QDomNode</classname></term> - <listitem> - <simpara> - </simpara> - </listitem> - </varlistentry> - </variablelist> - </sect2> - </sect1> &appendices.reserved.constants;