5 * This file is part of ADOdb, a Database Abstraction Layer library for PHP.
8 * @link https://adodb.org Project's web site and documentation
9 * @link https://github.com/ADOdb/ADOdb Source code and issue tracker
11 * The ADOdb Library is dual-licensed, released under both the BSD 3-Clause
12 * and the GNU Lesser General Public Licence (LGPL) v2.1 or, at your option,
13 * any later version. This means you can use it in proprietary products.
14 * See the LICENSE.md file distributed with this source code for details.
15 * @license BSD-3-Clause
16 * @license LGPL-2.1-or-later
18 * @copyright 2000-2013 John Lim
19 * @copyright 2014 Damien Regad, Mark Newnham and the ADOdb community
20 * @author Diogo Toscano <diogo@scriptcase.net>
21 * @author Sid Dunayer <sdunayer@interserv.com>
24 class ADODB_pdo_sqlite
extends ADODB_pdo
{
25 var $metaTablesSQL = "SELECT name FROM sqlite_master WHERE type='table'";
26 var $sysDate = 'current_date';
27 var $sysTimeStamp = 'current_timestamp';
29 var $replaceQuote = "''";
31 var $_genIDSQL = "UPDATE %s SET id=id+1 WHERE id=%s";
32 var $_genSeqSQL = "CREATE TABLE %s (id integer)";
33 var $_genSeqCountSQL = 'SELECT COUNT(*) FROM %s';
34 var $_genSeq2SQL = 'INSERT INTO %s VALUES(%s)';
35 var $_dropSeqSQL = 'DROP TABLE %s';
36 var $concat_operator = '||';
37 var $pdoDriver = false;
38 var $random='abs(random())';
40 function _init($parentDriver)
42 $this->pdoDriver
= $parentDriver;
43 $parentDriver->_bindInputArray
= true;
44 $parentDriver->hasTransactions
= false; // // should be set to false because of PDO SQLite driver not supporting changing autocommit mode
45 $parentDriver->hasInsertID
= true;
50 $parent = $this->pdoDriver
;
51 @($ver = array_pop($parent->GetCol("SELECT sqlite_version()")));
52 @($enc = array_pop($parent->GetCol("PRAGMA encoding")));
54 $arr['version'] = $ver;
55 $arr['description'] = 'SQLite ';
56 $arr['encoding'] = $enc;
61 function SelectLimit($sql,$nrows=-1,$offset=-1,$inputarr=false,$secs2cache=0)
63 $nrows = (int) $nrows;
64 $offset = (int) $offset;
65 $parent = $this->pdoDriver
;
66 $offsetStr = ($offset >= 0) ?
" OFFSET $offset" : '';
67 $limitStr = ($nrows >= 0) ?
" LIMIT $nrows" : ($offset >= 0 ?
' LIMIT 999999999' : '');
69 $rs = $parent->CacheExecute($secs2cache,$sql."$limitStr$offsetStr",$inputarr);
71 $rs = $parent->Execute($sql."$limitStr$offsetStr",$inputarr);
76 function GenID($seq='adodbseq',$start=1)
78 $parent = $this->pdoDriver
;
79 // if you have to modify the parameter below, your database is overloaded,
80 // or you need to implement generation of id's yourself!
82 while (--$MAXLOOPS>=0) {
83 @($num = array_pop($parent->GetCol("SELECT id FROM {$seq}")));
84 if ($num === false ||
!is_numeric($num)) {
85 @$parent->Execute(sprintf($this->_genSeqSQL
,$seq));
88 $cnt = $parent->GetOne(sprintf($this->_genSeqCountSQL
,$seq));
90 $ok = $parent->Execute(sprintf($this->_genSeq2SQL
,$seq,$start));
92 if (!$ok) return false;
94 $parent->Execute(sprintf($this->_genIDSQL
,$seq,$num));
96 if ($parent->affected_rows() > 0) {
98 $parent->genID
= intval($num);
102 if ($fn = $parent->raiseErrorFn
) {
103 $fn($parent->databaseType
,'GENID',-32000,"Unable to generate unique id after $MAXLOOPS attempts",$seq,$num);
108 function CreateSequence($seqname='adodbseq',$start=1)
110 $parent = $this->pdoDriver
;
111 $ok = $parent->Execute(sprintf($this->_genSeqSQL
,$seqname));
112 if (!$ok) return false;
114 return $parent->Execute("insert into $seqname values($start)");
117 function SetTransactionMode($transaction_mode)
119 $parent = $this->pdoDriver
;
120 $parent->_transmode
= strtoupper($transaction_mode);
123 function BeginTrans()
125 $parent = $this->pdoDriver
;
126 if ($parent->transOff
) return true;
127 $parent->transCnt +
= 1;
128 $parent->_autocommit
= false;
129 return $parent->Execute("BEGIN {$parent->_transmode}");
132 function CommitTrans($ok=true)
134 $parent = $this->pdoDriver
;
135 if ($parent->transOff
) return true;
136 if (!$ok) return $parent->RollbackTrans();
137 if ($parent->transCnt
) $parent->transCnt
-= 1;
138 $parent->_autocommit
= true;
140 $ret = $parent->Execute('COMMIT');
144 function RollbackTrans()
146 $parent = $this->pdoDriver
;
147 if ($parent->transOff
) return true;
148 if ($parent->transCnt
) $parent->transCnt
-= 1;
149 $parent->_autocommit
= true;
151 $ret = $parent->Execute('ROLLBACK');
157 function MetaColumns($tab,$normalize=true)
159 global $ADODB_FETCH_MODE;
161 $parent = $this->pdoDriver
;
163 $save = $ADODB_FETCH_MODE;
164 $ADODB_FETCH_MODE = ADODB_FETCH_ASSOC
;
165 if ($parent->fetchMode
!== false) {
166 $savem = $parent->SetFetchMode(false);
168 $rs = $parent->Execute("PRAGMA table_info('$tab')");
170 $parent->SetFetchMode($savem);
173 $ADODB_FETCH_MODE = $save;
177 while ($r = $rs->FetchRow()) {
178 $type = explode('(', $r['type']);
180 if (sizeof($type) == 2) {
181 $size = trim($type[1], ')');
183 $fn = strtoupper($r['name']);
184 $fld = new ADOFieldObject
;
185 $fld->name
= $r['name'];
186 $fld->type
= $type[0];
187 $fld->max_length
= $size;
188 $fld->not_null
= $r['notnull'];
189 $fld->primary_key
= $r['pk'];
190 $fld->default_value
= $r['dflt_value'];
192 if ($save == ADODB_FETCH_NUM
) {
195 $arr[strtoupper($fld->name
)] = $fld;
199 $ADODB_FETCH_MODE = $save;
203 function MetaTables($ttype=false,$showSchema=false,$mask=false)
205 $parent = $this->pdoDriver
;
208 $save = $this->metaTablesSQL
;
209 $mask = $this->qstr(strtoupper($mask));
210 $this->metaTablesSQL
.= " AND name LIKE $mask";
213 $ret = $parent->GetCol($this->metaTablesSQL
);
216 $this->metaTablesSQL
= $save;
222 * Returns a driver-specific format for a bind parameter
224 * @param string $name
225 * @param string $type (ignored in driver)
229 public function param($name,$type='C')
231 return sprintf(':%s', $name);