sybase_set_message_handler

PHP関数リファレンス

sybase_set_message_handler

(PHP 4 >= 4.3.0, PHP 5)
sybase_set_message_handler — サーバでメッセージが発生した際にコールされるハンドラを指定する

説明

bool sybase_set_message_handler ( callback handler [, resource connection] )
sybase_set_message_handler() は、 サーバからのメッセージを処理するユーザ関数を設定します。グローバル関数の 名前、あるいはオブジェクトへの参照とメソッド名を保持する配列を指定します。
注意: この関数は、Sybase の CT ライブラリインターフェイスでのみ使用可能で、DB ライブラリでは使用できません。
ハンドラは、以下の 5 つの引数をこの順に受け取ります。 number, severity, state, line number そして description 。 最初の 4 つは整数値で、最後は文字列です。関数が FALSE を返した場合、PHP は通常のエラーメッセージを表示します。
成功した場合に TRUE を、失敗した場合に FALSE を返します。
注意: connection パラメータは PHP 4.3.5 で追加されました。
例 2347. sybase_set_message_handler() コールバック関数
<?php
   function msg_handler($msgnumber, $severity, $state, $line, $text)
   {
       var_dump($msgnumber, $severity, $state, $line, $text);
   }
  
   sybase_set_message_handler('msg_handler');
?>
例 2348. クラスへの sybase_set_message_handler() コールバック
<?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'));
?>
例 2349. sybase_set_message_handler() が処理しないメッセージ
<?php
   // この関数から FALSE を返すことは、それをこの関数では処理しないことを
   // 意味します。エラーは警告として表示され、ハンドラが何も設定されていない
   // 場合と同様に処理できます。
   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');
?>