85 lines
2.0 KiB
Plaintext
85 lines
2.0 KiB
Plaintext
|
<?php declare(strict_types=1);
|
||
|
/**
|
||
|
* Query
|
||
|
*
|
||
|
* SQL Query Builder / Database Abstraction Layer
|
||
|
*
|
||
|
* PHP version 8.1
|
||
|
*
|
||
|
* @package Query
|
||
|
* @author Timothy J. Warren <tim@timshome.page>
|
||
|
* @copyright 2012 - 2023 Timothy J. Warren
|
||
|
* @license http://www.opensource.org/licenses/mit-license.html MIT License
|
||
|
* @link https://git.timshomepage.net/aviat/Query
|
||
|
* @version 4.0.0
|
||
|
*/
|
||
|
namespace Query\Drivers\Mysql;
|
||
|
|
||
|
use PDO;
|
||
|
use Query\Drivers\AbstractDriver;
|
||
|
use function defined;
|
||
|
|
||
|
/**
|
||
|
* MySQL specific class
|
||
|
*/
|
||
|
class Driver extends AbstractDriver {
|
||
|
|
||
|
/**
|
||
|
* Set the backtick as the MySQL escape character
|
||
|
*/
|
||
|
protected string $escapeCharOpen = '`';
|
||
|
|
||
|
/**
|
||
|
* Set the backtick as the MySQL escape character
|
||
|
*/
|
||
|
protected string $escapeCharClose = '`';
|
||
|
|
||
|
/**
|
||
|
* Connect to MySQL Database
|
||
|
*
|
||
|
* @codeCoverageIgnore
|
||
|
*/
|
||
|
public function __construct(string $dsn, string $username=NULL, string $password=NULL, array $options=[])
|
||
|
{
|
||
|
// Set the charset to UTF-8
|
||
|
if (defined('\\PDO::MYSQL_ATTR_INIT_COMMAND'))
|
||
|
{
|
||
|
$options = array_merge($options, [
|
||
|
PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES UTF-8 COLLATE 'UTF-8'",
|
||
|
]);
|
||
|
}
|
||
|
|
||
|
if ( ! str_contains($dsn, 'mysql'))
|
||
|
{
|
||
|
$dsn = 'mysql:'.$dsn;
|
||
|
}
|
||
|
|
||
|
parent::__construct($dsn, $username, $password, $options);
|
||
|
}
|
||
|
|
||
|
/**
|
||
|
* Generate the returning clause for the current database
|
||
|
*/
|
||
|
public function returning(string $query, string $select): string
|
||
|
{
|
||
|
// @TODO add checks for MariaDB for future-proofing
|
||
|
// MariaDB 10.5.0+ supports the returning clause for insert
|
||
|
if (
|
||
|
stripos($query, 'insert') !== FALSE
|
||
|
&& version_compare($this->getVersion(), '10.5.0', '>=')
|
||
|
){
|
||
|
return parent::returning($query, $select);
|
||
|
}
|
||
|
|
||
|
// MariaDB 10.0.5+ supports the returning clause for delete
|
||
|
if (
|
||
|
stripos($query, 'delete') !== FALSE
|
||
|
&& version_compare($this->getVersion(), '10.0.5', '>=')
|
||
|
){
|
||
|
return parent::returning($query, $select);
|
||
|
}
|
||
|
|
||
|
// Just return the same SQL if the returning clause is not supported
|
||
|
return $query;
|
||
|
}
|
||
|
}
|