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

Revision 21273, 32.4 KB checked in by shutta, 13 years ago (diff)

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