<!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>Returns the last error on the socket</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.socket-import-stream.html">socket_import_stream</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.socket-listen.html">socket_listen</a></div>
<div class="up"><a href="ref.sockets.html">Socket Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="function.socket-last-error" class="refentry">
<div class="refnamediv">
<h1 class="refname">socket_last_error</h1>
<p class="verinfo">(PHP 4 >= 4.1.0, PHP 5)</p><p class="refpurpose"><span class="refname">socket_last_error</span> — <span class="dc-title">Returns the last error on the socket </span></p>
</div>
<div class="refsect1 description" id="refsect1-function.socket-last-error-description">
<h3 class="title">Description</h3>
<div class="methodsynopsis dc-description">
<span class="type">int</span> <span class="methodname"><strong>socket_last_error</strong></span>
([ <span class="methodparam"><span class="type">resource</span> <code class="parameter">$socket</code></span>
] )</div>
<p class="para rdfs-comment">
If a socket resource is passed to this function, the last error which
occurred on this particular socket is returned. If the socket resource is
omitted, the error code of the last failed socket function is returned.
The latter is particularly helpful for functions like
<span class="function"><a href="function.socket-create.html" class="function">socket_create()</a></span> which don't return a socket on
failure and <span class="function"><a href="function.socket-select.html" class="function">socket_select()</a></span> which can fail for reasons
not directly tied to a particular socket. The error code is suitable to
be fed to <span class="function"><a href="function.socket-strerror.html" class="function">socket_strerror()</a></span> which returns a string
describing the given error code.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.socket-last-error-parameters">
<h3 class="title">Parameters</h3>
<p class="para">
<dl>
<dt>
<span class="term"><em><code class="parameter">socket</code></em></span>
<dd>
<p class="para">
A valid socket resource created with <span class="function"><a href="function.socket-create.html" class="function">socket_create()</a></span>.
</p>
</dd>
</dt>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.socket-last-error-returnvalues">
<h3 class="title">Return Values</h3>
<p class="para">
This function returns a socket error code.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.socket-last-error-examples">
<h3 class="title">Examples</h3>
<p class="para">
<div class="example" id="example-4594">
<p><strong>Example #1 <span class="function"><strong>socket_last_error()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$socket </span><span style="color: #007700">= @</span><span style="color: #0000BB">socket_create</span><span style="color: #007700">(</span><span style="color: #0000BB">AF_INET</span><span style="color: #007700">, </span><span style="color: #0000BB">SOCK_STREAM</span><span style="color: #007700">, </span><span style="color: #0000BB">SOL_TCP</span><span style="color: #007700">);<br /><br />if (</span><span style="color: #0000BB">$socket </span><span style="color: #007700">=== </span><span style="color: #0000BB">false</span><span style="color: #007700">) {<br /> </span><span style="color: #0000BB">$errorcode </span><span style="color: #007700">= </span><span style="color: #0000BB">socket_last_error</span><span style="color: #007700">();<br /> </span><span style="color: #0000BB">$errormsg </span><span style="color: #007700">= </span><span style="color: #0000BB">socket_strerror</span><span style="color: #007700">(</span><span style="color: #0000BB">$errorcode</span><span style="color: #007700">);<br /> <br /> die(</span><span style="color: #DD0000">"Couldn't create socket: [</span><span style="color: #0000BB">$errorcode</span><span style="color: #DD0000">] </span><span style="color: #0000BB">$errormsg</span><span style="color: #DD0000">"</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.socket-last-error-notes">
<h3 class="title">Notes</h3>
<blockquote class="note"><p><strong class="note">Note</strong>:
<p class="para">
<span class="function"><strong>socket_last_error()</strong></span> does not clear the error code, use
<span class="function"><a href="function.socket-clear-error.html" class="function">socket_clear_error()</a></span> for this purpose.
</p>
</p></blockquote>
</div>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="function.socket-import-stream.html">socket_import_stream</a></div>
<div class="next" style="text-align: right; float: right;"><a href="function.socket-listen.html">socket_listen</a></div>
<div class="up"><a href="ref.sockets.html">Socket Functions</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
