|
1
|
|
|
<?php |
|
2
|
|
|
|
|
3
|
|
|
namespace Ubiquity\db\providers; |
|
4
|
|
|
|
|
5
|
|
|
use Ubiquity\exceptions\DBException; |
|
6
|
|
|
|
|
7
|
|
|
/** |
|
8
|
|
|
* Ubiquity\db\providers$AbstractDbWrapper |
|
9
|
|
|
* This class is part of Ubiquity |
|
10
|
|
|
* |
|
11
|
|
|
* @author jcheron <[email protected]> |
|
12
|
|
|
* @version 1.0.6 |
|
13
|
|
|
* |
|
14
|
|
|
*/ |
|
15
|
|
|
abstract class AbstractDbWrapper { |
|
16
|
|
|
protected $dbInstance; |
|
17
|
|
|
protected $statements; |
|
18
|
|
|
protected $operations=[ |
|
19
|
|
|
DbOperations::CREATE_DATABASE=>'CREATE DATABASE {name}', |
|
20
|
|
|
DbOperations::CREATE_TABLE=>'CREATE TABLE {name} ({fields}) {attributes}', |
|
21
|
|
|
DbOperations::SELECT_DB=>'USE {name}', |
|
22
|
|
|
DbOperations::FIELD=>'{name} {type} {extra}', |
|
23
|
|
|
DbOperations::ALTER_TABLE=>'ALTER TABLE {tableName} {alter}', |
|
24
|
|
|
DbOperations::FOREIGN_KEY=>'ALTER TABLE {tableName} ADD CONSTRAINT {fkName} FOREIGN KEY ({fkFieldName}) REFERENCES {referencesTableName} ({referencesFieldName}) ON DELETE {onDelete} ON UPDATE {onUpdate}', |
|
25
|
|
|
DbOperations::ALTER_TABLE_KEY=>'ALTER TABLE {tableName} ADD {type} KEY ({pkFields})', |
|
26
|
|
|
DbOperations::AUTO_INC=>'ALTER TABLE {tableName} MODIFY {fieldName} AUTO_INCREMENT, AUTO_INCREMENT={value}', |
|
27
|
|
|
DbOperations::MODIFY_FIELD=>'ALTER TABLE {tableName} MODIFY {fieldName} {attributes}', |
|
28
|
|
|
DbOperations::ADD_FIELD=>'ALTER TABLE {tableName} ADD {fieldName} {attributes}' |
|
29
|
|
|
]; |
|
30
|
|
|
|
|
31
|
|
|
const PHP_TYPES = [ 'string' => true,'bool' => true,'float' => true,'int' => true ]; |
|
32
|
|
|
|
|
33
|
|
|
public $quote; |
|
34
|
|
|
|
|
35
|
|
|
abstract public function query(string $sql); |
|
36
|
|
|
|
|
37
|
|
|
abstract public function queryAll(string $sql, int $fetchStyle = null); |
|
38
|
|
|
|
|
39
|
|
|
abstract public function queryColumn(string $sql, int $columnNumber = null); |
|
40
|
|
|
|
|
41
|
138 |
|
abstract public static function getAvailableDrivers(); |
|
42
|
138 |
|
|
|
43
|
|
|
public function _getStatement(string $sql) { |
|
44
|
|
|
return $this->statements [\md5 ( $sql )] ??= $this->getStatement ( $sql ); |
|
45
|
|
|
} |
|
46
|
|
|
|
|
47
|
|
|
public function prepareNamedStatement(string $name, string $sql) { |
|
48
|
|
|
return $this->statements [$name] = $this->getStatement ( $sql ); |
|
49
|
|
|
} |
|
50
|
|
|
|
|
51
|
|
|
public function getNamedStatement(string $name, ?string $sql = null) { |
|
52
|
|
|
return $this->statements [$name] ??= $this->getStatement ( $sql ); |
|
53
|
|
|
} |
|
54
|
|
|
|
|
55
|
|
|
abstract public function getStatement(string $sql); |
|
56
|
|
|
|
|
57
|
|
|
abstract public function connect(string $dbType, $dbName, $serverName, string $port, string $user, string $password, array $options); |
|
58
|
|
|
|
|
59
|
|
|
abstract public function getDSN(string $serverName, string $port, string $dbName, string $dbType = 'mysql'); |
|
60
|
|
|
|
|
61
|
|
|
abstract public function execute(string $sql); |
|
62
|
|
|
|
|
63
|
|
|
abstract public function prepareStatement(string $sql); |
|
64
|
|
|
|
|
65
|
|
|
abstract public function executeStatement($statement, array $values = null); |
|
66
|
|
|
|
|
67
|
|
|
abstract public function statementRowCount($statement); |
|
68
|
|
|
|
|
69
|
|
|
abstract public function lastInsertId($name = null); |
|
70
|
|
|
|
|
71
|
|
|
/** |
|
72
|
|
|
* Used by DAO |
|
73
|
|
|
* |
|
74
|
|
|
* @param mixed $statement |
|
75
|
|
|
* @param string $parameter |
|
76
|
|
|
* @param mixed $value |
|
77
|
|
|
*/ |
|
78
|
|
|
abstract public function bindValueFromStatement($statement, $parameter, $value); |
|
79
|
|
|
|
|
80
|
|
|
abstract public function fetchColumn($statement, array $values = null, int $columnNumber = null); |
|
81
|
|
|
|
|
82
|
|
|
abstract public function fetchAll($statement, array $values = null, $mode = null); |
|
83
|
|
|
|
|
84
|
|
|
abstract public function fetchOne($statement, array $values = null, $mode = null); |
|
85
|
|
|
|
|
86
|
|
|
abstract public function fetchAllColumn($statement, array $values = null, string $column = null); |
|
87
|
|
|
|
|
88
|
|
|
abstract public function getTablesName(); |
|
89
|
|
|
|
|
90
|
|
|
abstract public function beginTransaction(); |
|
91
|
|
|
|
|
92
|
|
|
abstract public function commit(); |
|
93
|
|
|
|
|
94
|
|
|
abstract public function inTransaction(); |
|
95
|
|
|
|
|
96
|
|
|
abstract public function rollBack(); |
|
97
|
|
|
|
|
98
|
|
|
abstract public function nestable(); |
|
99
|
|
|
|
|
100
|
|
|
abstract public function savePoint($level); |
|
101
|
|
|
|
|
102
|
|
|
abstract public function releasePoint($level); |
|
103
|
|
|
|
|
104
|
|
|
abstract public function rollbackPoint($level); |
|
105
|
|
|
|
|
106
|
|
|
abstract public function ping(); |
|
107
|
|
|
|
|
108
|
|
|
abstract public function getPrimaryKeys($tableName); |
|
109
|
|
|
|
|
110
|
|
|
abstract public function getFieldsInfos($tableName); |
|
111
|
|
|
|
|
112
|
|
|
abstract public function getForeignKeys($tableName, $pkName, $dbName = null); |
|
113
|
|
|
|
|
114
|
|
|
abstract public function _optPrepareAndExecute($sql, array $values = null, $one = false); |
|
115
|
|
|
|
|
116
|
|
|
public function _optExecuteAndFetch($statement, array $values = null, $one = false) { |
|
117
|
|
|
} |
|
118
|
|
|
|
|
119
|
|
|
abstract public function getRowNum(string $tableName, string $pkName, string $condition): int; |
|
120
|
|
|
|
|
121
|
|
|
abstract public function groupConcat(string $fields, string $separator): string; |
|
122
|
|
|
|
|
123
|
|
|
public function toStringOperator() { |
|
124
|
|
|
return ''; |
|
125
|
102 |
|
} |
|
126
|
102 |
|
|
|
127
|
102 |
|
public function close() { |
|
128
|
|
|
$this->statements = [ ]; |
|
129
|
|
|
$this->dbInstance = null; |
|
130
|
|
|
} |
|
131
|
|
|
|
|
132
|
|
|
/** |
|
133
|
|
|
* |
|
134
|
4 |
|
* @return object |
|
135
|
4 |
|
*/ |
|
136
|
|
|
public function getDbInstance() { |
|
137
|
|
|
return $this->dbInstance; |
|
138
|
|
|
} |
|
139
|
|
|
|
|
140
|
|
|
/** |
|
141
|
|
|
* |
|
142
|
|
|
* @param object $dbInstance |
|
143
|
|
|
*/ |
|
144
|
|
|
public function setDbInstance($dbInstance) { |
|
145
|
|
|
$this->dbInstance = $dbInstance; |
|
146
|
|
|
} |
|
147
|
|
|
|
|
148
|
|
|
public function quoteValue($value, $type = 2) { |
|
149
|
|
|
return "'" . \addslashes ( $value ) . "'"; |
|
150
|
|
|
} |
|
151
|
|
|
|
|
152
|
|
|
/** |
|
153
|
|
|
* |
|
154
|
|
|
* @param string $dbType |
|
155
|
|
|
* @return string |
|
156
|
|
|
* |
|
157
|
|
|
* @deprecated use Database::getPHPType instead |
|
158
|
|
|
*/ |
|
159
|
|
|
public function getPHPType(string $dbType): string { |
|
160
|
|
|
return ''; |
|
161
|
|
|
} |
|
162
|
|
|
|
|
163
|
|
|
/** |
|
164
|
|
|
* Returns the SQL string for a migration operation. |
|
165
|
|
|
* @param string $operation |
|
166
|
1 |
|
* @return string |
|
167
|
1 |
|
*/ |
|
168
|
|
|
public function migrateOperation(string $operation):?string{ |
|
169
|
|
|
return $this->operations[$operation]??null; |
|
170
|
|
|
} |
|
171
|
|
|
|
|
172
|
|
|
/** |
|
173
|
|
|
* @param $isolationLevel |
|
174
|
|
|
* @throws DBException |
|
175
|
|
|
* @return mixed |
|
176
|
|
|
*/ |
|
177
|
|
|
public function setIsolationLevel($isolationLevel){ |
|
|
|
|
|
|
178
|
|
|
throw new DBException('The setIsolation level is not implemented for this wrapper'); |
|
179
|
|
|
} |
|
180
|
|
|
} |
This check looks for parameters that have been defined for a function or method, but which are not used in the method body.