source: branches/version-2_11-dev/data/class/SC_Query.php @ 21185

Revision 21185, 31.6 KB checked in by shutta, 9 years ago (diff)

refs #800 (SQL標準関数を使用する)
CURRENT_TIMESTAMP を使用するように now() を置換。

  • Property svn:eol-style set to LF
  • Property svn:keywords set to Id
  • Property svn:mime-type set to text/x-httpd-php; charset=UTF-8
Line 
1<?php
2/*
3 * This file is part of EC-CUBE
4 *
5 * Copyright(c) 2000-2011 LOCKON CO.,LTD. All Rights Reserved.
6 *
7 * http://www.lockon.co.jp/
8 *
9 * This program is free software; you can redistribute it and/or
10 * modify it under the terms of the GNU General Public License
11 * as published by the Free Software Foundation; either version 2
12 * of the License, or (at your option) any later version.
13 *
14 * This program is distributed in the hope that it will be useful,
15 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 * GNU General Public License for more details.
18 *
19 * You should have received a copy of the GNU General Public License
20 * along with this program; if not, write to the Free Software
21 * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
22 */
23
24require_once realpath(dirname(__FILE__)) . '/../module/MDB2.php';
25
26/**
27 * SQLの構築・実行を行う
28 *
29 * TODO エラーハンドリング, ロギング方法を見直す
30 *
31 * @author LOCKON CO.,LTD.
32 * @version $Id$
33 */
34class SC_Query {
35
36    var $instance;
37    var $option;
38    var $where;
39    var $conn;
40    var $groupby;
41    var $order;
42    var $force_run;
43
44    /**
45     * コンストラクタ.
46     *
47     * @param string $dsn データソース名
48     * @param boolean $force_run エラーが発生しても処理を続行する場合 true
49     * @param boolean $new 新規に接続を行うかどうか
50     */
51    function SC_Query($dsn = "", $force_run = false, $new = false) {
52
53        if ($dsn == "") {
54            $dsn = DEFAULT_DSN;
55        }
56
57        // Debugモード指定
58        // 常時ONにするとメモリが解放されない。
59        // 連続クエリ実行時に問題が生じる。
60        if(DEBUG_MODE) {
61            $options['debug'] = PEAR_DB_DEBUG;
62        } else {
63            $options['debug'] = 0;
64        }
65
66        // 持続的接続オプション
67        $options['persistent'] = PEAR_DB_PERSISTENT;
68
69        // バッファリング trueにするとメモリが解放されない。
70        // 連続クエリ実行時に問題が生じる。
71        $options['result_buffering'] = false;
72
73        if ($new) {
74            $this->conn = MDB2::connect($dsn, $options);
75        } else {
76            $this->conn = MDB2::singleton($dsn, $options);
77        }
78        if (!PEAR::isError($this->conn)) {
79            $this->conn->setCharset("utf8");
80            $this->conn->setFetchMode(MDB2_FETCHMODE_ASSOC);
81        }
82        $this->dbFactory = SC_DB_DBFactory_Ex::getInstance();
83        $this->force_run = $force_run;
84        $this->where = "";
85        $this->order = "";
86        $this->groupby = "";
87        $this->option = "";
88    }
89
90    /**
91     * シングルトンの SC_Query インスタンスを取得する.
92     *
93     * @param string $dsn データソース名
94     * @param boolean $force_run エラーが発生しても処理を続行する場合 true
95     * @param boolean $new 新規に接続を行うかどうか
96     * @return SC_Query シングルトンの SC_Query インスタンス
97     */
98    function getSingletonInstance($dsn = "", $force_run = false, $new = false) {
99        if (!isset($GLOBALS['_SC_Query_instance'])
100            || is_null($GLOBALS['_SC_Query_instance'])) {
101            $GLOBALS['_SC_Query_instance'] =& new SC_Query_Ex($dsn, $force_run, $new);
102        }
103        $GLOBALS['_SC_Query_instance']->where = "";
104        $GLOBALS['_SC_Query_instance']->order = "";
105        $GLOBALS['_SC_Query_instance']->groupby = "";
106        $GLOBALS['_SC_Query_instance']->option = "";
107        return $GLOBALS['_SC_Query_instance'];
108    }
109
110    /**
111     *  エラー判定を行う.
112     *
113     * @deprecated PEAR::isError() を使用して下さい
114     * @return boolean
115     */
116    function isError() {
117        if(PEAR::isError($this->conn)) {
118            return true;
119        }
120        return false;
121    }
122
123    /**
124     * COUNT文を実行する.
125     *
126     * @param string $table テーブル名
127     * @param string $where where句
128     * @param array $arrval プレースホルダ
129     * @return integer 件数
130     */
131    function count($table, $where = "", $arrval = array()) {
132        if(strlen($where) <= 0) {
133            $sqlse = "SELECT COUNT(*) FROM $table";
134        } else {
135            $sqlse = "SELECT COUNT(*) FROM $table WHERE $where";
136        }
137        $sqlse = $this->dbFactory->sfChangeMySQL($sqlse);
138        return $this->getOne($sqlse, $arrval);
139    }
140
141    /**
142     * SELECT文を実行する.
143     *
144     * @param string $col カラム名. 複数カラムの場合はカンマ区切りで書く
145     * @param string $table テーブル名
146     * @param string $where WHERE句
147     * @param array $arrval プレースホルダ
148     * @param integer $fetchmode 使用するフェッチモード。デフォルトは MDB2_FETCHMODE_ASSOC。
149     * @return array|null
150     */
151    function select($col, $table, $where = "", $arrval = array(), $fetchmode = MDB2_FETCHMODE_ASSOC) {
152        $sqlse = $this->getSql($col, $table, $where);
153        return $this->getAll($sqlse, $arrval, $fetchmode);
154    }
155
156    /**
157     * 直前に実行されたSQL文を取得する.
158     *
159     * @param boolean $disp trueの場合、画面出力を行う.
160     * @return string SQL文
161     */
162    function getLastQuery($disp = true) {
163        $sql = $this->conn->last_query;
164        if ($disp) {
165            echo $sql . ";<br />\n";
166        }
167        return $sql;
168    }
169
170    /**
171     * トランザクションをコミットする.
172     *
173     * @return MDB2_OK 成功した場合は MDB2_OK;
174     *         失敗した場合は PEAR::Error オブジェクト
175     */
176    function commit() {
177        return $this->conn->commit();
178    }
179
180    /**
181     * トランザクションを開始する.
182     *
183     * @return MDB2_OK 成功した場合は MDB2_OK;
184     *         失敗した場合は PEAR::Error オブジェクト
185     */
186    function begin() {
187        return $this->conn->beginTransaction();
188    }
189
190    /**
191     * トランザクションをロールバックする.
192     *
193     * @return MDB2_OK 成功した場合は MDB2_OK;
194     *         失敗した場合は PEAR::Error オブジェクト
195     */
196    function rollback() {
197        return $this->conn->rollback();
198    }
199
200    /**
201     * トランザクションが開始されているかチェックする.
202     *
203     * @return boolean トランザクションが開始されている場合 true
204     */
205    function inTransaction() {
206        return $this->conn->inTransaction();
207    }
208
209    /**
210     * 更新系の SQL を実行する.
211     *
212     * この関数は SC_Query::query() のエイリアスです.
213     *
214     * FIXME MDB2::exec() の実装であるべき
215     */
216    function exec($str, $arrval = array()) {
217        return $this->query($str, $arrval);
218    }
219
220    /**
221     * クエリを実行し、結果行毎にコールバック関数を適用する
222     *
223     * @param callback $function コールバック先
224     * @param string $sql SQL クエリ
225     * @param array $arrVal プリペアドステートメントの実行時に使用される配列。配列の要素数は、クエリ内のプレースホルダの数と同じでなければなりません。
226     * @param integer $fetchmode 使用するフェッチモード。デフォルトは DB_FETCHMODE_ASSOC。
227     * @return boolean 結果
228     */
229    function doCallbackAll($cbFunc, $sql, $arrval = array(), $fetchmode = MDB2_FETCHMODE_ASSOC) {
230
231        $sql = $this->dbFactory->sfChangeMySQL($sql);
232
233        $sth =& $this->prepare($sql);
234        if (PEAR::isError($sth) && $this->force_run) {
235            return;
236        }
237
238        $affected =& $this->execute($sth, $arrval);
239        if (PEAR::isError($affected) && $this->force_run) {
240            return;
241        }
242
243        while($data = $affected->fetchRow($fetchmode)) {
244            $result = call_user_func($cbFunc, $data);
245            if($result === false) {
246                break;
247            }
248        }
249        $sth->free();
250        return $result;
251    }
252
253    /**
254     * クエリを実行し、全ての行を返す
255     *
256     * @param string $sql SQL クエリ
257     * @param array $arrVal プリペアドステートメントの実行時に使用される配列。配列の要素数は、クエリ内のプレースホルダの数と同じでなければなりません。
258     * @param integer $fetchmode 使用するフェッチモード。デフォルトは DB_FETCHMODE_ASSOC。
259     * @return array データを含む2次元配列。失敗した場合に 0 または DB_Error オブジェクトを返します。
260     */
261    function getAll($sql, $arrval = array(), $fetchmode = MDB2_FETCHMODE_ASSOC) {
262
263        $sql = $this->dbFactory->sfChangeMySQL($sql);
264
265        $sth =& $this->prepare($sql);
266        if (PEAR::isError($sth) && $this->force_run) {
267            return;
268        }
269
270        $affected =& $this->execute($sth, $arrval);
271        if (PEAR::isError($affected) && $this->force_run) {
272            return;
273        }
274
275        return $affected->fetchAll($fetchmode);
276    }
277
278    /**
279     * 構築した SELECT 文を取得する.
280     *
281     * @param string $col SELECT 文に含めるカラム名
282     * @param string $table SELECT 文に含めるテーブル名
283     * @param string $where SELECT 文に含める WHERE 句
284     * @return string 構築済みの SELECT 文
285     */
286    function getSql($col, $table, $where = '') {
287        $sqlse = "SELECT $col FROM $table";
288
289        // 引数の$whereを優先する。
290        if (strlen($where) >= 1) {
291            $sqlse .= " WHERE $where";
292        } elseif (strlen($this->where) >= 1) {
293            $sqlse .= " WHERE " . $this->where;
294        }
295
296        $sqlse .= ' ' . $this->groupby . ' ' . $this->order . ' ' . $this->option;
297
298        return $sqlse;
299    }
300
301    /**
302     * SELECT 文の末尾に付与する SQL を設定する.
303     *
304     * この関数で設定した値は SC_Query::getSql() で使用されます.
305     *
306     * @param string $str 付与する SQL 文
307     * @return SC_Query 自分自身のインスタンス
308     */
309    function setOption($str) {
310        $this->option = $str;
311        return $this;
312    }
313
314    /**
315     * SELECT 文に付与する LIMIT, OFFSET 句を設定する.
316     *
317     * この関数で設定した値は SC_Query::getSql() で使用されます.
318     * TODO MDB2::setLimit() を使用する
319     *
320     * @param integer $limit LIMIT 句に付与する値
321     * @param integer $offset OFFSET 句に付与する値
322     * @return SC_Query 自分自身のインスタンス
323     */
324    function setLimitOffset($limit, $offset = 0) {
325        if (is_numeric($limit) && is_numeric($offset)){
326
327            $option = " LIMIT " . $limit;
328            $option.= " OFFSET " . $offset;
329            $this->option .= $option;
330        }
331        return $this;
332    }
333
334    /**
335     * SELECT 文に付与する GROUP BY 句を設定する.
336     *
337     * この関数で設定した値は SC_Query::getSql() で使用されます.
338     *
339     * @param string $str GROUP BY 句に付与する文字列
340     * @return SC_Query 自分自身のインスタンス
341     */
342    function setGroupBy($str) {
343        if (strlen($str) == 0) {
344            $this->groupby = '';
345        } else {
346            $this->groupby = "GROUP BY " . $str;
347        }
348        return $this;
349    }
350
351    /**
352     * SELECT 文の WHERE 句に付与する AND 条件を設定する.
353     *
354     * この関数で設定した値は SC_Query::getSql() で使用されます.
355     *
356     * @param string $str WHERE 句に付与する AND 条件の文字列
357     * @return SC_Query 自分自身のインスタンス
358     */
359    function andWhere($str) {
360        if($this->where != "") {
361            $this->where .= " AND " . $str;
362        } else {
363            $this->where = $str;
364        }
365        return $this;
366    }
367
368    /**
369     * SELECT 文の WHERE 句に付与する OR 条件を設定する.
370     *
371     * この関数で設定した値は SC_Query::getSql() で使用されます.
372     *
373     * @param string $str WHERE 句に付与する OR 条件の文字列
374     * @return SC_Query 自分自身のインスタンス
375     */
376    function orWhere($str) {
377        if($this->where != "") {
378            $this->where .= " OR " . $str;
379        } else {
380            $this->where = $str;
381        }
382        return $this;
383    }
384
385    /**
386     * SELECT 文に付与する WHERE 句を設定する.
387     *
388     * この関数で設定した値は SC_Query::getSql() で使用されます.
389     *
390     * @param string $str WHERE 句に付与する文字列
391     * @return SC_Query 自分自身のインスタンス
392     */
393    function setWhere($str) {
394        $this->where = $str;
395        return $this;
396    }
397
398    /**
399     * SELECT 文に付与する ORDER BY 句を設定する.
400     *
401     * この関数で設定した値は SC_Query::getSql() で使用されます.
402     *
403     * @param string $str ORDER BY 句に付与する文字列
404     * @return SC_Query 自分自身のインスタンス
405     */
406    function setOrder($str) {
407        if (strlen($str) == 0) {
408            $this->order = '';
409        } else {
410            $this->order = "ORDER BY " . $str;
411        }
412        return $this;
413    }
414
415    /**
416     * SELECT 文に付与する LIMIT 句を設定する.
417     *
418     * この関数で設定した値は SC_Query::getSql() で使用されます.
419     *
420     * @param integer $limit LIMIT 句に設定する値
421     * @return SC_Query 自分自身のインスタンス
422     */
423    function setLimit($limit){
424        if ( is_numeric($limit)){
425            $this->option = " LIMIT " .$limit;
426        }
427        return $this;
428    }
429
430    /**
431     * SELECT 文に付与する OFFSET 句を設定する.
432     *
433     * この関数で設定した値は SC_Query::getSql() で使用されます.
434     *
435     * @param integer $offset LIMIT 句に設定する値
436     * @return SC_Query 自分自身のインスタンス
437     */
438    function setOffset($offset) {
439        if ( is_numeric($offset)){
440            $this->offset = " OFFSET " .$offset;
441        }
442        return $this;
443    }
444
445    /**
446     * INSERT文を実行する.
447     *
448     * @param string $table テーブル名
449     * @param array $sqlval array('カラム名' => '値',...)の連想配列
450     * @return
451     */
452    function insert($table, $sqlval) {
453        $strcol = '';
454        $strval = '';
455        $find = false;
456
457        if(count($sqlval) <= 0 ) return false;
458        foreach ($sqlval as $key => $val) {
459            $strcol .= $key . ',';
460            if(strcasecmp("Now()", $val) === 0) {
461                $strval .= 'Now(),';
462            } else if(strcasecmp('CURRENT_TIMESTAMP', $val) === 0) {
463                $strval .= 'CURRENT_TIMESTAMP,';
464            } else if(strpos($val, '~') === 0) {
465                $strval .= preg_replace("/^~/", "", $val);
466            } else {
467                $strval .= '?,';
468                $arrval[] = $val;
469            }
470            $find = true;
471        }
472        if(!$find) {
473            return false;
474        }
475        // 文末の","を削除
476        $strcol = preg_replace("/,$/", "", $strcol);
477        $strval = preg_replace("/,$/", "", $strval);
478        $sqlin = "INSERT INTO $table(" . $strcol. ") VALUES (" . $strval . ")";
479        // INSERT文の実行
480        $ret = $this->query($sqlin, $arrval, false, null, MDB2_PREPARE_MANIP);
481
482        return $ret;
483    }
484
485    /**
486     * UPDATE文を実行する.
487     *
488     * @param string $table テーブル名
489     * @param array $sqlval array('カラム名' => '値',...)の連想配列
490     * @param string $where WHERE句
491     * @param array $arrValIn WHERE句用のプレースホルダ配列 (従来は追加カラム用も兼ねていた)
492     * @param array $arrRawSql 追加カラム
493     * @param array $arrRawSqlVal 追加カラム用のプレースホルダ配列
494     * @return
495     */
496    function update($table, $sqlval, $where = "", $arrValIn = array(), $arrRawSql = array(), $arrRawSqlVal = array()) {
497        $arrCol = array();
498        $arrVal = array();
499        $find = false;
500
501        foreach ($sqlval as $key => $val) {
502            if (strcasecmp("Now()", $val) === 0) {
503                $arrCol[] = $key . '= Now()';
504            } else if(strcasecmp('CURRENT_TIMESTAMP', $val) === 0) {
505                $arrCol[] = $key . '= CURRENT_TIMESTAMP';
506            } else if(strpos('~', $val) === 0) {
507                $arrCol[] = $key . '= ' . $val;
508            } else {
509                $arrCol[] = $key . '= ?';
510                $arrVal[] = $val;
511            }
512            $find = true;
513        }
514
515        if ($arrRawSql != "") {
516            foreach($arrRawSql as $key => $val) {
517                $arrCol[] = "$key = $val";
518            }
519        }
520
521        $arrVal = array_merge($arrVal, $arrRawSqlVal);
522
523        if (empty($arrCol)) {
524            return false;
525        }
526
527        // 文末の","を削除
528        $strcol = implode(', ', $arrCol);
529
530        if (is_array($arrValIn)) { // 旧版との互換用
531            // プレースホルダー用に配列を追加
532            $arrVal = array_merge($arrVal, $arrValIn);
533        }
534
535        $sqlup = "UPDATE $table SET $strcol";
536        if (strlen($where) >= 1) {
537            $sqlup .= " WHERE $where";
538        }
539
540        // UPDATE文の実行
541        return $this->query($sqlup, $arrVal, false, null, MDB2_PREPARE_MANIP);
542    }
543
544    /**
545     * MAX文を実行する.
546     *
547     * @param string $table テーブル名
548     * @param string $col カラム名
549     * @param string $where 付与する WHERE 句
550     * @param array $arrval ブレースホルダに挿入する値
551     * @return integer MAX文の実行結果
552     */
553    function max($col, $table, $where = "", $arrval = array()) {
554        $ret = $this->get("MAX($col)", $table, $where, $arrval);
555        return $ret;
556    }
557
558    /**
559     * MIN文を実行する.
560     *
561     * @param string $table テーブル名
562     * @param string $col カラム名
563     * @param string $where 付与する WHERE 句
564     * @param array $arrval ブレースホルダに挿入する値
565     * @return integer MIN文の実行結果
566     */
567    function min($col, $table, $where = "", $arrval = array()) {
568        $ret = $this->get("MIN($col)", $table, $where, $arrval);
569        return $ret;
570    }
571
572    /**
573     * SQL を構築して, 特定のカラムの値を取得する.
574     *
575     * @param string $table テーブル名
576     * @param string $col カラム名
577     * @param string $where 付与する WHERE 句
578     * @param array $arrval ブレースホルダに挿入する値
579     * @return mixed SQL の実行結果
580     */
581    function get($col, $table, $where = "", $arrval = array()) {
582        $sqlse = $this->getSql($col, $table, $where);
583        // SQL文の実行
584        $ret = $this->getOne($sqlse, $arrval);
585        return $ret;
586    }
587
588    /**
589     * SQL を指定して, 特定のカラムの値を取得する.
590     *
591     * @param string $sql 実行する SQL
592     * @param array $arrval ブレースホルダに挿入する値
593     * @return mixed SQL の実行結果
594     */
595    function getOne($sql, $arrval = array()) {
596
597        $sql = $this->dbFactory->sfChangeMySQL($sql);
598
599        $sth =& $this->prepare($sql);
600        if (PEAR::isError($sth) && $this->force_run) {
601            return;
602        }
603
604        $affected =& $this->execute($sth, $arrval);
605        if (PEAR::isError($affected) && $this->force_run) {
606            return;
607        }
608
609        return $affected->fetchOne();
610    }
611
612    /**
613     * 一行をカラム名をキーとした連想配列として取得
614     *
615     * @param string $table テーブル名
616     * @param string $col カラム名
617     * @param string $where WHERE句
618     * @param array $arrVal プレースホルダ配列
619     * @param integer $fetchmode 使用するフェッチモード。デフォルトは MDB2_FETCHMODE_ASSOC。
620     * @return array array('カラム名' => '値', ...)の連想配列
621     */
622    function getRow($col, $table, $where = "", $arrVal = array(), $fetchmode = MDB2_FETCHMODE_ASSOC) {
623
624        $sql = $this->getSql($col, $table, $where);
625        $sql = $this->dbFactory->sfChangeMySQL($sql);
626
627        $sth =& $this->prepare($sql);
628        if (PEAR::isError($sth) && $this->force_run) {
629            return;
630        }
631
632        $affected =& $this->execute($sth, $arrVal);
633        if (PEAR::isError($affected) && $this->force_run) {
634            return;
635        }
636
637        return $affected->fetchRow($fetchmode);
638    }
639
640    /**
641     * SELECT 文の実行結果を 1行のみ取得する.
642     *
643     * @param string $table テーブル名
644     * @param string $col カラム名
645     * @param string $where 付与する WHERE 句
646     * @param array $arrval ブレースホルダに挿入する値
647     * @return array SQL の実行結果の配列
648     */
649    function getCol($col, $table, $where = "", $arrval = array()) {
650        $sql = $this->getSql($col, $table, $where);
651        $sql = $this->dbFactory->sfChangeMySQL($sql);
652
653        $sth =& $this->prepare($sql);
654        if (PEAR::isError($sth) && $this->force_run) {
655            return;
656        }
657
658        $affected =& $this->execute($sth, $arrval);
659        if (PEAR::isError($affected) && $this->force_run) {
660            return;
661        }
662
663        return $affected->fetchCol($col);
664    }
665
666    /**
667     * レコードの削除
668     *
669     * @param string $table テーブル名
670     * @param string $where WHERE句
671     * @param array $arrval プレースホルダ
672     * @return
673     */
674    function delete($table, $where = "", $arrval = array()) {
675        if(strlen($where) <= 0) {
676            $sqlde = "DELETE FROM $table";
677        } else {
678            $sqlde = "DELETE FROM $table WHERE $where";
679        }
680        $ret = $this->query($sqlde, $arrval, false, null, MDB2_PREPARE_MANIP);
681        return $ret;
682    }
683
684    /**
685     * 次のシーケンス値を取得する.
686     *
687     * @param string $seq_name 取得するシーケンス名
688     * @param integer 次のシーケンス値
689     */
690    function nextVal($seq_name) {
691        return $this->conn->nextID($seq_name);
692    }
693
694    /**
695     * 現在のシーケンス値を取得する.
696     *
697     * @param string $seq_name 取得するシーケンス名
698     * @return integer 現在のシーケンス値
699     */
700    function currVal($seq_name) {
701        return $this->conn->currID($seq_name);
702    }
703
704    /**
705     * シーケンス値を設定する.
706     *
707     * @param string $seq_name シーケンス名
708     * @param integer $start 設定するシーケンス値
709     * @return MDB2_OK
710     */
711    function setVal($seq_name, $start) {
712        $objManager =& $this->conn->loadModule('Manager');
713        // XXX エラーハンドリングを行う
714        $objManager->dropSequence($seq_name);
715        return $objManager->createSequence($seq_name, $start);
716    }
717
718    /**
719     * SQL を実行する.
720     *
721     * FIXME $ignore_errが無視されるようになっているが互換性として問題が無いか確認が必要
722     *
723     * @param string $n 実行する SQL 文
724     * @param array $arr ブレースホルダに挿入する値
725     * @param boolean $ignore_err MDB2切替で無効化されている (エラーが発生しても処理を続行する場合 true)
726     * @param mixed $types プレースホルダの型指定 デフォルトnull = string
727     * @param mixed $result_types 返値の型指定またはDML実行(MDB2_PREPARE_MANIP)
728     * @return array SQL の実行結果の配列
729     */
730    function query($n ,$arr = array(), $ignore_err = false, $types = null, $result_types = MDB2_PREPARE_RESULT ){
731
732        $n = $this->dbFactory->sfChangeMySQL($n);
733
734        $sth =& $this->prepare($n, $types, $result_types);
735        if (PEAR::isError($sth) && $this->force_run) {
736            return $sth;
737        }
738
739        $result = $this->execute($sth, $arr);
740        if (PEAR::isError($result) && $this->force_run) {
741            return $sth;
742        }
743
744        //PREPAREの解放
745        $sth->free();
746
747        return $result;
748    }
749
750    /**
751     * シーケンスの一覧を取得する.
752     *
753     * @return array シーケンス名の配列
754     */
755    function listSequences() {
756        $objManager =& $this->conn->loadModule('Manager');
757        return $objManager->listSequences();
758    }
759
760    /**
761     * テーブル一覧を取得する.
762     *
763     * @return array テーブル名の配列
764     */
765    function listTables() {
766        $objManager =& $this->conn->loadModule('Manager');
767        return $objManager->listTables();
768    }
769
770    /**
771     * テーブルのカラム一覧を取得する.
772     *
773     * @param string $table テーブル名
774     * @return array 指定のテーブルのカラム名の配列
775     */
776    function listTableFields($table) {
777        $objManager =& $this->conn->loadModule('Manager');
778        return $objManager->listTableFields($table);
779    }
780
781    /**
782     * テーブルのインデックス一覧を取得する.
783     *
784     * @param string $table テーブル名
785     * @return array 指定のテーブルのインデックス一覧
786     */
787    function listTableIndexes($table) {
788        $objManager =& $this->conn->loadModule('Manager');
789        return $objManager->listTableIndexes($table);
790    }
791
792    /**
793     * テーブルにインデックスを付与する
794     *
795     * @param string $table テーブル名
796     * @param string $name インデックス名
797     * @param array $definition フィールド名など 通常のフィールド指定時は、$definition=array('fields' => array('フィールド名' => array()));
798     *               MySQLのtext型フィールドを指定する場合は $definition['length'] = 'text_field(NNN)' が必要
799     */
800    function createIndex($table, $name, $definition) {
801        $definition = $this->dbFactory->sfGetCreateIndexDefinition($table, $name, $definition);
802        $objManager =& $this->conn->loadModule('Manager');
803        return $objManager->createIndex($table, $name, $definition);
804    }
805
806    /**
807     * テーブルにインデックスを破棄する
808     *
809     * @param string $table テーブル名
810     * @param string $name インデックス名
811     */
812    function dropIndex($table, $name) {
813        $objManager =& $this->conn->loadModule('Manager');
814        return $objManager->dropIndex($table, $name);
815    }
816
817    /**
818     * テーブルの詳細情報を取得する。
819     *
820     * @param string $table テーブル名
821     * @return array テーブル情報の配列
822     */
823    function getTableInfo($table) {
824        $objManager =& $this->conn->loadModule('Reverse');
825        return $objManager->tableInfo($table, NULL);
826    }
827
828    /**
829     * 値を適切にクォートする.
830     *
831     * TODO MDB2 に対応するための暫定的な措置.
832     *      ブレースホルダが使用できない実装があるため.
833     *      本来であれば, MDB2::prepare() を適切に使用するべき
834     *
835     * @see MDB2::quote()
836     * @param string $val クォートを行う文字列
837     * @return string クォートされた文字列
838     */
839    function quote($val) {
840        return $this->conn->quote($val);
841    }
842
843    /**
844     * パラメーターの連想配列から, テーブルに存在する列のみを取得する.
845     *
846     * @param string $table テーブル名
847     * @param array ブレースホルダの連想配列
848     * @return array テーブルに存在する列のみ抽出した連想配列
849     */
850    function extractOnlyColsOf($table, $arrParams) {
851        $arrCols = $this->listTableFields($table);
852        $arrResults = array();
853        foreach ($arrParams as $key => $val) {
854            if (in_array($key, $arrCols)) {
855                $arrResults[$key] = $val;
856            }
857        }
858        return $arrResults;
859    }
860
861    /**
862     * プリペアドステートメントを構築する.
863     *
864     * @access private
865     * @param string $sql プリペアドステートメントを構築する SQL
866     * @param mixed $types プレースホルダの型指定 デフォルト null
867     * @param mixed $result_types 返値の型指定またはDML実行(MDB2_PREPARE_MANIP)、nullは指定無し
868     * @return MDB2_Statement_Common プリペアドステートメントインスタンス
869     */
870    function prepare($sql, $types = null, $result_types = MDB2_PREPARE_RESULT) {
871        $sth =& $this->conn->prepare($sql, $types, $result_types);
872        if (PEAR::isError($sth)) {
873            if (!$this->force_run) {
874                trigger_error($this->traceError($sth, $sql), E_USER_ERROR);
875            } else {
876                error_log($this->traceError($sth, $sql), 3, LOG_REALFILE);
877            }
878        }
879        return $sth;
880    }
881
882    /**
883     * プリペアドクエリを実行する.
884     *
885     * @access private
886     * @param MDB2_Statement_Common プリペアドステートメントインスタンス
887     * @param array $arrVal ブレースホルダに挿入する配列
888     * @return MDB2_Result 結果セットのインスタンス
889     */
890    function execute(&$sth, $arrVal = array()) {
891        $timeStart = SC_Utils_Ex::sfMicrotimeFloat();
892        $affected =& $sth->execute($arrVal);
893
894        // 一定以上時間かかったSQLの場合、ログ出力する。
895        if(defined('SQL_QUERY_LOG_MODE') && SQL_QUERY_LOG_MODE == true) {
896            $timeEnd = SC_Utils_Ex::sfMicrotimeFloat();;
897            $timeExecTime = $timeEnd - $timeStart;
898            if(defined('SQL_QUERY_LOG_MIN_EXEC_TIME') && $timeExecTime >= (float)SQL_QUERY_LOG_MIN_EXEC_TIME) {
899                $logMsg = sprintf("SQL_LOG [%.2fsec]\n%s", $timeExecTime, $sth->query);
900                error_log($logMsg, 3, LOG_REALFILE);
901            }
902        }
903
904        if (PEAR::isError($affected)) {
905            $sql = isset($sth->query) ? $sth->query : '';
906            if (!$this->force_run) {
907                trigger_error($this->traceError($affected, $sql), E_USER_ERROR);
908            } else {
909                error_log($this->traceError($affected, $sql), 3, LOG_REALFILE);
910            }
911        }
912        $this->conn->last_query = stripslashes($sth->query);
913        return $affected;
914    }
915
916    /**
917     * エラーの内容をトレースする.
918     *
919     * @access private
920     * @param PEAR::Error $error PEAR::Error インスタンス
921     * @param string $sql エラーの発生した SQL 文
922     * @return string トレースしたエラー文字列
923     */
924    function traceError($error, $sql = "") {
925        $scheme = '';
926        if (!empty($_SERVER['HTTPS']) && $_SERVER['HTTPS'] != 'off') {
927            $scheme = "http://";
928        } else {
929            $scheme = "https://";
930        }
931
932        $err = $scheme . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] . "\n\n"
933            . "SERVER_ADDR: " . $_SERVER['SERVER_ADDR'] . "\n"
934            . "REMOTE_ADDR: " . $_SERVER['REMOTE_ADDR'] . "\n"
935            . "USER_AGENT: " . $_SERVER['HTTP_USER_AGENT'] . "\n\n"
936            . "SQL: " . $sql . "\n\n"
937            . $error->getMessage() . "\n\n"
938            . $error->getUserInfo() . "\n\n";
939
940        $err .= SC_Utils_Ex::sfBacktraceToString($error->getBackTrace());
941
942        return $err;
943    }
944
945    /**
946     * SQLクエリの結果セットのカラム名だけを取得する
947     *
948     * @param string $n 実行する SQL 文
949     * @param array $arr ブレースホルダに挿入する値
950     * @param boolean エラーが発生しても処理を続行する場合 true
951     * @param mixed $types プレースホルダの型指定 デフォルトnull = string
952     * @param mixed $result_types 返値の型指定またはDML実行(MDB2_PREPARE_MANIP)
953     * @return array 実行結果の配列
954     */
955    function getQueryDefsFields($n ,$arr = array(), $ignore_err = false, $types = null, $result_types = MDB2_PREPARE_RESULT ){
956
957        $n = $this->dbFactory->sfChangeMySQL($n);
958
959        $sth =& $this->prepare($n, $types, $result_types);
960        if (PEAR::isError($sth) && ($this->force_run || $ignore_err)) {
961            return;
962        }
963
964        $result = $this->execute($sth, $arr);
965        if (PEAR::isError($result) && ($this->force_run || $ignore_err)) {
966            return;
967        }
968        $arrRet = $result->getColumnNames();
969        //PREPAREの解放
970        $sth->free();
971
972        return $arrRet;
973    }
974
975}
976
977?>
Note: See TracBrowser for help on using the repository browser.