<!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>Error handling</title>
</head>
<body><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="sam.pubsub.html">Publish/Subscribe and subscriptions to topics</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ref.sam.html">SAM Functions</a></div>
<div class="up"><a href="sam.examples.html">Examples</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div><hr /><div id="sam.errors" class="section">
<h2 class="title">Error handling</h2>
<p class="para">
All SAMConnection methods that provide access to messaging operations
return <strong><code>FALSE</code></strong> if an error occurred in processing the request.
In addition the SAMConnection object has two properties, "errno"
and "error", that provide respectively the error number and
text description of the last error to occur on the connection.
</p>
<p class="para">
<div class="example" id="example-4513">
<p><strong>Example #1 Handling an error from a method that returns no result</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">if (!</span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">commit</span><span style="color: #007700">()) {<br /> </span><span style="color: #FF8000">// The commit failed!<br /> </span><span style="color: #007700">echo </span><span style="color: #DD0000">"Commit failed (</span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">errno</span><span style="color: #DD0000">) </span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">error</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br />}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
<p class="para">
<div class="example" id="example-4514">
<p><strong>Example #2 Handling an error from a method that returns a result</strong></p>
<div class="example-contents">
<div class="phpcode"><code><span style="color: #000000">
<span style="color: #0000BB"><?php<br />$correlid </span><span style="color: #007700">= </span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">send</span><span style="color: #007700">(</span><span style="color: #DD0000">'queue://send/test'</span><span style="color: #007700">, </span><span style="color: #0000BB">$msg</span><span style="color: #007700">);<br /><br />if (!</span><span style="color: #0000BB">$correlid</span><span style="color: #007700">) {<br /> </span><span style="color: #FF8000">// The Send failed!<br /> </span><span style="color: #007700">echo </span><span style="color: #DD0000">"Send failed (</span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">errno</span><span style="color: #DD0000">) </span><span style="color: #0000BB">$conn</span><span style="color: #007700">-></span><span style="color: #0000BB">error</span><span style="color: #DD0000">"</span><span style="color: #007700">;<br />} else {<br /> </span><span style="color: #FF8000">/* ... */<br /></span><span style="color: #007700">}<br /></span><span style="color: #0000BB">?></span>
</span>
</code></div>
</div>
</div>
</p>
</div><hr /><div class="manualnavbar" style="text-align: center;">
<div class="prev" style="text-align: left; float: left;"><a href="sam.pubsub.html">Publish/Subscribe and subscriptions to topics</a></div>
<div class="next" style="text-align: right; float: right;"><a href="ref.sam.html">SAM Functions</a></div>
<div class="up"><a href="sam.examples.html">Examples</a></div>
<div class="home"><a href="index.html">PHP Manual</a></div>
</div></body></html>
