* @copyright 2012 - 2020 Timothy J. Warren * @license http://www.opensource.org/licenses/mit-license.html MIT License * @link https://git.timshomepage.net/aviat/Query * @version 3.0.0 */ namespace Query\Drivers\Sqlite; use function is_array; use InvalidArgumentException; use PDO; use Query\Drivers\AbstractDriver; /** * SQLite specific class */ class Driver extends AbstractDriver { /** * SQLite has a truncate optimization, * but no support for the actual keyword * @var boolean */ protected bool $hasTruncate = FALSE; /** * Open SQLite Database * * @param string $dsn * @param string $user * @param string $pass * @param array $driverOptions */ public function __construct(string $dsn, string $user=NULL, string $pass=NULL, array $driverOptions=[]) { if (strpos($dsn, 'sqlite:') === FALSE) { $dsn = "sqlite:{$dsn}"; } parent::__construct($dsn, $user, $pass); } /** * Return list of dbs for the current connection, if possible. Meaningless for SQLite. * * @return array | null */ public function getDbs(): ?array { return NULL; } /** * List tables for the current database * * @return mixed */ public function getTables(): array { $sql = $this->getSql()->tableList(); $res = $this->query($sql); return dbFilter($res->fetchAll(PDO::FETCH_ASSOC), 'name'); } /** * Retrieve foreign keys for the table * * @param string $table * @return array */ public function getFks($table): array { $returnRows = []; foreach(parent::getFks($table) as $row) { $returnRows[] = [ 'child_column' => $row['from'], 'parent_table' => $row['table'], 'parent_column' => $row['to'], 'update' => $row['on_update'], 'delete' => $row['on_delete'] ]; } return $returnRows; } /** * Create sql for batch insert * * @codeCoverageIgnore * @param string $table * @param array $data * @return array */ public function insertBatch(string $table, array $data=[]): array { // If greater than version 3.7.11, supports the same syntax as // MySQL and Postgres if (version_compare($this->getVersion(), '3.7.11', '>=')) { return parent::insertBatch($table, $data); } // -------------------------------------------------------------------------- // Otherwise, do a union query as an analogue to a 'proper' batch insert // -------------------------------------------------------------------------- // Each member of the data array needs to be an array if ( ! is_array(current($data))) { throw new InvalidArgumentException('$data must be an array of arrays'); } // Start the block of sql statements $table = $this->quoteTable($table); $sql = "INSERT INTO {$table} \n"; // Create a key-value mapping for each field $first = array_shift($data); $cols = []; foreach($first as $colName => $datum) { $cols[] = $this->_quote($datum) . ' AS ' . $this->quoteIdent($colName); } $sql .= 'SELECT ' . implode(', ', $cols) . "\n"; foreach($data as $union) { $vals = array_map([$this, 'quote'], $union); $sql .= 'UNION SELECT ' . implode(',', $vals) . "\n"; } return [$sql, NULL]; } /** * Generate the returning clause for the current database * * @param string $query * @param string $select * @return string */ public function returning(string $query, string $select): string { // Return the same query, as the returning clause is not supported return $query; } }