Source for file DibiException.php

Documentation is available at DibiException.php

  1. 1: <?php
  2. 2:  
  3. 3: /**
  4. 4:  * dibi - tiny'n'smart database abstraction layer
  5. 5:  * ----------------------------------------------
  6. 6:  *
  7. 7:  * @copyright  Copyright (c) 2005, 2010 David Grudl
  8. 8:  * @license    http://dibiphp.com/license  dibi license
  9. 9:  * @link       http://dibiphp.com
  10. 10:  * @package    dibi
  11. 11:  */
  12. 12:  
  13. 13:  
  14. 14:  
  15. 15: /**
  16. 16:  * dibi common exception.
  17. 17:  *
  18. 18:  * @copyright  Copyright (c) 2005, 2010 David Grudl
  19. 19:  * @package    dibi
  20. 20:  */
  21. 21: class DibiException extends Exception implements IDebugPanel
  22. 22: {
  23. 23:     /** @var string */
  24. 24:     private $sql;
  25. 25:  
  26. 26:  
  27. 27:     /**
  28. 28:      * Construct a dibi exception.
  29. 29:      * @param  string  Message describing the exception
  30. 30:      * @param  int     Some code
  31. 31:      * @param  string SQL command
  32. 32:      */
  33. 33:     public function __construct($message = NULL, $code = 0, $sql = NULL)
  34. 34:     {
  35. 35:         parent::__construct($message, (int) $code);
  36. 36:         $this->sql = $sql;
  37. 37:         // TODO: add $profiler->exception($this);
  38. 38:     }
  39. 39:  
  40. 40:  
  41. 41:  
  42. 42:     /**
  43. 43:      * @return string  The SQL passed to the constructor
  44. 44:      */
  45. 45:     final public function getSql()
  46. 46:     {
  47. 47:         return $this->sql;
  48. 48:     }
  49. 49:  
  50. 50:  
  51. 51:  
  52. 52:     /**
  53. 53:      * @return string  string represenation of exception with SQL command
  54. 54:      */
  55. 55:     public function __toString()
  56. 56:     {
  57. 57:         return parent::__toString() . ($this->sql ? "\nSQL: " . $this->sql : '');
  58. 58:     }
  59. 59:  
  60. 60:  
  61. 61:  
  62. 62:     /********************* interface Nette\IDebugPanel ****************d*g**/
  63. 63:  
  64. 64:  
  65. 65:  
  66. 66:     /**
  67. 67:      * Returns HTML code for custom tab.
  68. 68:      * @return mixed 
  69. 69:      */
  70. 70:     public function getTab()
  71. 71:     {
  72. 72:         return 'SQL';
  73. 73:     }
  74. 74:  
  75. 75:  
  76. 76:  
  77. 77:     /**
  78. 78:      * Returns HTML code for custom panel.
  79. 79:      * @return mixed 
  80. 80:      */
  81. 81:     public function getPanel()
  82. 82:     {
  83. 83:         return $this->sql ? dibi::dump($this->sql, TRUE) : NULL;
  84. 84:     }
  85. 85:  
  86. 86:  
  87. 87:  
  88. 88:     /**
  89. 89:      * Returns panel ID.
  90. 90:      * @return string 
  91. 91:      */
  92. 92:     public function getId()
  93. 93:     {
  94. 94:         return __CLASS__;
  95. 95:     }
  96. 96:  
  97. 97: }
  98. 98:  
  99. 99:  
  100. 100:  
  101. 101:  
  102. 102: /**
  103. 103:  * database server exception.
  104. 104:  *
  105. 105:  * @copyright  Copyright (c) 2005, 2010 David Grudl
  106. 106:  * @package    dibi
  107. 107:  */
  108. 108: class DibiDriverException extends DibiException
  109. 109: {
  110. 110:  
  111. 111:     /********************* error catching ****************d*g**/
  112. 112:  
  113. 113:  
  114. 114:  
  115. 115:     /** @var string */
  116. 116:     private static $errorMsg;
  117. 117:  
  118. 118:  
  119. 119:  
  120. 120:     /**
  121. 121:      * Starts catching potential errors/warnings.
  122. 122:      * @return void 
  123. 123:      */
  124. 124:     public static function tryError()
  125. 125:     {
  126. 126:         set_error_handler(array(__CLASS__, '_errorHandler'), E_ALL);
  127. 127:         self::$errorMsg = NULL;
  128. 128:     }
  129. 129:  
  130. 130:  
  131. 131:  
  132. 132:     /**
  133. 133:      * Returns catched error/warning message.
  134. 134:      * @param  string  catched message
  135. 135:      * @return bool 
  136. 136:      */
  137. 137:     public static function catchError(& $message)
  138. 138:     {
  139. 139:         restore_error_handler();
  140. 140:         $message = self::$errorMsg;
  141. 141:         self::$errorMsg = NULL;
  142. 142:         return $message !== NULL;
  143. 143:     }
  144. 144:  
  145. 145:  
  146. 146:  
  147. 147:     /**
  148. 148:      * Internal error handler. Do not call directly.
  149. 149:      * @ignore internal
  150. 150:      */
  151. 151:     public static function _errorHandler($code, $message)
  152. 152:     {
  153. 153:         restore_error_handler();
  154. 154:  
  155. 155:         if (ini_get('html_errors')) {
  156. 156:             $message = strip_tags($message);
  157. 157:             $message = html_entity_decode($message);
  158. 158:         }
  159. 159:  
  160. 160:         self::$errorMsg = $message;
  161. 161:     }
  162. 162:  
  163. 163: }