Automatically exported from code.google.com/p/planningalerts
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 

210 line
7.3 KiB

  1. <?php
  2. // +----------------------------------------------------------------------+
  3. // | PHP versions 4 and 5 |
  4. // +----------------------------------------------------------------------+
  5. // | Copyright (c) 1998-2006 Manuel Lemos, Tomas V.V.Cox, |
  6. // | Stig. S. Bakken, Lukas Smith |
  7. // | All rights reserved. |
  8. // +----------------------------------------------------------------------+
  9. // | MDB2 is a merge of PEAR DB and Metabases that provides a unified DB |
  10. // | API as well as database abstraction for PHP applications. |
  11. // | This LICENSE is in the BSD license style. |
  12. // | |
  13. // | Redistribution and use in source and binary forms, with or without |
  14. // | modification, are permitted provided that the following conditions |
  15. // | are met: |
  16. // | |
  17. // | Redistributions of source code must retain the above copyright |
  18. // | notice, this list of conditions and the following disclaimer. |
  19. // | |
  20. // | Redistributions in binary form must reproduce the above copyright |
  21. // | notice, this list of conditions and the following disclaimer in the |
  22. // | documentation and/or other materials provided with the distribution. |
  23. // | |
  24. // | Neither the name of Manuel Lemos, Tomas V.V.Cox, Stig. S. Bakken, |
  25. // | Lukas Smith nor the names of his contributors may be used to endorse |
  26. // | or promote products derived from this software without specific prior|
  27. // | written permission. |
  28. // | |
  29. // | THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS |
  30. // | "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT |
  31. // | LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS |
  32. // | FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE |
  33. // | REGENTS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, |
  34. // | INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, |
  35. // | BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS|
  36. // | OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED |
  37. // | AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT |
  38. // | LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY|
  39. // | WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE |
  40. // | POSSIBILITY OF SUCH DAMAGE. |
  41. // +----------------------------------------------------------------------+
  42. // | Author: Lukas Smith <smith@pooteeweet.org> |
  43. // +----------------------------------------------------------------------+
  44. //
  45. // $Id: Common.php,v 1.16 2006/08/07 20:15:21 lsmith Exp $
  46. //
  47. /**
  48. * @package MDB2
  49. * @category Database
  50. * @author Lukas Smith <smith@pooteeweet.org>
  51. */
  52. /**
  53. * Base class for the function modules that is extended by each MDB2 driver
  54. *
  55. * @package MDB2
  56. * @category Database
  57. * @author Lukas Smith <smith@pooteeweet.org>
  58. */
  59. class MDB2_Driver_Function_Common extends MDB2_Module_Common
  60. {
  61. // {{{ executeStoredProc()
  62. /**
  63. * Execute a stored procedure and return any results
  64. *
  65. * @param string $name string that identifies the function to execute
  66. * @param mixed $params array that contains the paramaters to pass the stored proc
  67. * @param mixed $types array that contains the types of the columns in
  68. * the result set
  69. * @param mixed $result_class string which specifies which result class to use
  70. * @param mixed $result_wrap_class string which specifies which class to wrap results in
  71. * @return mixed a result handle or MDB2_OK on success, a MDB2 error on failure
  72. * @access public
  73. */
  74. function &executeStoredProc($name, $params = null, $types = null, $result_class = true, $result_wrap_class = false)
  75. {
  76. $db =& $this->getDBInstance();
  77. if (PEAR::isError($db)) {
  78. return $db;
  79. }
  80. $error =& $db->raiseError(MDB2_ERROR_UNSUPPORTED, null, null,
  81. 'method not implemented', __FUNCTION__);
  82. return $error;
  83. }
  84. // }}}
  85. // {{{ functionTable()
  86. /**
  87. * return string for internal table used when calling only a function
  88. *
  89. * @return string for internal table used when calling only a function
  90. * @access public
  91. */
  92. function functionTable()
  93. {
  94. return '';
  95. }
  96. // }}}
  97. // {{{ now()
  98. /**
  99. * Return string to call a variable with the current timestamp inside an SQL statement
  100. * There are three special variables for current date and time:
  101. * - CURRENT_TIMESTAMP (date and time, TIMESTAMP type)
  102. * - CURRENT_DATE (date, DATE type)
  103. * - CURRENT_TIME (time, TIME type)
  104. *
  105. * @return string to call a variable with the current timestamp
  106. * @access public
  107. */
  108. function now($type = 'timestamp')
  109. {
  110. switch ($type) {
  111. case 'time':
  112. return 'CURRENT_TIME';
  113. case 'date':
  114. return 'CURRENT_DATE';
  115. case 'timestamp':
  116. default:
  117. return 'CURRENT_TIMESTAMP';
  118. }
  119. }
  120. // }}}
  121. // {{{ substring()
  122. /**
  123. * return string to call a function to get a substring inside an SQL statement
  124. *
  125. * @return string to call a function to get a substring
  126. * @access public
  127. */
  128. function substring($value, $position = 1, $length = null)
  129. {
  130. if (!is_null($length)) {
  131. return "SUBSTRING($value FROM $position FOR $length)";
  132. }
  133. return "SUBSTRING($value FROM $position)";
  134. }
  135. // }}}
  136. // {{{ concat()
  137. /**
  138. * Returns string to concatenate two or more string parameters
  139. *
  140. * @param string $value1
  141. * @param string $value2
  142. * @param string $values...
  143. * @return string to concatenate two strings
  144. * @access public
  145. */
  146. function concat($value1, $value2)
  147. {
  148. $args = func_get_args();
  149. return "(".implode(' || ', $args).")";
  150. }
  151. // }}}
  152. // {{{ random()
  153. /**
  154. * return string to call a function to get random value inside an SQL statement
  155. *
  156. * @return return string to generate float between 0 and 1
  157. * @access public
  158. */
  159. function random()
  160. {
  161. return 'RAND()';
  162. }
  163. // }}}
  164. // {{{ lower()
  165. /**
  166. * return string to call a function to lower the case of an expression
  167. *
  168. * @param string $expression
  169. * @return return string to lower case of an expression
  170. * @access public
  171. */
  172. function lower($expression)
  173. {
  174. return "LOWER($expression)";
  175. }
  176. // }}}
  177. // {{{ upper()
  178. /**
  179. * return string to call a function to upper the case of an expression
  180. *
  181. * @param string $expression
  182. * @return return string to upper case of an expression
  183. * @access public
  184. */
  185. function upper($expression)
  186. {
  187. return "UPPER($expression)";
  188. }
  189. // }}}
  190. }
  191. ?>