SYBASE_SET_MESSAGE_HANDLER(3) SYBASE_SET_MESSAGE_HANDLER(3)
sybase_set_message_handler - Sets the handler called when a server message is raised
SYNOPSIS
bool sybase_set_message_handler (callable $handler, [resource $link_identifier])
DESCRIPTION
sybase_set_message_handler(3) sets a user function to handle messages generated by the server. You may specify the name of a global func-
tion, or use an array to specify an object reference and a method name.
PARAMETERS
o $handler
- The handler expects five arguments in the following order: message number, severity, state, line number and description. The
first four are integers. The last is a string. If the function returns FALSE, PHP generates an ordinary error message.
o $link_identifier
- If the link identifier isn't specified, the last opened link is assumed.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
EXAMPLES
Example #1
sybase_set_message_handler(3) callback function
<?php
function msg_handler($msgnumber, $severity, $state, $line, $text)
{
var_dump($msgnumber, $severity, $state, $line, $text);
}
sybase_set_message_handler('msg_handler');
?>
Example #2
sybase_set_message_handler(3) callback to a class
<?php
class Sybase {
function handler($msgnumber, $severity, $state, $line, $text)
{
var_dump($msgnumber, $severity, $state, $line, $text);
}
}
$sybase= new Sybase();
sybase_set_message_handler(array($sybase, 'handler'));
?>
Example #3
sybase_set_message_handler(3) unhandled messages
<?php
// Return FALSE from this function to indicate you can't handle
// this. The error is printed out as a warning, the way you're used
// to it if there is no handler installed.
function msg_handler($msgnumber, $severity, $state, $line, $text)
{
if (257 == $msgnumber) {
return false;
}
var_dump($msgnumber, $severity, $state, $line, $text);
}
sybase_set_message_handler('msg_handler');
?>
NOTES
Note
This function is only available when using the CT library interface to Sybase, and not with the DB library.
PHP Documentation Group SYBASE_SET_MESSAGE_HANDLER(3)