<!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>HTTP GET variables</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="reserved.variables.server.html">$_SERVER</a></div>
<div class="next" style="text-align: right; float: right;"><a href="reserved.variables.post.html">$_POST</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.get" class="refentry">
<div class="refnamediv">
<h1 class="refname">$_GET</h1>
<h1 class="refname">$HTTP_GET_VARS [deprecated]</h1>
<p class="verinfo">(PHP 4 >= 4.1.0, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">$_GET</span> -- <span class="refname">$HTTP_GET_VARS [deprecated]</span> — <span class="dc-title">HTTP GET variables</span></p>
</div>
<div class="refsect1 description" id="refsect1-reserved.variables.get-description">
<h3 class="title">Description</h3>
<p class="para">
An associative array of variables passed to the current script
via the URL parameters (aka. query string). Note that the array is not only
populated for GET requests, but rather for all requests with a query string.
</p>
<p class="simpara">
<var class="varname"><var class="varname">$HTTP_GET_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_GET_VARS</var></var> and <var class="varname"><var class="varname">$_GET</var></var>
are different variables and that PHP handles them as such)
</p>
</div>
<div class="refsect1 changelog" id="refsect1-reserved.variables.get-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">$_GET</var></var> that deprecated
<var class="varname"><var class="varname">$HTTP_GET_VARS</var></var>.
</td>
</tr>
</tbody>
</table>
</p>
</div>
<div class="refsect1 examples" id="refsect1-reserved.variables.get-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-297">
<p><strong>Example #1 <var class="varname"><var class="varname">$_GET</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: #DD0000">'Hello ' </span><span style="color: #007700">. </span><span style="color: #0000BB">htmlspecialchars</span><span style="color: #007700">(</span><span style="color: #0000BB">$_GET</span><span style="color: #007700">[</span><span style="color: #DD0000">"name"</span><span style="color: #007700">]) . </span><span style="color: #DD0000">'!'</span><span style="color: #007700">;<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
<div class="example-contents"><p>
Assuming the user entered http://example.com/?name=Hannes
</p></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>
Hello Hannes!
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 notes" id="refsect1-reserved.variables.get-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>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
The GET variables are passed through <span class="function"><a href="function.urldecode.html" class="function">urldecode()</a></span>.
</p>
</p></blockquote>
</div>
<div class="refsect1 seealso" id="refsect1-reserved.variables.get-seealso">
<h3 class="title">See Also</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><a href="language.variables.external.html" class="link">Handling external variables</a></li>
<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.server.html">$_SERVER</a></div>
<div class="next" style="text-align: right; float: right;"><a href="reserved.variables.post.html">$_POST</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>
