<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Server and execution environment information</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="reserved.variables.globals.html">$GLOBALS</a></div>
<div class="next" style="text-align: right; float: right;"><a href="reserved.variables.get.html">$_GET</a></div>
<div class="up"><a href="reserved.variables.html">Predefined Variables</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="reserved.variables.server" class="refentry">
<div class="refnamediv">
<h1 class="refname">$_SERVER</h1>
<h1 class="refname">$HTTP_SERVER_VARS [deprecated]</h1>
<p class="verinfo">(PHP 4 >= 4.1.0, PHP 5)</p><p class="refpurpose"><span class="refname">$_SERVER</span> -- <span class="refname">$HTTP_SERVER_VARS [deprecated]</span> — <span class="dc-title">Server and execution environment information</span></p>
</div>
<div class="refsect1 description" id="refsect1-reserved.variables.server-description">
<h3 class="title">Description</h3>
<p class="para">
<var class="varname"><var class="varname">$_SERVER</var></var> 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 <a href="http://www.faqs.org/rfcs/rfc3875" class="link external">» CGI/1.1 specification</a>, so you should
be able to expect those.
</p>
<p class="simpara">
<var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var> contains the same initial
information, but is not a <a href="language.variables.superglobals.html" class="link">superglobal</a>.
(Note that <var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var> and <var class="varname"><var class="varname">$_SERVER</var></var>
are different variables and that PHP handles them as such)
</p>
</div>
<div class="refsect1 indices" id="refsect1-reserved.variables.server-indices">
<h3 class="title">Indices</h3>
<p class="simpara">
You may or may not find any of the following elements in
<var class="varname"><var class="varname">$_SERVER</var></var>. Note that few, if any, of these will be
available (or indeed have any meaning) if running PHP on the
<a href="features.commandline.html" class="link">command line</a>.
</p>
<p class="para">
<dl>
<dt>
<span class="term">'<var class="varname"><var class="varname">PHP_SELF</var></var>'</span>
<dd>
<span class="simpara">
The filename of the currently executing script, relative to
the document root. For instance,
<var class="varname"><var class="varname">$_SERVER['PHP_SELF']</var></var> in a script at the
address <var class="filename">http://example.com/test.php/foo.bar</var>
would be <var class="filename">/test.php/foo.bar</var>.
The <a href="language.constants.predefined.html" class="link">__FILE__</a>
constant contains the full path and filename of the current (i.e.
included) file.
</span>
<span class="simpara">
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.
</span>
</dd>
</dt>
<dt>
<span class="term">'<a href="reserved.variables.argv.html" class="link">argv</a>'</span>
<dd>
<span class="simpara">
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.
</span>
</dd>
</dt>
<dt>
<span class="term">'<a href="reserved.variables.argc.html" class="link">argc</a>'</span>
<dd>
<span class="simpara">
Contains the number of command line parameters passed to the
script (if run on the command line).
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">GATEWAY_INTERFACE</var></var>'</span>
<dd>
<span class="simpara">
What revision of the CGI specification the server is using;
i.e. '<em>CGI/1.1</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_ADDR</var></var>'</span>
<dd>
<span class="simpara">
The IP address of the server under which the current script is
executing.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_NAME</var></var>'</span>
<dd>
<span class="simpara">
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.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_SOFTWARE</var></var>'</span>
<dd>
<span class="simpara">
Server identification string, given in the headers when
responding to requests.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_PROTOCOL</var></var>'</span>
<dd>
<span class="simpara">
Name and revision of the information protocol via which the
page was requested; i.e. '<em>HTTP/1.0</em>';
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REQUEST_METHOD</var></var>'</span>
<dd>
<span class="simpara">
Which request method was used to access the page; i.e. '<em>GET</em>',
'<em>HEAD</em>', '<em>POST</em>', '<em>PUT</em>'.
</span>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
PHP script is terminated after sending headers (it means after
producing any output without output buffering) if the request method
was <em>HEAD</em>.
</p>
</p></blockquote>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REQUEST_TIME</var></var>'</span>
<dd>
<span class="simpara">
The timestamp of the start of the request. Available since PHP 5.1.0.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REQUEST_TIME_FLOAT</var></var>'</span>
<dd>
<span class="simpara">
The timestamp of the start of the request, with microsecond precision.
Available since PHP 5.4.0.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">QUERY_STRING</var></var>'</span>
<dd>
<span class="simpara">
The query string, if any, via which the page was accessed.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">DOCUMENT_ROOT</var></var>'</span>
<dd>
<span class="simpara">
The document root directory under which the current script is
executing, as defined in the server's configuration file.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_ACCEPT</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Accept:</em> header from the
current request, if there is one.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_ACCEPT_CHARSET</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Accept-Charset:</em> header
from the current request, if there is one. Example:
'<em>iso-8859-1,*,utf-8</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_ACCEPT_ENCODING</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Accept-Encoding:</em> header
from the current request, if there is one. Example: '<em>gzip</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_ACCEPT_LANGUAGE</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Accept-Language:</em> header
from the current request, if there is one. Example: '<em>en</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_CONNECTION</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Connection:</em> header from
the current request, if there is one. Example: '<em>Keep-Alive</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_HOST</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>Host:</em> header from the
current request, if there is one.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_REFERER</var></var>'</span>
<dd>
<span class="simpara">
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 <var class="varname"><var class="varname">HTTP_REFERER</var></var> as a feature. In
short, it cannot really be trusted.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTP_USER_AGENT</var></var>'</span>
<dd>
<span class="simpara">
Contents of the <em>User-Agent:</em> 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: <span class="computeroutput">Mozilla/4.5 [en] (X11; U;
Linux 2.2.9 i586)</span>. Among other things, you
can use this value with <span class="function"><a href="function.get-browser.html" class="function">get_browser()</a></span> to
tailor your page's output to the capabilities of the user
agent.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">HTTPS</var></var>'</span>
<dd>
<span class="simpara">
Set to a non-empty value if the script was queried through the HTTPS
protocol.
</span>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
Note that when using ISAPI with IIS, the value will be
<em>off</em> if the request was not made through the HTTPS
protocol.
</span>
</p></blockquote>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REMOTE_ADDR</var></var>'</span>
<dd>
<span class="simpara">
The IP address from which the user is viewing the current
page.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REMOTE_HOST</var></var>'</span>
<dd>
<span class="simpara">
The Host name from which the user is viewing the current
page. The reverse dns lookup is based off the
<var class="varname"><var class="varname">REMOTE_ADDR</var></var> of the user.
</span>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
Your web server must be configured to create this variable. For
example in Apache you'll need <em>HostnameLookups On</em>
inside <var class="filename">httpd.conf</var> for it to exist. See also
<span class="function"><a href="function.gethostbyaddr.html" class="function">gethostbyaddr()</a></span>.
</span>
</p></blockquote>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REMOTE_PORT</var></var>'</span>
<dd>
<span class="simpara">
The port being used on the user's machine to communicate with
the web server.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REMOTE_USER</var></var>'</span>
<dd>
<span class="simpara">
The authenticated user.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REDIRECT_REMOTE_USER</var></var>'</span>
<dd>
<span class="simpara">
The authenticated user if the request is internally redirected.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SCRIPT_FILENAME</var></var>'</span>
<dd>
<p class="para">
The absolute pathname of the currently executing script.
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
If a script is executed with the CLI, as a relative path,
such as <var class="filename">file.php</var> or
<var class="filename">../file.php</var>,
<var class="varname"><var class="varname">$_SERVER['SCRIPT_FILENAME']</var></var> will
contain the relative path specified by the user.
</p>
</p></blockquote>
</p>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_ADMIN</var></var>'</span>
<dd>
<span class="simpara">
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.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_PORT</var></var>'</span>
<dd>
<span class="simpara">
The port on the server machine being used by the web server
for communication. For default setups, this will be '<em>80</em>';
using SSL, for instance, will change this to whatever your
defined secure HTTP port is.
</span>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
Under the Apache 2, you must set <em>UseCanonicalName = On</em>,
as well as <em>UseCanonicalPhysicalPort = On</em> in order to
get the physical (real) port, otherwise, this value can be spoofed and it
may or may not return the physical port value.
It is not safe to rely on this value in security-dependent contexts.
</span>
</p></blockquote>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SERVER_SIGNATURE</var></var>'</span>
<dd>
<span class="simpara">
String containing the server version and virtual host name
which are added to server-generated pages, if enabled.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">PATH_TRANSLATED</var></var>'</span>
<dd>
<span class="simpara">
Filesystem- (not document root-) based path to the current
script, after the server has done any virtual-to-real
mapping.
</span>
<blockquote class="note"><p><strong class="note">Note</strong>:
<span class="simpara">
As of PHP 4.3.2, <span class="envar">PATH_TRANSLATED</span> is no longer set
implicitly under the Apache 2 <acronym title="Server Application Programming Interface">SAPI</acronym> in contrast
to the situation in Apache 1, where it's set to the same value as
the <span class="envar">SCRIPT_FILENAME</span> server variable when it's not
populated by Apache. This change was made to comply with the
<acronym title="Common Gateway Interface">CGI</acronym> specification that
<span class="envar">PATH_TRANSLATED</span> should only exist if
<span class="envar">PATH_INFO</span> is defined.
</span>
<span class="simpara">
Apache 2 users may use <em>AcceptPathInfo = On</em> inside
<var class="filename">httpd.conf</var> to define <span class="envar">PATH_INFO</span>.
</span>
</p></blockquote>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">SCRIPT_NAME</var></var>'</span>
<dd>
<span class="simpara">
Contains the current script's path. This is useful for pages
which need to point to themselves.
The <a href="language.constants.predefined.html" class="link">__FILE__</a>
constant contains the full path and filename of the current (i.e.
included) file.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">REQUEST_URI</var></var>'</span>
<dd>
<span class="simpara">
The URI which was given in order to access this page; for
instance, '<em>/index.html</em>'.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">PHP_AUTH_DIGEST</var></var>'</span>
<dd>
<span class="simpara">
When 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).
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">PHP_AUTH_USER</var></var>'</span>
<dd>
<span class="simpara">
When doing HTTP authentication this variable is set to the
username provided by the user.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">PHP_AUTH_PW</var></var>'</span>
<dd>
<span class="simpara">
When doing HTTP authentication this variable is set to the
password provided by the user.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">AUTH_TYPE</var></var>'</span>
<dd>
<span class="simpara">
When doing HTTP authenticated this variable is set to the
authentication type.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">PATH_INFO</var></var>'</span>
<dd>
<span class="simpara">
Contains any client-provided pathname information trailing the
actual script filename but preceding the query string, if
available. For instance, if the current script was accessed via
the
URL <var class="filename">http://www.example.com/php/path_info.php/some/stuff?foo=bar</var>,
then <var class="varname"><var class="varname">$_SERVER['PATH_INFO']</var></var> would
contain <em>/some/stuff</em>.
</span>
</dd>
</dt>
<dt>
<span class="term">'<var class="varname"><var class="varname">ORIG_PATH_INFO</var></var>'</span>
<dd>
<span class="simpara">
Original version of '<var class="varname"><var class="varname">PATH_INFO</var></var>' before processed by
PHP.
</span>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 changelog" id="refsect1-reserved.variables.server-changelog">
<h3 class="title">Changelog</h3>
<p class="para">
<table class="doctable informaltable">
<thead>
<tr>
<th>Version</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>4.1.0</td>
<td>
Introduced <var class="varname"><var class="varname">$_SERVER</var></var> that deprecated
<var class="varname"><var class="varname">$HTTP_SERVER_VARS</var></var>.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-reserved.variables.server-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="variable.server.basic">
<p><strong>Example #1 <var class="varname"><var class="varname">$_SERVER</var></var> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">$_SERVER</span><span style="color: #007700">[</span><span style="color: #DD0000">'SERVER_NAME'</span><span style="color: #007700">];<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>The above example will output
something similar to:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
www.example.com
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 notes" id="refsect1-reserved.variables.server-notes">
<h3 class="title">Notes</h3>
<blockquote class="note"><p><strong class="note">Note</strong>: <p class="para">This is a 'superglobal', or
automatic global, variable. This simply means that it is available in
all scopes throughout a script. There is no need to do
<strong class="command">global $variable;</strong> to access it within functions or methods.
</p></p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-reserved.variables.server-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><a href="book.filter.html" class="link">The filter extension</a></li>
</ul>
</p>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="reserved.variables.globals.html">$GLOBALS</a></div>
<div class="next" style="text-align: right; float: right;"><a href="reserved.variables.get.html">$_GET</a></div>
<div class="up"><a href="reserved.variables.html">Predefined Variables</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
