diff --git a/.gitattributes b/.gitattributes index d4a788ade..ed8103553 100644 --- a/.gitattributes +++ b/.gitattributes @@ -1,10 +1,10 @@ -.gitattributes export-ignore -.gitignore export-ignore -.github export-ignore -appveyor.yml export-ignore -ncs.* export-ignore -phpstan.neon export-ignore -tests/ export-ignore +.gitattributes export-ignore +.github/ export-ignore +.gitignore export-ignore +CLAUDE.md export-ignore +ncs.* export-ignore +phpstan*.neon export-ignore +tests/ export-ignore -*.sh eol=lf -*.php* diff=php linguist-language=PHP +*.php* diff=php +*.sh text eol=lf diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index a172a2cf3..676680ce0 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -103,7 +103,7 @@ jobs: run: docker exec -i mssql /opt/mssql-tools18/bin/sqlcmd -S localhost -U SA -P 'YourStrong!Passw0rd' -Q 'CREATE DATABASE dibi_test' -N -C - run: composer install --no-progress --prefer-dist - - run: vendor/bin/tester -p phpdbg tests -s -C --coverage ./coverage.xml --coverage-src ./src + - run: composer tester -- -p phpdbg --coverage ./coverage.xml --coverage-src ./src - if: failure() uses: actions/upload-artifact@v4 with: diff --git a/CLAUDE.md b/CLAUDE.md new file mode 100644 index 000000000..d68c40644 --- /dev/null +++ b/CLAUDE.md @@ -0,0 +1,428 @@ +# CLAUDE.md + +This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository. + +## Project Overview + +**Dibi** is a PHP database abstraction library (DBAL) providing a unified interface for multiple database systems (MySQL, PostgreSQL, SQLite, Oracle, Firebird, ODBC). It is a standalone library, not an application. + +- **PHP Version**: 8.2 - 8.5 +- **Homepage**: https://dibi.nette.org +- **Author**: David Grudl (Nette framework creator) + +## Essential Commands + +### Development Workflow + +```bash +# Run all tests +composer run tester + +# Run specific test file +vendor/bin/tester tests/dibi/DataSource.phpt -s -C + +# Run tests in a directory +vendor/bin/tester tests/dibi/ -s -C + +# Static analysis (PHPStan Level 5) +composer run phpstan +``` + +### Installation + +```bash +composer install +``` + +## Architecture Overview + +### Core Components + +**Connection Layer** (`src/Dibi/Connection.php`): +- Main entry point for all database operations +- Manages connection lifecycle, transactions, and query execution +- Event system for profiling/logging +- Lazy connection initialization + +**Driver Architecture** (`src/Dibi/Drivers/`): +- 27+ driver implementations (MySqli, PDO, PostgreSQL, SQLite3, Oracle, Firebird, ODBC, etc.) +- Each driver implements: `Driver`, `ResultDriver`, and `Reflector` interfaces +- Handles database-specific SQL escaping, type conversion, and LIMIT/OFFSET injection +- Key files: `MySqliDriver.php`, `PdoDriver.php`, `PostgreDriver.php`, `Sqlite3Driver.php` + +**Query Building** (`src/Dibi/Fluent.php`): +- Fluent interface for building dynamic SQL queries +- Methods: `select()`, `from()`, `where()`, `join()`, `orderBy()`, `limit()`, etc. +- Supports SELECT, INSERT, UPDATE, DELETE operations +- Cloning support for query variants + +**Parameter Translation** (`src/Dibi/Translator.php`): +- Most complex component - converts parameter modifiers to driver-specific escaping +- Handles modifiers: `%s`, `%i`, `%n`, `%d`, `%dt`, `%and`, `%or`, `%a`, `%v`, etc. +- Smart array expansion for IN clauses +- Conditional SQL blocks with `%if...%end` +- Expression support via `Literal` and `Expression` + +**Result Handling** (`src/Dibi/Result.php`, `src/Dibi/Row.php`): +- Lazy loading of rows from drivers +- Multiple fetch methods: `fetch()`, `fetchAll()`, `fetchAssoc()`, `fetchPairs()`, `fetchSingle()` +- Automatic type detection and conversion +- Iterator implementation for memory-efficient processing + +**Database Reflection** (`src/Dibi/Reflection/`): +- Schema introspection API for tables, columns, indexes, foreign keys +- Works through `Reflector` interface implemented by each driver +- Key classes: `Database`, `Table`, `Column`, `Index`, `ForeignKey` + +**Framework Integration** (`src/Dibi/Bridges/`): +- `Nette/DibiExtension3.php` - Nette 3.x DI container integration +- `Tracy/Panel.php` - Tracy debugger panel for query visualization + +### Key Interfaces + +Defined in `src/Dibi/interfaces.php`: +- `Driver` - Database-specific operations (query, escape, reflection) +- `ResultDriver` - Result set handling +- `Reflector` - Schema introspection +- `IConnection` - Connection contract +- `IDataSource` - Generic data source abstraction + +### Static Facade + +`src/Dibi/dibi.php` provides a static facade for global access to the default connection instance (backward compatibility layer). + +## Code Standards + +### PHP Coding Style + +- **Strict types required**: `declare(strict_types=1)` in all files +- **Tabs for indentation** (not spaces) +- **Single quotes** for strings (except HTML) +- **Two empty lines between methods** +- **PSR-12 compliant** with Nette modifications +- **Type declarations**: All properties, parameters, and return types must be typed +- **Return type and opening brace on separate lines**: + +```php +public function example( + string $param, + array $options, +): void +{ + // method body +} +``` + +### Documentation (PHPDoc) + +- Never duplicate signature information without adding value +- Document array contents: `@return string[]` +- Use two spaces after type/param: `@return string description` +- Only document when explaining additional context, limitations, or unusual usage +- For exceptions, describe the problem in active voice without "Exception that is thrown when" + +### Naming Conventions + +- Avoid abbreviations unless full name is too long +- UPPERCASE for two-letter abbreviations, PascalCase/camelCase for longer ones +- PascalCase for classes, camelCase for methods/properties +- Never use prefixes like `Abstract`, `Interface`, or `I` + +## Testing Patterns + +### Test File Structure + +Tests use **Nette Tester** with `.phpt` extension: + +```php +loadFile(__DIR__ . "/data/$config[system].sql"); + +// Test description as first parameter +Assert::same(3, $conn->dataSource('SELECT * FROM products')->count()); + +Assert::exception( + fn() => $conn->query('INVALID SQL'), + Dibi\Exception::class, + 'SQL error message', +); +``` + +### Key Testing Principles + +- Each test file covers a specific class or feature +- Use `Assert::same()` for strict comparisons +- Use `Assert::match()` for pattern matching with SQL +- Use `Assert::exception()` for exception testing +- Tests are located in `tests/dibi/` +- Test data SQL files in `tests/dibi/data/` + +## Driver-Specific Development + +When modifying or adding drivers: + +1. **Implement core interfaces**: `Driver`, `ResultDriver`, `Reflector` +2. **Handle type escaping** for: text, binary, identifier, boolean, date, datetime +3. **SQL injection methods**: How to add LIMIT/OFFSET to queries +4. **Result handling**: Create driver-specific `*Result` class +5. **Schema reflection**: Create driver-specific `*Reflector` class + +## Common Development Patterns + +### Adding New Modifiers + +Modifiers are handled in `src/Dibi/Translator.php`. The translation logic maps modifiers to driver-specific escaping: + +- Check `formatValue()` method for value formatting +- Update `modifier()` method for new modifier types +- Test with multiple drivers + +### Working with Results + +Result processing happens in two stages: +1. **Driver-level**: `ResultDriver` implementation returns raw data +2. **Abstraction-level**: `Result` class processes and normalizes data + +### Exception Hierarchy + +All exceptions inherit from `Dibi\Exception`. Specific exceptions in `src/Dibi/exceptions.php`: +- `ConstraintViolationException` +- `ForeignKeyConstraintViolationException` +- `NotNullConstraintViolationException` +- `UniqueConstraintViolationException` + +## Supported Databases + +The library supports these database systems (drivers in `src/Dibi/Drivers/`): + +- **MySQL/MariaDB** (via MySqli or PDO) +- **PostgreSQL** (native or PDO) +- **SQLite 3** (native or PDO) +- **MS SQL Server** (2012+, PDO or sqlsrv) +- **Oracle** (OCI8 or PDO) +- **Firebird/Interbase** +- **ODBC** +- **DummyDriver** for testing + +## Query Language Features + +### Parameter Modifiers + +Basic value modifiers: +- `%s` - string (NULL if value is null) +- `%sN` - string, but '' translates as NULL +- `%bin` - binary data +- `%b` - boolean +- `%i` - integer +- `%iN` - integer, but 0 translates as NULL +- `%f` - float +- `%d` - date (accepts DateTime, string or UNIX timestamp) +- `%dt` - datetime (accepts DateTime, string or UNIX timestamp) +- `%n` - identifier (table or column name, handles dots for qualified names) +- `%N` - identifier, treats period as ordinary character (for aliases, database names) +- `%SQL` - direct SQL insertion (alternative: `Dibi\Literal`) +- `%ex` - expands array of SQL expressions +- `%lmt` - adds LIMIT clause +- `%ofs` - adds OFFSET clause + +LIKE modifiers for pattern matching: +- `%like~` - expression starts with string +- `%~like` - expression ends with string +- `%~like~` - expression contains string +- `%like` - expression matches string + +### Array Modifiers + +When passing arrays as parameters: +- `%and` - `key1 = value1 AND key2 = value2 AND ...` +- `%or` - `key1 = value1 OR key2 = value2 OR ...` +- `%a` (assoc) - `key1 = value1, key2 = value2, ...` (for UPDATE SET) +- `%l` or `%in` (list) - `(val1, val2, ...)` (for IN clauses) +- `%v` (values) - `(key1, key2, ...) VALUES (value1, value2, ...)` (for INSERT) +- `%m` (multi) - multiple value rows for batch INSERT +- `%by` (ordering) - `key1 ASC, key2 DESC ...` (for ORDER BY) +- `%n` (names) - `key1, key2 AS alias, ...` (for SELECT columns) + +Example usage: +```php +// UPDATE with %a +$database->query('UPDATE users SET %a', ['name' => 'Jim', 'year' => 1978]); + +// WHERE with %and +$database->query('SELECT * FROM users WHERE %and', ['name' => 'Jim', 'active' => true]); + +// INSERT with %v +$database->query('INSERT INTO users %v', ['name' => 'Jim', 'year' => 1978]); + +// Multiple INSERT with %m +$database->query('INSERT INTO users %m', [ + ['name' => 'Jim', 'year' => 1978], + ['name' => 'Jack', 'year' => 1987], +]); +``` + +### Advanced Query Features + +**Modifiers in array keys** (for UPDATE): +```php +$database->query('UPDATE table SET', [ + 'date%SQL' => 'NOW()', + 'title' => 'normal value', +]); +// UPDATE table SET `date` = NOW(), `title` = 'normal value' +``` + +**Literal SQL** (bypass escaping): +```php +$database->literal('NOW()'); // returns Dibi\Literal object +``` + +**Expressions** (with parameters): +```php +$database::expression('SHA1(?)', 'secret'); // returns Dibi\Expression object +``` + +**Conditional SQL** (`%if`, `%else`, `%end`): +```php +$database->query(' + SELECT * + FROM table + %if', isset($user), 'WHERE user=%s', $user, '%end + ORDER BY name +'); +``` + +**Nested conditions in WHERE** (arrays without keys): +```php +$database->query('SELECT * FROM table WHERE %and', [ + 'number > 10', + 'number < 100', + ['%or', ['left' => 1, 'top' => 2]], +]); +// WHERE (number > 10) AND (number < 100) AND (`left` = 1 OR `top` = 2) +``` + +**Table/column substitutions** (prefixes): +```php +$database->substitute('blog', 'wp_'); +$database->query("UPDATE [:blog:items] SET [text]='Hello'"); +// UPDATE `wp_items` SET `text`='Hello' +``` + +### Result Fetching Methods + +**Advanced fetchAssoc()** - Reshapes flat JOIN results into nested arrays: + +```php +// Simple associative array by key +$result->fetchAssoc('id'); // returns [$id => $row, ...] + +// Two-level nesting +$result->fetchAssoc('customer_id|order_id'); +// returns [$customerId => [$orderId => $row, ...], ...] + +// With intermediate row object +$result->fetchAssoc('customer_id->order_id'); +// returns [$customerId => $row with ->order_id[$orderId], ...] + +// With sequential array for duplicate keys +$result->fetchAssoc('name[]order_id'); +// returns [$name => [[$orderId => $row], [$orderId2 => $row2]], ...] +``` + +The descriptor syntax: +- `|` - creates new array level (associative by key) +- `->` - inserts row object as intermediate element +- `[]` - creates sequential array for duplicate keys + +### Transaction Methods + +Four methods for transaction handling: +```php +$database->beginTransaction(); +$database->commit(); +$database->rollback(); + +// Or using callback (auto-commits on success, auto-rolls back on exception) +$database->transaction(function () use ($database) { + $database->query('...'); + $database->query('...'); +}); +``` + +### Debugging and Testing + +**Query inspection** without execution: +```php +$database->test('SELECT * FROM users WHERE id = ?', $id); +// Echoes the SQL that would be executed +``` + +**Result dumping**: +```php +$result->dump(); // Outputs result as HTML table +``` + +**Query statistics** (available via static facade): +```php +dibi::$sql; // Latest SQL query executed +dibi::$elapsedTime; // Duration in seconds +dibi::$numOfQueries; // Total number of queries +dibi::$totalTime; // Total execution time +``` + +**Logging configuration**: +```php +$database = new Dibi\Connection([ + 'driver' => 'mysqli', + // ... connection params + 'profiler' => [ + 'file' => 'queries.log', + ], +]); +``` + +### Type Handling + +**Manual type specification**: +```php +$result->setType('id', Dibi\Type::INTEGER); +$result->setType('price', Dibi\Type::FLOAT); +$row = $result->fetch(); +// Now $row->id is guaranteed to be int +``` + +**DateTime support**: +```php +$database->query('INSERT INTO users', [ + 'created' => new DateTime, + 'expires' => new DateTime('+1 year'), +]); +``` + +### Identifier Quoting + +Dibi automatically converts bracket/backtick notation to database-specific format: +```php +$database->query("UPDATE `table` SET [status]='value'"); +// MySQL: UPDATE `table` SET `status`='value' +// ODBC: UPDATE [table] SET [status]='value' +``` + +## Important Notes + +- **Zero production dependencies** - Core library is completely standalone +- **Lazy connections** - Database connections are established only when first query is executed +- **Event system** - Use `Connection::$onEvent` for query profiling and logging +- **Multi-database testing** - Tests run against MySQL, PostgreSQL, and SQLite configurations +- **PHPStan Level 5** - All code must pass static analysis at level 5 +- **SQL injection protection** - NEVER concatenate user input into SQL, always use placeholders or modifiers diff --git a/composer.json b/composer.json index a562a8b40..8216a4e5d 100644 --- a/composer.json +++ b/composer.json @@ -2,7 +2,7 @@ "name": "dibi/dibi", "description": "Dibi is Database Abstraction Library for PHP", "keywords": ["database", "dbal", "mysql", "postgresql", "sqlite", "mssql", "sqlsrv", "oracle", "access", "pdo", "odbc"], - "homepage": "https://dibiphp.com", + "homepage": "https://dibi.nette.org", "license": ["BSD-3-Clause", "GPL-2.0-only", "GPL-3.0-only"], "authors": [ { @@ -36,7 +36,7 @@ }, "extra": { "branch-alias": { - "dev-master": "5.1-dev" + "dev-master": "6.0-dev" } } } diff --git a/contributing.md b/contributing.md index a6a9e4de8..a8fa29720 100644 --- a/contributing.md +++ b/contributing.md @@ -11,9 +11,6 @@ Dibi welcomes your contributions. There are several ways to help out: Issues ------ -Please **do not use the issue tracker to ask questions**. We will be happy to help you -on [Dibi forum](https://forum.dibiphp.com). - A good bug report shouldn't leave others needing to chase you up for more information. Please try to be as detailed as possible in your report. @@ -24,8 +21,6 @@ case to convince the project's developers of the merits of this feature. Contributing ------------ -The best way to propose a feature is to discuss your ideas on [Dibi forum](https://forum.dibiphp.com) before implementing them. - Please do not fix whitespace, format code, or make a purely cosmetic patch. Thanks! :heart: diff --git a/readme.md b/readme.md index a0a86310b..4319c7b89 100644 --- a/readme.md +++ b/readme.md @@ -1,4 +1,4 @@ -[Dibi](https://dibiphp.com) - smart database layer for PHP [![Buy me a coffee](https://files.nette.org/images/coffee1s.png)](https://nette.org/make-donation?to=dibi) +[Dibi](https://dibi.nette.org) - smart database layer for PHP [![Buy me a coffee](https://files.nette.org/images/coffee1s.png)](https://nette.org/make-donation?to=dibi) ========================================================= [![Downloads this Month](https://img.shields.io/packagist/dm/dibi/dibi.svg)](https://packagist.org/packages/dibi/dibi) @@ -34,14 +34,14 @@ Install Dibi via Composer: composer require dibi/dibi ``` -The Dibi 5.1 requires PHP version 8.2 and supports PHP up to 8.5. +The Dibi 6.0 requires PHP version 8.2 and supports PHP up to 8.5. Usage ----- Refer to the `examples` directory for examples. Dibi documentation is -available on the [homepage](https://dibiphp.com). +available on the [homepage](https://dibi.nette.org). ### Connecting to database diff --git a/src/Dibi/Bridges/Nette/DibiExtension22.php b/src/Dibi/Bridges/Nette/DibiExtension22.php index 8f310b034..3af5ec3cf 100644 --- a/src/Dibi/Bridges/Nette/DibiExtension22.php +++ b/src/Dibi/Bridges/Nette/DibiExtension22.php @@ -1,7 +1,7 @@ getContainerBuilder(); $config = $this->getConfig(); diff --git a/src/Dibi/Bridges/Tracy/Panel.php b/src/Dibi/Bridges/Tracy/Panel.php index f53e50028..68247c04e 100644 --- a/src/Dibi/Bridges/Tracy/Panel.php +++ b/src/Dibi/Bridges/Tracy/Panel.php @@ -1,7 +1,7 @@ getConfig('driver') === 'oracle' ? 'EXPLAIN PLAN FOR' : 'EXPLAIN'); try { $explain = @Helpers::dump($connection->nativeQuery("$cmd $event->sql"), return: true); - } catch (Dibi\Exception $e) { + } catch (Dibi\Exception) { } [$connection->onEvent, \dibi::$numOfQueries, \dibi::$totalTime] = $backup; diff --git a/src/Dibi/Connection.php b/src/Dibi/Connection.php index 6ecf7b6e7..4031fbb3c 100644 --- a/src/Dibi/Connection.php +++ b/src/Dibi/Connection.php @@ -1,7 +1,7 @@ Drivers\Ibase\Connection::class, + 'mysqli' => Drivers\MySQLi\Connection::class, + 'odbc' => Drivers\ODBC\Connection::class, + 'oracle' => Drivers\OCI8\Connection::class, + 'pdo' => Drivers\PDO\Connection::class, + 'postgre' => Drivers\PgSQL\Connection::class, + 'sqlite3' => Drivers\SQLite3\Connection::class, + 'sqlite' => Drivers\SQLite3\Connection::class, + 'sqlsrv' => Drivers\SQLSrv\Connection::class, + ]; + /** function (Event $event); Occurs after query is executed */ public ?array $onEvent = []; private array $config; /** @var string[] resultset formats */ private array $formats; - private ?Driver $driver = null; + private ?Drivers\Connection $driver = null; + private Drivers\Engine $engine; private ?Translator $translator = null; /** @var array */ @@ -122,17 +135,16 @@ public function __destruct() */ final public function connect(): void { - if ($this->config['driver'] instanceof Driver) { + if ($this->config['driver'] instanceof Drivers\Connection) { $this->driver = $this->config['driver']; $this->translator = new Translator($this); return; - } elseif (is_subclass_of($this->config['driver'], Driver::class)) { + } elseif (is_subclass_of($this->config['driver'], Drivers\Connection::class)) { $class = $this->config['driver']; } else { - $class = preg_replace(['#\W#', '#sql#'], ['_', 'Sql'], ucfirst(strtolower($this->config['driver']))); - $class = "Dibi\\Drivers\\{$class}Driver"; + $class = self::Drivers[strtolower($this->config['driver'])] ?? throw new Exception("Unknown driver '{$this->config['driver']}'."); if (!class_exists($class)) { throw new Exception("Unable to create instance of Dibi driver '$class'."); } @@ -198,7 +210,7 @@ final public function getConfig(?string $key = null, $default = null): mixed /** * Returns the driver and connects to a database in lazy mode. */ - final public function getDriver(): Driver + final public function getDriver(): Drivers\Connection { if (!$this->driver) { $this->connect(); @@ -286,7 +298,7 @@ final public function nativeQuery(#[Language('SQL')] string $sql): Result throw $e; } - $res = $this->createResultSet($res ?: new Drivers\NoDataResult(max(0, $this->driver->getAffectedRows()))); + $res = $this->createResultSet($res ?? new Drivers\Dummy\Result(max(0, $this->driver->getAffectedRows()))); if ($event) { $this->onEvent($event->done($res)); } @@ -450,7 +462,7 @@ public function transaction(callable $callback): mixed /** * Result set factory. */ - public function createResultSet(ResultDriver $resultDriver): Result + public function createResultSet(Drivers\Result $resultDriver): Result { return (new Result($resultDriver, $this->config['result']['normalize'] ?? true)) ->setFormats($this->formats); @@ -659,6 +671,15 @@ public function loadFile(string $file, ?callable $onProgress = null): int } + public function getDatabaseEngine(): Drivers\Engine + { + if (!$this->driver) { // TODO + $this->connect(); + } + return $this->engine ??= $this->driver->getReflector(); + } + + /** * Gets a information about the current database. */ @@ -668,7 +689,7 @@ public function getDatabaseInfo(): Reflection\Database $this->connect(); } - return new Reflection\Database($this->driver->getReflector(), $this->config['database'] ?? null); + return new Reflection\Database($this->getDatabaseEngine(), $this->config['database'] ?? null); } diff --git a/src/Dibi/DataSource.php b/src/Dibi/DataSource.php index 04ffc29c1..c2c6d9a55 100644 --- a/src/Dibi/DataSource.php +++ b/src/Dibi/DataSource.php @@ -1,7 +1,7 @@ sql = strpbrk($sql, " \t\r\n") === false - ? $connection->getDriver()->escapeIdentifier($sql) // table name + ? $connection->getDatabaseEngine()->escapeIdentifier($sql) // table name : '(' . $sql . ') t'; // SQL command $this->connection = $connection; } diff --git a/src/Dibi/DateTime.php b/src/Dibi/DateTime.php index befcd98f1..a5d263e02 100644 --- a/src/Dibi/DateTime.php +++ b/src/Dibi/DateTime.php @@ -1,7 +1,7 @@ setTimezone($timezone); parent::__construct($tmp->format('Y-m-d H:i:s.u'), $tmp->getTimezone()); diff --git a/src/Dibi/Drivers/Connection.php b/src/Dibi/Drivers/Connection.php new file mode 100644 index 000000000..6549e57f3 --- /dev/null +++ b/src/Dibi/Drivers/Connection.php @@ -0,0 +1,77 @@ +format("'Y-m-d'"); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return "'" . substr($value->format('Y-m-d H:i:s.u'), 0, -2) . "'"; + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = addcslashes($this->driver->escapeText($value), '%_\\'); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'") . " ESCAPE '\\'"; + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit > 0 || $offset > 0) { + // http://www.firebirdsql.org/refdocs/langrefupd20-select.html + $sql = 'SELECT ' . ($limit > 0 ? 'FIRST ' . $limit : '') . ($offset > 0 ? ' SKIP ' . $offset : '') . ' * FROM (' . $sql . ')'; + } + } + + /** * Returns list of tables. */ diff --git a/src/Dibi/Drivers/MySqlReflector.php b/src/Dibi/Drivers/Engines/MySQLEngine.php similarity index 65% rename from src/Dibi/Drivers/MySqlReflector.php rename to src/Dibi/Drivers/Engines/MySQLEngine.php index 0f968a712..1db5491b5 100644 --- a/src/Dibi/Drivers/MySqlReflector.php +++ b/src/Dibi/Drivers/Engines/MySQLEngine.php @@ -1,29 +1,91 @@ format("'Y-m-d'"); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return $value->format("'Y-m-d H:i:s.u'"); + } + + + public function escapeDateInterval(\DateInterval $value): string + { + if ($value->y || $value->m || $value->d) { + throw new Dibi\NotSupportedException('Only time interval is supported.'); + } + + return $value->format("'%r%H:%I:%S.%f'"); + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_"); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit < 0 || $offset < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + + } elseif ($limit !== null || $offset) { + // see http://dev.mysql.com/doc/refman/5.0/en/select.html + $sql .= ' LIMIT ' . ($limit ?? '18446744073709551615') + . ($offset ? ' OFFSET ' . $offset : ''); + } + } + + /** * Returns list of tables. */ @@ -47,7 +109,7 @@ public function getTables(): array */ public function getColumns(string $table): array { - $res = $this->driver->query("SHOW FULL COLUMNS FROM {$this->driver->escapeIdentifier($table)}"); + $res = $this->driver->query("SHOW FULL COLUMNS FROM {$this->escapeIdentifier($table)}"); $columns = []; while ($row = $res->fetch(true)) { $type = explode('(', $row['Type']); @@ -72,7 +134,7 @@ public function getColumns(string $table): array */ public function getIndexes(string $table): array { - $res = $this->driver->query("SHOW INDEX FROM {$this->driver->escapeIdentifier($table)}"); + $res = $this->driver->query("SHOW INDEX FROM {$this->escapeIdentifier($table)}"); $indexes = []; while ($row = $res->fetch(true)) { $indexes[$row['Key_name']]['name'] = $row['Key_name']; diff --git a/src/Dibi/Drivers/OdbcReflector.php b/src/Dibi/Drivers/Engines/ODBCEngine.php similarity index 51% rename from src/Dibi/Drivers/OdbcReflector.php rename to src/Dibi/Drivers/Engines/ODBCEngine.php index 0ec04a4c1..3a3ad1d3c 100644 --- a/src/Dibi/Drivers/OdbcReflector.php +++ b/src/Dibi/Drivers/Engines/ODBCEngine.php @@ -1,28 +1,87 @@ format('#m/d/Y#'); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return $value->format($this->microseconds ? '#m/d/Y H:i:s.u#' : '#m/d/Y H:i:s#'); // TODO + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($offset) { + throw new Dibi\NotSupportedException('Offset is not supported by this database.'); + + } elseif ($limit < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + + } elseif ($limit !== null) { + $sql = 'SELECT TOP ' . $limit . ' * FROM (' . $sql . ') t'; + } + } + + /** * Returns list of tables. */ diff --git a/src/Dibi/Drivers/Engines/OracleEngine.php b/src/Dibi/Drivers/Engines/OracleEngine.php new file mode 100644 index 000000000..620b15526 --- /dev/null +++ b/src/Dibi/Drivers/Engines/OracleEngine.php @@ -0,0 +1,153 @@ +nativeDate // TODO + ? "to_date('" . $value->format('Y-m-d') . "', 'YYYY-mm-dd')" + : $value->format('U'); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return $this->nativeDate // TODO + ? "to_date('" . $value->format('Y-m-d G:i:s') . "', 'YYYY-mm-dd hh24:mi:ss')" + : $value->format('U'); + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\\%_"); + $value = str_replace("'", "''", $value); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit < 0 || $offset < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + + } elseif ($offset) { + // see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html + $sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t ' + . ($limit !== null ? 'WHERE ROWNUM <= ' . ($offset + $limit) : '') + . ') WHERE "__rnum" > ' . $offset; + + } elseif ($limit !== null) { + $sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . $limit; + } + } + + + /** + * Returns list of tables. + */ + public function getTables(): array + { + $res = $this->driver->query('SELECT * FROM cat'); + $tables = []; + while ($row = $res->fetch(false)) { + if ($row[1] === 'TABLE' || $row[1] === 'VIEW') { + $tables[] = [ + 'name' => $row[0], + 'view' => $row[1] === 'VIEW', + ]; + } + } + + return $tables; + } + + + /** + * Returns metadata for all columns in a table. + */ + public function getColumns(string $table): array + { + $res = $this->driver->query('SELECT * FROM "ALL_TAB_COLUMNS" WHERE "TABLE_NAME" = ' . $this->driver->escapeText($table)); + $columns = []; + while ($row = $res->fetch(true)) { + $columns[] = [ + 'table' => $row['TABLE_NAME'], + 'name' => $row['COLUMN_NAME'], + 'nativetype' => $row['DATA_TYPE'], + 'size' => $row['DATA_LENGTH'] ?? null, + 'nullable' => $row['NULLABLE'] === 'Y', + 'default' => $row['DATA_DEFAULT'], + 'vendor' => $row, + ]; + } + + return $columns; + } + + + /** + * Returns metadata for all indexes in a table. + */ + public function getIndexes(string $table): array + { + throw new Dibi\NotImplementedException; + } + + + /** + * Returns metadata for all foreign keys in a table. + */ + public function getForeignKeys(string $table): array + { + throw new Dibi\NotImplementedException; + } +} diff --git a/src/Dibi/Drivers/PostgreReflector.php b/src/Dibi/Drivers/Engines/PostgreSQLEngine.php similarity index 76% rename from src/Dibi/Drivers/PostgreReflector.php rename to src/Dibi/Drivers/Engines/PostgreSQLEngine.php index ab93130c7..338be7395 100644 --- a/src/Dibi/Drivers/PostgreReflector.php +++ b/src/Dibi/Drivers/Engines/PostgreSQLEngine.php @@ -1,28 +1,92 @@ format("'Y-m-d'"); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return $value->format("'Y-m-d H:i:s.u'"); + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $bs = $this->driver->escapeText('\\'); // standard_conforming_strings = on/off + $value = $this->driver->escapeText($value); + $value = strtr($value, ['%' => $bs . '%', '_' => $bs . '_', '\\' => '\\\\']); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit < 0 || $offset < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + } + + if ($limit !== null) { + $sql .= ' LIMIT ' . $limit; + } + + if ($offset) { + $sql .= ' OFFSET ' . $offset; + } + } + + /** * Returns list of tables. */ @@ -63,7 +127,7 @@ public function getTables(): array */ public function getColumns(string $table): array { - $_table = $this->driver->escapeText($this->driver->escapeIdentifier($table)); + $_table = $this->driver->escapeText($this->escapeIdentifier($table)); $res = $this->driver->query(" SELECT * @@ -123,7 +187,7 @@ public function getColumns(string $table): array */ public function getIndexes(string $table): array { - $_table = $this->driver->escapeText($this->driver->escapeIdentifier($table)); + $_table = $this->driver->escapeText($this->escapeIdentifier($table)); $res = $this->driver->query(" SELECT a.attnum AS ordinal_position, @@ -173,7 +237,7 @@ public function getIndexes(string $table): array */ public function getForeignKeys(string $table): array { - $_table = $this->driver->escapeText($this->driver->escapeIdentifier($table)); + $_table = $this->driver->escapeText($this->escapeIdentifier($table)); $res = $this->driver->query(" SELECT diff --git a/src/Dibi/Drivers/SqlsrvReflector.php b/src/Dibi/Drivers/Engines/SQLServerEngine.php similarity index 65% rename from src/Dibi/Drivers/SqlsrvReflector.php rename to src/Dibi/Drivers/Engines/SQLServerEngine.php index 45b841cf7..ff1b620a5 100644 --- a/src/Dibi/Drivers/SqlsrvReflector.php +++ b/src/Dibi/Drivers/Engines/SQLServerEngine.php @@ -1,29 +1,89 @@ format("'Y-m-d'"); + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')'; + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit < 0 || $offset < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + + } elseif ($limit !== null) { + // requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx + $sql = sprintf('%s OFFSET %d ROWS FETCH NEXT %d ROWS ONLY', rtrim($sql), $offset, $limit); + } elseif ($offset) { + // requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx + $sql = sprintf('%s OFFSET %d ROWS', rtrim($sql), $offset); + } + } + + /** * Returns list of tables. */ diff --git a/src/Dibi/Drivers/SqliteReflector.php b/src/Dibi/Drivers/Engines/SQLiteEngine.php similarity index 64% rename from src/Dibi/Drivers/SqliteReflector.php rename to src/Dibi/Drivers/Engines/SQLiteEngine.php index 8c1e3adea..703c03dfd 100644 --- a/src/Dibi/Drivers/SqliteReflector.php +++ b/src/Dibi/Drivers/Engines/SQLiteEngine.php @@ -1,28 +1,85 @@ format($this->fmtDate); // TODO + } + + + public function escapeDateTime(\DateTimeInterface $value): string + { + return $value->format($this->fmtDateTime); // TODO + } + + + public function escapeDateInterval(\DateInterval $value): string + { + throw new Dibi\NotImplementedException; + } + + + /** + * Encodes string for use in a LIKE statement. + */ + public function escapeLike(string $value, int $pos): string + { + $value = addcslashes($this->driver->escapeText($value), '%_\\'); + return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'") . " ESCAPE '\\'"; + } + + + /** + * Injects LIMIT/OFFSET to the SQL query. + */ + public function applyLimit(string &$sql, ?int $limit, ?int $offset): void + { + if ($limit < 0 || $offset < 0) { + throw new Dibi\NotSupportedException('Negative offset or limit.'); + + } elseif ($limit !== null || $offset) { + $sql .= ' LIMIT ' . ($limit ?? '-1') + . ($offset ? ' OFFSET ' . $offset : ''); + } + } + + /** * Returns list of tables. */ @@ -48,7 +105,7 @@ public function getTables(): array */ public function getColumns(string $table): array { - $res = $this->driver->query("PRAGMA table_info({$this->driver->escapeIdentifier($table)})"); + $res = $this->driver->query("PRAGMA table_info({$this->escapeIdentifier($table)})"); $columns = []; while ($row = $res->fetch(true)) { $column = $row['name']; @@ -75,7 +132,7 @@ public function getColumns(string $table): array */ public function getIndexes(string $table): array { - $res = $this->driver->query("PRAGMA index_list({$this->driver->escapeIdentifier($table)})"); + $res = $this->driver->query("PRAGMA index_list({$this->escapeIdentifier($table)})"); $indexes = []; while ($row = $res->fetch(true)) { $indexes[$row['name']]['name'] = $row['name']; @@ -83,7 +140,7 @@ public function getIndexes(string $table): array } foreach ($indexes as $index => $values) { - $res = $this->driver->query("PRAGMA index_info({$this->driver->escapeIdentifier($index)})"); + $res = $this->driver->query("PRAGMA index_info({$this->escapeIdentifier($index)})"); while ($row = $res->fetch(true)) { $indexes[$index]['columns'][$row['seqno']] = $row['name']; } @@ -126,7 +183,7 @@ public function getIndexes(string $table): array */ public function getForeignKeys(string $table): array { - $res = $this->driver->query("PRAGMA foreign_key_list({$this->driver->escapeIdentifier($table)})"); + $res = $this->driver->query("PRAGMA foreign_key_list({$this->escapeIdentifier($table)})"); $keys = []; while ($row = $res->fetch(true)) { $keys[$row['id']]['name'] = $row['id']; // foreign key name diff --git a/src/Dibi/Drivers/FirebirdDriver.php b/src/Dibi/Drivers/Firebird/Connection.php similarity index 76% rename from src/Dibi/Drivers/FirebirdDriver.php rename to src/Dibi/Drivers/Firebird/Connection.php index 845c68837..1cdbe0917 100644 --- a/src/Dibi/Drivers/FirebirdDriver.php +++ b/src/Dibi/Drivers/Firebird/Connection.php @@ -1,15 +1,16 @@ buffers is the number of database buffers to allocate for the server-side cache. If 0 or omitted, server chooses its own default. * - resource (resource) => existing connection resource */ -class FirebirdDriver implements Dibi\Driver +class Connection implements Drivers\Connection { public const ErrorExceptionThrown = -836; - /** @deprecated use FirebirdDriver::ErrorExceptionThrown */ + #[\Deprecated('use FirebirdDriver::ErrorExceptionThrown')] public const ERROR_EXCEPTION_THROWN = self::ErrorExceptionThrown; /** @var resource */ @@ -86,7 +87,7 @@ public function disconnect(): void * Executes the SQL query. * @throws Dibi\DriverException|Dibi\Exception */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $resource = $this->inTransaction ? $this->transaction @@ -200,9 +201,9 @@ public function getResource(): mixed /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new FirebirdReflector($this); + return new Drivers\Engines\FirebirdEngine($this); } @@ -210,9 +211,9 @@ public function getReflector(): Dibi\Reflector * Result set driver factory. * @param resource $resource */ - public function createResultDriver($resource): FirebirdResult + public function createResultDriver($resource): Result { - return new FirebirdResult($resource); + return new Result($resource); } @@ -232,56 +233,4 @@ public function escapeBinary(string $value): string { return "'" . str_replace("'", "''", $value) . "'"; } - - - public function escapeIdentifier(string $value): string - { - return '"' . str_replace('"', '""', $value) . '"'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d'"); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return "'" . substr($value->format('Y-m-d H:i:s.u'), 0, -2) . "'"; - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = addcslashes($this->escapeText($value), '%_\\'); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'") . " ESCAPE '\\'"; - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit > 0 || $offset > 0) { - // http://www.firebirdsql.org/refdocs/langrefupd20-select.html - $sql = 'SELECT ' . ($limit > 0 ? 'FIRST ' . $limit : '') . ($offset > 0 ? ' SKIP ' . $offset : '') . ' * FROM (' . $sql . ')'; - } - } } diff --git a/src/Dibi/Drivers/FirebirdResult.php b/src/Dibi/Drivers/Firebird/Result.php similarity index 93% rename from src/Dibi/Drivers/FirebirdResult.php rename to src/Dibi/Drivers/Firebird/Result.php index 5abc8418b..c979973a2 100644 --- a/src/Dibi/Drivers/FirebirdResult.php +++ b/src/Dibi/Drivers/Firebird/Result.php @@ -1,15 +1,16 @@ resultSet, IBASE_TEXT); // intentionally @ if (ibase_errcode()) { - if (ibase_errcode() === FirebirdDriver::ERROR_EXCEPTION_THROWN) { + if (ibase_errcode() === Connection::ERROR_EXCEPTION_THROWN) { preg_match('/exception (\d+) (\w+) (.*)/is', ibase_errmsg(), $match); throw new Dibi\ProcedureException($match[3], $match[1], $match[2]); diff --git a/src/Dibi/Drivers/MySqliDriver.php b/src/Dibi/Drivers/MySQLi/Connection.php similarity index 76% rename from src/Dibi/Drivers/MySqliDriver.php rename to src/Dibi/Drivers/MySQLi/Connection.php index a19f1697b..3908f016a 100644 --- a/src/Dibi/Drivers/MySqliDriver.php +++ b/src/Dibi/Drivers/MySQLi/Connection.php @@ -1,15 +1,16 @@ see http://dev.mysql.com/doc/refman/5.0/en/server-sql-mode.html * - resource (mysqli) => existing connection resource */ -class MySqliDriver implements Dibi\Driver +class Connection implements Drivers\Connection { public const ErrorAccessDenied = 1045; public const ErrorDuplicateEntry = 1062; public const ErrorDataTruncated = 1265; - /** @deprecated use MySqliDriver::ErrorAccessDenied */ + #[\Deprecated('use MySqliDriver::ErrorAccessDenied')] public const ERROR_ACCESS_DENIED = self::ErrorAccessDenied; - /** @deprecated use MySqliDriver::ErrorDuplicateEntry */ + #[\Deprecated('use MySqliDriver::ErrorDuplicateEntry')] public const ERROR_DUPLICATE_ENTRY = self::ErrorDuplicateEntry; - /** @deprecated use MySqliDriver::ErrorDataTruncated */ + #[\Deprecated('use MySqliDriver::ErrorDataTruncated')] public const ERROR_DATA_TRUNCATED = self::ErrorDataTruncated; private \mysqli $connection; @@ -148,7 +149,7 @@ public function ping(): bool * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $res = @$this->connection->query($sql, $this->buffered ? MYSQLI_STORE_RESULT : MYSQLI_USE_RESULT); // intentionally @ @@ -165,13 +166,13 @@ public function query(string $sql): ?Dibi\ResultDriver public static function createException(string $message, int|string $code, string $sql): Dibi\DriverException { - if (in_array($code, [1216, 1217, 1451, 1452, 1701], true)) { + if (in_array($code, [1216, 1217, 1451, 1452, 1701], strict: true)) { return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql); - } elseif (in_array($code, [1062, 1557, 1569, 1586], true)) { + } elseif (in_array($code, [1062, 1557, 1569, 1586], strict: true)) { return new Dibi\UniqueConstraintViolationException($message, $code, $sql); - } elseif (in_array($code, [1048, 1121, 1138, 1171, 1252, 1263, 1566], true)) { + } elseif (in_array($code, [1048, 1121, 1138, 1171, 1252, 1263, 1566], strict: true)) { return new Dibi\NotNullConstraintViolationException($message, $code, $sql); } else { @@ -256,7 +257,7 @@ public function getResource(): ?\mysqli { try { return @$this->connection->thread_id ? $this->connection : null; - } catch (\Throwable $e) { + } catch (\Throwable) { return null; } } @@ -265,18 +266,18 @@ public function getResource(): ?\mysqli /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new MySqlReflector($this); + return new Drivers\Engines\MySQLEngine($this); } /** * Result set driver factory. */ - public function createResultDriver(\mysqli_result $result): MySqliResult + public function createResultDriver(\mysqli_result $result): Result { - return new MySqliResult($result, $this->buffered); + return new Result($result, $this->buffered); } @@ -296,64 +297,4 @@ public function escapeBinary(string $value): string { return "_binary'" . $this->connection->escape_string($value) . "'"; } - - - public function escapeIdentifier(string $value): string - { - return '`' . str_replace('`', '``', $value) . '`'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d'"); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d H:i:s.u'"); - } - - - public function escapeDateInterval(\DateInterval $value): string - { - if ($value->y || $value->m || $value->d) { - throw new Dibi\NotSupportedException('Only time interval is supported.'); - } - - return $value->format("'%r%H:%I:%S.%f'"); - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_"); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - - } elseif ($limit !== null || $offset) { - // see http://dev.mysql.com/doc/refman/5.0/en/select.html - $sql .= ' LIMIT ' . ($limit ?? '18446744073709551615') - . ($offset ? ' OFFSET ' . $offset : ''); - } - } } diff --git a/src/Dibi/Drivers/MySqliResult.php b/src/Dibi/Drivers/MySQLi/Result.php similarity index 92% rename from src/Dibi/Drivers/MySqliResult.php rename to src/Dibi/Drivers/MySQLi/Result.php index 413c1d9fb..3ff354fcd 100644 --- a/src/Dibi/Drivers/MySqliResult.php +++ b/src/Dibi/Drivers/MySQLi/Result.php @@ -1,22 +1,23 @@ $value) { - if (strncmp($key, 'MYSQLI_TYPE_', 12) === 0) { + if (str_starts_with($key, 'MYSQLI_TYPE_')) { $types[$value] = substr($key, 12); } } diff --git a/src/Dibi/Drivers/OracleDriver.php b/src/Dibi/Drivers/OCI8/Connection.php similarity index 69% rename from src/Dibi/Drivers/OracleDriver.php rename to src/Dibi/Drivers/OCI8/Connection.php index 83425a3c8..2af128e89 100644 --- a/src/Dibi/Drivers/OracleDriver.php +++ b/src/Dibi/Drivers/OCI8/Connection.php @@ -1,15 +1,16 @@ existing connection resource * - persistent => Creates persistent connections with oci_pconnect instead of oci_new_connect */ -class OracleDriver implements Dibi\Driver +class Connection implements Drivers\Connection { /** @var resource */ private $connection; @@ -77,7 +78,7 @@ public function disconnect(): void * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $this->affectedRows = null; $res = oci_parse($this->connection, $sql); @@ -104,13 +105,13 @@ public function query(string $sql): ?Dibi\ResultDriver public static function createException(string $message, $code, string $sql): Dibi\DriverException { - if (in_array($code, [1, 2299, 38911], true)) { + if (in_array($code, [1, 2299, 38911], strict: true)) { return new Dibi\UniqueConstraintViolationException($message, $code, $sql); - } elseif (in_array($code, [1400], true)) { + } elseif (in_array($code, [1400], strict: true)) { return new Dibi\NotNullConstraintViolationException($message, $code, $sql); - } elseif (in_array($code, [2266, 2291, 2292], true)) { + } elseif (in_array($code, [2266, 2291, 2292], strict: true)) { return new Dibi\ForeignKeyConstraintViolationException($message, $code, $sql); } else { @@ -190,9 +191,9 @@ public function getResource(): mixed /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new OracleReflector($this); + return new Drivers\Engines\OracleEngine($this); } @@ -200,9 +201,9 @@ public function getReflector(): Dibi\Reflector * Result set driver factory. * @param resource $resource */ - public function createResultDriver($resource): OracleResult + public function createResultDriver($resource): Result { - return new OracleResult($resource); + return new Result($resource); } @@ -222,70 +223,4 @@ public function escapeBinary(string $value): string { return "'" . str_replace("'", "''", $value) . "'"; // TODO: not tested } - - - public function escapeIdentifier(string $value): string - { - // @see http://download.oracle.com/docs/cd/B10500_01/server.920/a96540/sql_elements9a.htm - return '"' . str_replace('"', '""', $value) . '"'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $this->nativeDate - ? "to_date('" . $value->format('Y-m-d') . "', 'YYYY-mm-dd')" - : $value->format('U'); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return $this->nativeDate - ? "to_date('" . $value->format('Y-m-d G:i:s') . "', 'YYYY-mm-dd hh24:mi:ss')" - : $value->format('U'); - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\\%_"); - $value = str_replace("'", "''", $value); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - - } elseif ($offset) { - // see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html - $sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t ' - . ($limit !== null ? 'WHERE ROWNUM <= ' . ($offset + $limit) : '') - . ') WHERE "__rnum" > ' . $offset; - - } elseif ($limit !== null) { - $sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . $limit; - } - } } diff --git a/src/Dibi/Drivers/OracleResult.php b/src/Dibi/Drivers/OCI8/Result.php similarity index 94% rename from src/Dibi/Drivers/OracleResult.php rename to src/Dibi/Drivers/OCI8/Result.php index 5cf4be193..e9c5c5844 100644 --- a/src/Dibi/Drivers/OracleResult.php +++ b/src/Dibi/Drivers/OCI8/Result.php @@ -1,22 +1,23 @@ existing connection resource * - microseconds (bool) => use microseconds in datetime format? */ -class OdbcDriver implements Dibi\Driver +class Connection implements Drivers\Connection { /** @var resource */ private $connection; @@ -77,7 +78,7 @@ public function disconnect(): void * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $this->affectedRows = null; $res = @odbc_exec($this->connection, $sql); // intentionally @ @@ -176,9 +177,9 @@ public function getResource(): mixed /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new OdbcReflector($this); + return new Drivers\Engines\ODBCEngine($this); } @@ -186,9 +187,9 @@ public function getReflector(): Dibi\Reflector * Result set driver factory. * @param resource $resource */ - public function createResultDriver($resource): OdbcResult + public function createResultDriver($resource): Result { - return new OdbcResult($resource); + return new Result($resource); } @@ -208,61 +209,4 @@ public function escapeBinary(string $value): string { return "'" . str_replace("'", "''", $value) . "'"; } - - - public function escapeIdentifier(string $value): string - { - return '[' . str_replace(['[', ']'], ['[[', ']]'], $value) . ']'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format('#m/d/Y#'); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return $value->format($this->microseconds ? '#m/d/Y H:i:s.u#' : '#m/d/Y H:i:s#'); - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($offset) { - throw new Dibi\NotSupportedException('Offset is not supported by this database.'); - - } elseif ($limit < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - - } elseif ($limit !== null) { - $sql = 'SELECT TOP ' . $limit . ' * FROM (' . $sql . ') t'; - } - } } diff --git a/src/Dibi/Drivers/OdbcResult.php b/src/Dibi/Drivers/ODBC/Result.php similarity index 95% rename from src/Dibi/Drivers/OdbcResult.php rename to src/Dibi/Drivers/ODBC/Result.php index 42947a8fc..5ae5aad97 100644 --- a/src/Dibi/Drivers/OdbcResult.php +++ b/src/Dibi/Drivers/ODBC/Result.php @@ -1,22 +1,23 @@ driver->query('SELECT * FROM cat'); - $tables = []; - while ($row = $res->fetch(false)) { - if ($row[1] === 'TABLE' || $row[1] === 'VIEW') { - $tables[] = [ - 'name' => $row[0], - 'view' => $row[1] === 'VIEW', - ]; - } - } - - return $tables; - } - - - /** - * Returns metadata for all columns in a table. - */ - public function getColumns(string $table): array - { - $res = $this->driver->query('SELECT * FROM "ALL_TAB_COLUMNS" WHERE "TABLE_NAME" = ' . $this->driver->escapeText($table)); - $columns = []; - while ($row = $res->fetch(true)) { - $columns[] = [ - 'table' => $row['TABLE_NAME'], - 'name' => $row['COLUMN_NAME'], - 'nativetype' => $row['DATA_TYPE'], - 'size' => $row['DATA_LENGTH'] ?? null, - 'nullable' => $row['NULLABLE'] === 'Y', - 'default' => $row['DATA_DEFAULT'], - 'vendor' => $row, - ]; - } - - return $columns; - } - - - /** - * Returns metadata for all indexes in a table. - */ - public function getIndexes(string $table): array - { - throw new Dibi\NotImplementedException; - } - - - /** - * Returns metadata for all foreign keys in a table. - */ - public function getForeignKeys(string $table): array - { - throw new Dibi\NotImplementedException; - } -} diff --git a/src/Dibi/Drivers/PDO/Connection.php b/src/Dibi/Drivers/PDO/Connection.php new file mode 100644 index 000000000..7e56a9d7f --- /dev/null +++ b/src/Dibi/Drivers/PDO/Connection.php @@ -0,0 +1,223 @@ + driver specific DSN + * - username (or user) + * - password (or pass) + * - options (array) => driver specific options {@see PDO::__construct} + * - resource (PDO) => existing connection + */ +class Connection implements Drivers\Connection +{ + private ?PDO $connection; + private ?int $affectedRows; + private string $driverName; + + + /** @throws Dibi\NotSupportedException */ + public function __construct(array $config) + { + if (!extension_loaded('pdo')) { + throw new Dibi\NotSupportedException("PHP extension 'pdo' is not loaded."); + } + + $foo = &$config['dsn']; + $foo = &$config['options']; + Helpers::alias($config, 'resource', 'pdo'); + + if ($config['resource'] instanceof PDO) { + $this->connection = $config['resource']; + unset($config['resource'], $config['pdo']); + + if ($this->connection->getAttribute(PDO::ATTR_ERRMODE) !== PDO::ERRMODE_SILENT) { + throw new Dibi\DriverException('PDO connection in exception or warning error mode is not supported.'); + } + } else { + try { + $this->connection = new PDO($config['dsn'], $config['username'], $config['password'], $config['options']); + $this->connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT); + } catch (\PDOException $e) { + if ($e->getMessage() === 'could not find driver') { + throw new Dibi\NotSupportedException('PHP extension for PDO is not loaded.'); + } + + throw new Dibi\DriverException($e->getMessage(), $e->getCode()); + } + } + + $this->driverName = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME); + } + + + /** + * Disconnects from a database. + */ + public function disconnect(): void + { + $this->connection = null; + } + + + /** + * Executes the SQL query. + * @throws Dibi\DriverException + */ + public function query(string $sql): ?Result + { + $res = $this->connection->query($sql); + if ($res) { + $this->affectedRows = $res->rowCount(); + return $res->columnCount() ? $this->createResultDriver($res) : null; + } + + $this->affectedRows = null; + + [$sqlState, $code, $message] = $this->connection->errorInfo(); + $code ??= 0; + $message = "SQLSTATE[$sqlState]: $message"; + throw match ($this->driverName) { + 'mysql' => Drivers\MySQLi\Connection::createException($message, $code, $sql), + 'oci' => Drivers\OCI8\Connection::createException($message, $code, $sql), + 'pgsql' => Drivers\PgSQL\Connection::createException($message, $sqlState, $sql), + 'sqlite' => Drivers\SQLite3\Connection::createException($message, $code, $sql), + default => new Dibi\DriverException($message, $code, $sql), + }; + } + + + /** + * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query. + */ + public function getAffectedRows(): ?int + { + return $this->affectedRows; + } + + + /** + * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query. + */ + public function getInsertId(?string $sequence): ?int + { + return Helpers::intVal($this->connection->lastInsertId($sequence)); + } + + + /** + * Begins a transaction (if supported). + * @throws Dibi\DriverException + */ + public function begin(?string $savepoint = null): void + { + if (!$this->connection->beginTransaction()) { + $err = $this->connection->errorInfo(); + throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); + } + } + + + /** + * Commits statements in a transaction. + * @throws Dibi\DriverException + */ + public function commit(?string $savepoint = null): void + { + if (!$this->connection->commit()) { + $err = $this->connection->errorInfo(); + throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); + } + } + + + /** + * Rollback changes in a transaction. + * @throws Dibi\DriverException + */ + public function rollback(?string $savepoint = null): void + { + if (!$this->connection->rollBack()) { + $err = $this->connection->errorInfo(); + throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); + } + } + + + /** + * Returns the connection resource. + */ + public function getResource(): ?PDO + { + return $this->connection; + } + + + /** + * Returns the connection reflector. + */ + public function getReflector(): Drivers\Engine + { + return match ($this->driverName) { + 'mysql' => new Engines\MySQLEngine($this), + 'oci' => new Engines\OracleEngine($this), + 'pgsql' => new Engines\PostgreSQLEngine($this), + 'sqlite' => new Engines\SQLiteEngine($this), + 'mssql', 'dblib', 'sqlsrv' => new Engines\SQLServerEngine($this), + default => throw new Dibi\NotSupportedException, + }; + } + + + /** + * Result set driver factory. + */ + public function createResultDriver(\PDOStatement $result): Result + { + return new Result($result, $this->driverName); + } + + + /********************* SQL ****************d*g**/ + + + /** + * Encodes data for use in a SQL statement. + */ + public function escapeText(string $value): string + { + return match ($this->driverName) { + 'odbc' => "'" . str_replace("'", "''", $value) . "'", + 'sqlsrv' => "N'" . str_replace("'", "''", $value) . "'", + default => $this->connection->quote($value, PDO::PARAM_STR), + }; + } + + + public function escapeBinary(string $value): string + { + return match ($this->driverName) { + 'odbc' => "'" . str_replace("'", "''", $value) . "'", + 'sqlsrv' => '0x' . bin2hex($value), + default => $this->connection->quote($value, PDO::PARAM_LOB), + }; + } +} diff --git a/src/Dibi/Drivers/PdoResult.php b/src/Dibi/Drivers/PDO/Result.php similarity index 95% rename from src/Dibi/Drivers/PdoResult.php rename to src/Dibi/Drivers/PDO/Result.php index bfb0f602c..9365c4c4d 100644 --- a/src/Dibi/Drivers/PdoResult.php +++ b/src/Dibi/Drivers/PDO/Result.php @@ -1,15 +1,16 @@ driver specific DSN - * - username (or user) - * - password (or pass) - * - options (array) => driver specific options {@see PDO::__construct} - * - resource (PDO) => existing connection - */ -class PdoDriver implements Dibi\Driver -{ - private ?PDO $connection; - private ?int $affectedRows; - private string $driverName; - - - /** @throws Dibi\NotSupportedException */ - public function __construct(array $config) - { - if (!extension_loaded('pdo')) { - throw new Dibi\NotSupportedException("PHP extension 'pdo' is not loaded."); - } - - $foo = &$config['dsn']; - $foo = &$config['options']; - Helpers::alias($config, 'resource', 'pdo'); - - if ($config['resource'] instanceof PDO) { - $this->connection = $config['resource']; - unset($config['resource'], $config['pdo']); - - if ($this->connection->getAttribute(PDO::ATTR_ERRMODE) !== PDO::ERRMODE_SILENT) { - throw new Dibi\DriverException('PDO connection in exception or warning error mode is not supported.'); - } - } else { - try { - $this->connection = new PDO($config['dsn'], $config['username'], $config['password'], $config['options']); - $this->connection->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_SILENT); - } catch (\PDOException $e) { - if ($e->getMessage() === 'could not find driver') { - throw new Dibi\NotSupportedException('PHP extension for PDO is not loaded.'); - } - - throw new Dibi\DriverException($e->getMessage(), $e->getCode()); - } - } - - $this->driverName = $this->connection->getAttribute(PDO::ATTR_DRIVER_NAME); - } - - - /** - * Disconnects from a database. - */ - public function disconnect(): void - { - $this->connection = null; - } - - - /** - * Executes the SQL query. - * @throws Dibi\DriverException - */ - public function query(string $sql): ?Dibi\ResultDriver - { - $res = $this->connection->query($sql); - if ($res) { - $this->affectedRows = $res->rowCount(); - return $res->columnCount() ? $this->createResultDriver($res) : null; - } - - $this->affectedRows = null; - - [$sqlState, $code, $message] = $this->connection->errorInfo(); - $code ??= 0; - $message = "SQLSTATE[$sqlState]: $message"; - throw match ($this->driverName) { - 'mysql' => MySqliDriver::createException($message, $code, $sql), - 'oci' => OracleDriver::createException($message, $code, $sql), - 'pgsql' => PostgreDriver::createException($message, $sqlState, $sql), - 'sqlite' => SqliteDriver::createException($message, $code, $sql), - default => new Dibi\DriverException($message, $code, $sql), - }; - } - - - /** - * Gets the number of affected rows by the last INSERT, UPDATE or DELETE query. - */ - public function getAffectedRows(): ?int - { - return $this->affectedRows; - } - - - /** - * Retrieves the ID generated for an AUTO_INCREMENT column by the previous INSERT query. - */ - public function getInsertId(?string $sequence): ?int - { - return Helpers::intVal($this->connection->lastInsertId($sequence)); - } - - - /** - * Begins a transaction (if supported). - * @throws Dibi\DriverException - */ - public function begin(?string $savepoint = null): void - { - if (!$this->connection->beginTransaction()) { - $err = $this->connection->errorInfo(); - throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); - } - } - - - /** - * Commits statements in a transaction. - * @throws Dibi\DriverException - */ - public function commit(?string $savepoint = null): void - { - if (!$this->connection->commit()) { - $err = $this->connection->errorInfo(); - throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); - } - } - - - /** - * Rollback changes in a transaction. - * @throws Dibi\DriverException - */ - public function rollback(?string $savepoint = null): void - { - if (!$this->connection->rollBack()) { - $err = $this->connection->errorInfo(); - throw new Dibi\DriverException("SQLSTATE[$err[0]]: $err[2]", $err[1] ?? 0); - } - } - - - /** - * Returns the connection resource. - */ - public function getResource(): ?PDO - { - return $this->connection; - } - - - /** - * Returns the connection reflector. - */ - public function getReflector(): Dibi\Reflector - { - return match ($this->driverName) { - 'mysql' => new MySqlReflector($this), - 'oci' => new OracleReflector($this), - 'pgsql' => new PostgreReflector($this), - 'sqlite' => new SqliteReflector($this), - 'mssql', 'dblib', 'sqlsrv' => new SqlsrvReflector($this), - default => throw new Dibi\NotSupportedException, - }; - } - - - /** - * Result set driver factory. - */ - public function createResultDriver(\PDOStatement $result): PdoResult - { - return new PdoResult($result, $this->driverName); - } - - - /********************* SQL ****************d*g**/ - - - /** - * Encodes data for use in a SQL statement. - */ - public function escapeText(string $value): string - { - return match ($this->driverName) { - 'odbc' => "'" . str_replace("'", "''", $value) . "'", - 'sqlsrv' => "N'" . str_replace("'", "''", $value) . "'", - default => $this->connection->quote($value, PDO::PARAM_STR), - }; - } - - - public function escapeBinary(string $value): string - { - return match ($this->driverName) { - 'odbc' => "'" . str_replace("'", "''", $value) . "'", - 'sqlsrv' => '0x' . bin2hex($value), - default => $this->connection->quote($value, PDO::PARAM_LOB), - }; - } - - - public function escapeIdentifier(string $value): string - { - return match ($this->driverName) { - 'mysql' => '`' . str_replace('`', '``', $value) . '`', - 'oci', 'pgsql' => '"' . str_replace('"', '""', $value) . '"', - 'sqlite' => '[' . strtr($value, '[]', ' ') . ']', - 'odbc', 'mssql' => '[' . str_replace(['[', ']'], ['[[', ']]'], $value) . ']', - 'dblib', 'sqlsrv' => '[' . str_replace(']', ']]', $value) . ']', - default => $value, - }; - } - - - public function escapeBool(bool $value): string - { - if ($this->driverName === 'pgsql') { - return $value ? 'TRUE' : 'FALSE'; - } else { - return $value ? '1' : '0'; - } - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format($this->driverName === 'odbc' ? '#m/d/Y#' : "'Y-m-d'"); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return match ($this->driverName) { - 'odbc' => $value->format('#m/d/Y H:i:s.u#'), - 'mssql', 'dblib', 'sqlsrv' => 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')', - default => $value->format("'Y-m-d H:i:s.u'"), - }; - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - switch ($this->driverName) { - case 'mysql': - $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\n\r\\'%_"); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - - case 'oci': - $value = addcslashes(str_replace('\\', '\\\\', $value), "\x00\\%_"); - $value = str_replace("'", "''", $value); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - - case 'pgsql': - $bs = substr($this->connection->quote('\\', PDO::PARAM_STR), 1, -1); // standard_conforming_strings = on/off - $value = substr($this->connection->quote($value, PDO::PARAM_STR), 1, -1); - $value = strtr($value, ['%' => $bs . '%', '_' => $bs . '_', '\\' => '\\\\']); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - - case 'sqlite': - $value = addcslashes(substr($this->connection->quote($value, PDO::PARAM_STR), 1, -1), '%_\\'); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'") . " ESCAPE '\\'"; - - case 'odbc': - case 'mssql': - case 'dblib': - case 'sqlsrv': - $value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - - default: - throw new Dibi\NotImplementedException; - } - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - } - - switch ($this->driverName) { - case 'mysql': - if ($limit !== null || $offset) { - // see http://dev.mysql.com/doc/refman/5.0/en/select.html - $sql .= ' LIMIT ' . ($limit ?? '18446744073709551615') - . ($offset ? ' OFFSET ' . $offset : ''); - } - - break; - - case 'pgsql': - if ($limit !== null) { - $sql .= ' LIMIT ' . $limit; - } - - if ($offset) { - $sql .= ' OFFSET ' . $offset; - } - - break; - - case 'sqlite': - if ($limit !== null || $offset) { - $sql .= ' LIMIT ' . ($limit ?? '-1') - . ($offset ? ' OFFSET ' . $offset : ''); - } - - break; - - case 'oci': - if ($offset) { - // see http://www.oracle.com/technology/oramag/oracle/06-sep/o56asktom.html - $sql = 'SELECT * FROM (SELECT t.*, ROWNUM AS "__rnum" FROM (' . $sql . ') t ' - . ($limit !== null ? 'WHERE ROWNUM <= ' . ($offset + $limit) : '') - . ') WHERE "__rnum" > ' . $offset; - - } elseif ($limit !== null) { - $sql = 'SELECT * FROM (' . $sql . ') WHERE ROWNUM <= ' . $limit; - } - - break; - - case 'mssql': - case 'sqlsrv': - case 'dblib': - // requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx - if ($limit !== null) { - $sql = sprintf('%s OFFSET %d ROWS FETCH NEXT %d ROWS ONLY', rtrim($sql), $offset, $limit); - } elseif ($offset) { - $sql = sprintf('%s OFFSET %d ROWS', rtrim($sql), $offset); - } - - break; - - case 'odbc': - if ($offset) { - throw new Dibi\NotSupportedException('Offset is not supported by this database.'); - - } elseif ($limit !== null) { - $sql = 'SELECT TOP ' . $limit . ' * FROM (' . $sql . ') t'; - break; - } - // break omitted - default: - throw new Dibi\NotSupportedException('PDO or driver does not support applying limit or offset.'); - } - } -} diff --git a/src/Dibi/Drivers/PostgreDriver.php b/src/Dibi/Drivers/PgSQL/Connection.php similarity index 76% rename from src/Dibi/Drivers/PostgreDriver.php rename to src/Dibi/Drivers/PgSQL/Connection.php index 880762d31..bbe2fee7f 100644 --- a/src/Dibi/Drivers/PostgreDriver.php +++ b/src/Dibi/Drivers/PgSQL/Connection.php @@ -1,15 +1,16 @@ existing connection resource * - connect_type (int) => see pg_connect() */ -class PostgreDriver implements Dibi\Driver +class Connection implements Drivers\Connection { private PgSql\Connection $connection; private ?int $affectedRows; @@ -110,7 +111,7 @@ public function ping(): bool * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $this->affectedRows = null; $res = @pg_query($this->connection, $sql); // intentionally @ @@ -131,8 +132,8 @@ public function query(string $sql): ?Dibi\ResultDriver public static function createException(string $message, $code = null, ?string $sql = null): Dibi\DriverException { - if ($code === null && preg_match('#^ERROR:\s+(\S+):\s*#', $message, $m)) { - $code = $m[1]; + if ($code === null && preg_match('#^(ERROR|FATAL):\s+(\S+):\s*#', $message, $m)) { + $code = $m[2]; $message = substr($message, strlen($m[0])); } @@ -216,7 +217,7 @@ public function rollback(?string $savepoint = null): void */ public function inTransaction(): bool { - return !in_array(pg_transaction_status($this->connection), [PGSQL_TRANSACTION_UNKNOWN, PGSQL_TRANSACTION_IDLE], true); + return !in_array(pg_transaction_status($this->connection), [PGSQL_TRANSACTION_UNKNOWN, PGSQL_TRANSACTION_IDLE], strict: true); } @@ -232,18 +233,18 @@ public function getResource(): PgSql\Connection /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new PostgreReflector($this); + return new Drivers\Engines\PostgreSQLEngine($this); } /** * Result set driver factory. */ - public function createResultDriver(PgSql\Result $resource): PostgreResult + public function createResultDriver(PgSql\Result $resource): Result { - return new PostgreResult($resource); + return new Result($resource); } @@ -271,66 +272,4 @@ public function escapeBinary(string $value): string return "'" . pg_escape_bytea($this->connection, $value) . "'"; } - - - public function escapeIdentifier(string $value): string - { - // @see http://www.postgresql.org/docs/8.2/static/sql-syntax-lexical.html#SQL-SYNTAX-IDENTIFIERS - return '"' . str_replace('"', '""', $value) . '"'; - } - - - public function escapeBool(bool $value): string - { - return $value ? 'TRUE' : 'FALSE'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d'"); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d H:i:s.u'"); - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $bs = pg_escape_string($this->connection, '\\'); // standard_conforming_strings = on/off - $value = pg_escape_string($this->connection, $value); - $value = strtr($value, ['%' => $bs . '%', '_' => $bs . '_', '\\' => '\\\\']); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - } - - if ($limit !== null) { - $sql .= ' LIMIT ' . $limit; - } - - if ($offset) { - $sql .= ' OFFSET ' . $offset; - } - } } diff --git a/src/Dibi/Drivers/PostgreResult.php b/src/Dibi/Drivers/PgSQL/Result.php similarity index 94% rename from src/Dibi/Drivers/PostgreResult.php rename to src/Dibi/Drivers/PgSQL/Result.php index e74f36ca3..92553fe72 100644 --- a/src/Dibi/Drivers/PostgreResult.php +++ b/src/Dibi/Drivers/PgSQL/Result.php @@ -1,15 +1,15 @@ character encoding to set (default is UTF-8) * - resource (resource) => existing connection resource */ -class SqlsrvDriver implements Dibi\Driver +class Connection implements Drivers\Connection { /** @var resource */ private $connection; @@ -84,7 +85,7 @@ public function disconnect(): void * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $this->affectedRows = null; $res = sqlsrv_query($this->connection, $sql); @@ -171,9 +172,9 @@ public function getResource(): mixed /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new SqlsrvReflector($this); + return new Drivers\Engines\SQLServerEngine($this); } @@ -181,9 +182,9 @@ public function getReflector(): Dibi\Reflector * Result set driver factory. * @param resource $resource */ - public function createResultDriver($resource): SqlsrvResult + public function createResultDriver($resource): Result { - return new SqlsrvResult($resource); + return new Result($resource); } @@ -203,63 +204,4 @@ public function escapeBinary(string $value): string { return '0x' . bin2hex($value); } - - - public function escapeIdentifier(string $value): string - { - // @see https://msdn.microsoft.com/en-us/library/ms176027.aspx - return '[' . str_replace(']', ']]', $value) . ']'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format("'Y-m-d'"); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return 'CONVERT(DATETIME2(7), ' . $value->format("'Y-m-d H:i:s.u'") . ')'; - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = strtr($value, ["'" => "''", '%' => '[%]', '_' => '[_]', '[' => '[[]']); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'"); - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - - } elseif ($limit !== null) { - // requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx - $sql = sprintf('%s OFFSET %d ROWS FETCH NEXT %d ROWS ONLY', rtrim($sql), $offset, $limit); - } elseif ($offset) { - // requires ORDER BY, see https://technet.microsoft.com/en-us/library/gg699618(v=sql.110).aspx - $sql = sprintf('%s OFFSET %d ROWS', rtrim($sql), $offset); - } - } } diff --git a/src/Dibi/Drivers/SqlsrvResult.php b/src/Dibi/Drivers/SQLSrv/Result.php similarity index 94% rename from src/Dibi/Drivers/SqlsrvResult.php rename to src/Dibi/Drivers/SQLSrv/Result.php index f2e79356b..c9e91b88b 100644 --- a/src/Dibi/Drivers/SqlsrvResult.php +++ b/src/Dibi/Drivers/SQLSrv/Result.php @@ -1,22 +1,23 @@ how to format datetime in SQL (@see date) * - resource (SQLite3) => existing connection resource */ -class SqliteDriver implements Dibi\Driver +class Connection implements Drivers\Connection { private SQLite3 $connection; private string $fmtDate; @@ -73,7 +74,7 @@ public function disconnect(): void * Executes the SQL query. * @throws Dibi\DriverException */ - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { $res = @$this->connection->query($sql); // intentionally @ if ($code = $this->connection->lastErrorCode()) { @@ -174,18 +175,18 @@ public function getResource(): ?SQLite3 /** * Returns the connection reflector. */ - public function getReflector(): Dibi\Reflector + public function getReflector(): Drivers\Engine { - return new SqliteReflector($this); + return new Drivers\Engines\SQLiteEngine($this); } /** * Result set driver factory. */ - public function createResultDriver(\SQLite3Result $result): SqliteResult + public function createResultDriver(\SQLite3Result $result): Result { - return new SqliteResult($result); + return new Result($result); } @@ -207,61 +208,6 @@ public function escapeBinary(string $value): string } - public function escapeIdentifier(string $value): string - { - return '[' . strtr($value, '[]', ' ') . ']'; - } - - - public function escapeBool(bool $value): string - { - return $value ? '1' : '0'; - } - - - public function escapeDate(\DateTimeInterface $value): string - { - return $value->format($this->fmtDate); - } - - - public function escapeDateTime(\DateTimeInterface $value): string - { - return $value->format($this->fmtDateTime); - } - - - public function escapeDateInterval(\DateInterval $value): string - { - throw new Dibi\NotImplementedException; - } - - - /** - * Encodes string for use in a LIKE statement. - */ - public function escapeLike(string $value, int $pos): string - { - $value = addcslashes($this->connection->escapeString($value), '%_\\'); - return ($pos & 1 ? "'%" : "'") . $value . ($pos & 2 ? "%'" : "'") . " ESCAPE '\\'"; - } - - - /** - * Injects LIMIT/OFFSET to the SQL query. - */ - public function applyLimit(string &$sql, ?int $limit, ?int $offset): void - { - if ($limit < 0 || $offset < 0) { - throw new Dibi\NotSupportedException('Negative offset or limit.'); - - } elseif ($limit !== null || $offset) { - $sql .= ' LIMIT ' . ($limit ?? '-1') - . ($offset ? ' OFFSET ' . $offset : ''); - } - } - - /********************* user defined functions ****************d*g**/ diff --git a/src/Dibi/Drivers/SqliteResult.php b/src/Dibi/Drivers/SQLite3/Result.php similarity index 95% rename from src/Dibi/Drivers/SqliteResult.php rename to src/Dibi/Drivers/SQLite3/Result.php index 0758cfe9c..cf89a9db2 100644 --- a/src/Dibi/Drivers/SqliteResult.php +++ b/src/Dibi/Drivers/SQLite3/Result.php @@ -1,15 +1,16 @@ connection = $connection; $this->type = $type; $this->sql = trim((string) $sql); - $this->time = -microtime(true); + $this->time = -microtime(as_float: true); if ($type === self::QUERY && preg_match('#\(?\s*(SELECT|UPDATE|INSERT|DELETE)#iA', $this->sql, $matches)) { $types = [ @@ -79,11 +79,11 @@ public function done(Result|DriverException|null $result = null): static $this->result = $result; try { $this->count = $result instanceof Result ? count($result) : null; - } catch (Exception $e) { + } catch (Exception) { $this->count = null; } - $this->time += microtime(true); + $this->time += microtime(as_float: true); \dibi::$elapsedTime = $this->time; \dibi::$totalTime += $this->time; return $this; diff --git a/src/Dibi/Expression.php b/src/Dibi/Expression.php index c3f174908..716d33694 100644 --- a/src/Dibi/Expression.php +++ b/src/Dibi/Expression.php @@ -1,7 +1,7 @@ 'FROM', 'RIGHT JOIN' => 'FROM', ]; - - private readonly Connection $connection; private array $setups = []; private ?string $command = null; private array $clauses = []; @@ -110,10 +108,9 @@ class Fluent implements IDataSource private static HashMap $normalizer; - public function __construct(Connection $connection) - { - $this->connection = $connection; - + public function __construct( + private readonly Connection $connection, + ) { if (!isset(self::$normalizer)) { self::$normalizer = new HashMap(self::_formatClause(...)); } @@ -378,7 +375,7 @@ public function count(): int } - private function query($args): Result + private function query(array $args): Result { $res = $this->connection->query($args); foreach ($this->setups as $setup) { diff --git a/src/Dibi/HashMap.php b/src/Dibi/HashMap.php index 54f0f7f83..1ef959a1d 100644 --- a/src/Dibi/HashMap.php +++ b/src/Dibi/HashMap.php @@ -1,7 +1,7 @@ 0 && $len < $min) { $min = $len; @@ -159,7 +159,7 @@ public static function getSuggestion(array $items, string $value): ?string /** @internal */ - public static function escape(Driver $driver, $value, string $type): string + public static function escape(Drivers\Connection $driver, $value, string $type): string { $types = [ Type::Text => 'text', diff --git a/src/Dibi/IDataSource.php b/src/Dibi/IDataSource.php new file mode 100644 index 000000000..9b41dc875 --- /dev/null +++ b/src/Dibi/IDataSource.php @@ -0,0 +1,20 @@ +columns)) { $this->columns = []; - $reflector = $this->driver instanceof Dibi\Reflector + $reflector = $this->driver instanceof Dibi\Drivers\Engine ? $this->driver : null; foreach ($this->driver->getResultColumns() as $info) { diff --git a/src/Dibi/Reflection/Table.php b/src/Dibi/Reflection/Table.php index d4cbe0d4d..5e1829fc6 100644 --- a/src/Dibi/Reflection/Table.php +++ b/src/Dibi/Reflection/Table.php @@ -1,7 +1,7 @@ reflector = $reflector; $this->name = $info['name']; diff --git a/src/Dibi/Result.php b/src/Dibi/Result.php index 77de8b1be..b168147eb 100644 --- a/src/Dibi/Result.php +++ b/src/Dibi/Result.php @@ -1,7 +1,7 @@ driver = $driver; if ($normalize) { @@ -62,7 +62,7 @@ final public function free(): void * Safe access to property $driver. * @throws \RuntimeException */ - final public function getResultDriver(): ResultDriver + final public function getResultDriver(): Drivers\Result { if ($this->driver === null) { throw new \RuntimeException('Result-set was released from memory.'); @@ -202,7 +202,7 @@ final public function fetchSingle(): mixed final public function fetchAll(?int $offset = null, ?int $limit = null): array { $limit ??= -1; - $this->seek($offset ?: 0); + $this->seek($offset ?? 0); $row = $this->fetch(); if (!$row) { return []; // empty result set @@ -439,7 +439,7 @@ private function detectTypes(): void foreach ($this->getResultDriver()->getResultColumns() as $col) { $this->types[$col['name']] = $col['type'] ?? $cache->{$col['nativetype']}; } - } catch (NotSupportedException $e) { + } catch (NotSupportedException) { } } diff --git a/src/Dibi/ResultIterator.php b/src/Dibi/ResultIterator.php index 6bac6b570..1f773ec03 100644 --- a/src/Dibi/ResultIterator.php +++ b/src/Dibi/ResultIterator.php @@ -1,7 +1,7 @@ toArray()); } diff --git a/src/Dibi/Translator.php b/src/Dibi/Translator.php index cb9a80dbb..94270efeb 100644 --- a/src/Dibi/Translator.php +++ b/src/Dibi/Translator.php @@ -1,7 +1,7 @@ connection = $connection; $this->driver = $connection->getDriver(); + $this->engine = $connection->getDatabaseEngine(); $this->identifiers = new HashMap($this->delimite(...)); } @@ -144,7 +146,7 @@ public function translate(array $args): string // apply limit if ($this->limit !== null || $this->offset !== null) { - $this->driver->applyLimit($sql, $this->limit, $this->offset); + $this->engine->applyLimit($sql, $this->limit, $this->offset); } return $sql; @@ -209,7 +211,7 @@ public function formatValue(mixed $value, ?string $modifier): string case 'n': // key, key, ... identifier names foreach ($value as $k => $v) { if (is_string($k)) { - $vx[] = $this->identifiers->$k . (empty($v) ? '' : ' AS ' . $this->driver->escapeIdentifier($v)); + $vx[] = $this->identifiers->$k . (empty($v) ? '' : ' AS ' . $this->engine->escapeIdentifier($v)); } else { $pair = explode('%', $v, 2); // split into identifier & modifier $vx[] = $this->identifiers->{$pair[0]}; @@ -290,7 +292,7 @@ public function formatValue(mixed $value, ?string $modifier): string return implode(', ', $vx); case 'ex!': - trigger_error('Use Dibi\Expression instead of array: ' . implode(', ', array_filter($value, 'is_scalar')), E_USER_WARNING); + trigger_error('Use Dibi\Expression instead of array: ' . implode(', ', array_filter($value, is_scalar(...))), E_USER_WARNING); // break omitted case 'ex': case 'sql': @@ -346,7 +348,7 @@ public function formatValue(mixed $value, ?string $modifier): string case 's': // string return $value === null ? 'NULL' - : $this->driver->escapeText((string) $value); + : $this->engine->escapeText((string) $value); case 'bin':// binary return $value === null @@ -356,7 +358,7 @@ public function formatValue(mixed $value, ?string $modifier): string case 'b': // boolean return $value === null ? 'NULL' - : $this->driver->escapeBool((bool) $value); + : $this->engine->escapeBool((bool) $value); case 'sN': // string or null case 'sn': @@ -406,15 +408,15 @@ public function formatValue(mixed $value, ?string $modifier): string } return $modifier === 'd' - ? $this->driver->escapeDate($value) - : $this->driver->escapeDateTime($value); + ? $this->engine->escapeDate($value) + : $this->engine->escapeDateTime($value); case 'by': case 'n': // composed identifier name return $this->identifiers->$value; case 'N': // identifier name - return $this->driver->escapeIdentifier($value); + return $this->engine->escapeIdentifier($value); case 'ex': case 'sql': // preserve as dibi-SQL (TODO: leave only %ex) @@ -450,16 +452,16 @@ public function formatValue(mixed $value, ?string $modifier): string return (string) $value; case 'like~': // LIKE string% - return $this->driver->escapeLike($value, 2); + return $this->engine->escapeLike($value, 2); case '~like': // LIKE %string - return $this->driver->escapeLike($value, 1); + return $this->engine->escapeLike($value, 1); case '~like~': // LIKE %string% - return $this->driver->escapeLike($value, 3); + return $this->engine->escapeLike($value, 3); case 'like': // LIKE string - return $this->driver->escapeLike($value, 0); + return $this->engine->escapeLike($value, 0); case 'and': case 'or': @@ -485,16 +487,16 @@ public function formatValue(mixed $value, ?string $modifier): string return rtrim(rtrim(number_format($value, 10, '.', ''), '0'), '.'); } elseif (is_bool($value)) { - return $this->driver->escapeBool($value); + return $this->engine->escapeBool($value); } elseif ($value === null) { return 'NULL'; } elseif ($value instanceof \DateTimeInterface) { - return $this->driver->escapeDateTime($value); + return $this->engine->escapeDateTime($value); } elseif ($value instanceof \DateInterval) { - return $this->driver->escapeDateInterval($value); + return $this->engine->escapeDateInterval($value); } elseif ($value instanceof Literal) { return (string) $value; @@ -653,7 +655,7 @@ public function delimite(string $value): string $parts = explode('.', $value); foreach ($parts as &$v) { if ($v !== '*') { - $v = $this->driver->escapeIdentifier($v); + $v = $this->engine->escapeIdentifier($v); } } diff --git a/src/Dibi/Type.php b/src/Dibi/Type.php index 21693dd9d..d98f2d784 100644 --- a/src/Dibi/Type.php +++ b/src/Dibi/Type.php @@ -1,7 +1,7 @@ code = $code; - $this->sql = $sql; } @@ -84,16 +80,16 @@ class NotSupportedException extends Exception */ class ProcedureException extends Exception { - protected string $severity; - - /** * Construct the exception. */ - public function __construct(string $message = '', int $code = 0, string $severity = '', ?string $sql = null) - { + public function __construct( + string $message = '', + int $code = 0, + protected string $severity = '', + ?string $sql = null, + ) { parent::__construct($message, $code, $sql); - $this->severity = $severity; } diff --git a/src/Dibi/interfaces.php b/src/Dibi/interfaces.php deleted file mode 100644 index 3cf336854..000000000 --- a/src/Dibi/interfaces.php +++ /dev/null @@ -1,240 +0,0 @@ -getConfig('lazy')); Assert::same($config['driver'], $conn->getConfig('driver')); - Assert::type(Dibi\Driver::class, $conn->getDriver()); + Assert::type(Dibi\Drivers\Connection::class, $conn->getDriver()); }); diff --git a/tests/dibi/Connection.objectTranslator.phpt b/tests/dibi/Connection.objectTranslator.phpt index 32938af26..58e3be453 100644 --- a/tests/dibi/Connection.objectTranslator.phpt +++ b/tests/dibi/Connection.objectTranslator.phpt @@ -49,7 +49,7 @@ test('DateTime', function () use ($conn) { // Without object translator, DateTime child is translated by driver Assert::same( - $conn->getDriver()->escapeDateTime($stamp), + $conn->getDatabaseEngine()->escapeDateTime($stamp), $conn->translate('?', $stamp), ); @@ -67,15 +67,15 @@ test('DateTime', function () use ($conn) { // With modifier, it is still translated by driver Assert::same( - $conn->getDriver()->escapeDateTime($stamp), + $conn->getDatabaseEngine()->escapeDateTime($stamp), $conn->translate('%dt', $stamp), ); Assert::same( - $conn->getDriver()->escapeDateTime($stamp), + $conn->getDatabaseEngine()->escapeDateTime($stamp), $conn->translate('%t', $stamp), ); Assert::same( - $conn->getDriver()->escapeDate($stamp), + $conn->getDatabaseEngine()->escapeDate($stamp), $conn->translate('%d', $stamp), ); @@ -83,7 +83,7 @@ test('DateTime', function () use ($conn) { // DateTimeImmutable as a Time parent is not affected and still translated by driver $dt = DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2022-11-22 12:13:14'); Assert::same( - $conn->getDriver()->escapeDateTime($dt), + $conn->getDatabaseEngine()->escapeDateTime($dt), $conn->translate('?', $dt), ); diff --git a/tests/dibi/Fluent.fetch.limit.mssql.phpt b/tests/dibi/Fluent.fetch.limit.mssql.phpt index d07ce4e87..cc8fdc362 100644 --- a/tests/dibi/Fluent.fetch.limit.mssql.phpt +++ b/tests/dibi/Fluent.fetch.limit.mssql.phpt @@ -2,12 +2,14 @@ declare(strict_types=1); +use Dibi\Drivers\SQLSrv\Connection; +use Dibi\Drivers\SQLSrv\Result; use Tester\Assert; require __DIR__ . '/bootstrap.php'; -class MockDriver extends Dibi\Drivers\SqlsrvDriver +class MockDriver extends Connection { public function __construct() { @@ -19,14 +21,14 @@ class MockDriver extends Dibi\Drivers\SqlsrvDriver } - public function query(string $sql): ?Dibi\ResultDriver + public function query(string $sql): ?Result { return new MockResult; } } -class MockResult extends Dibi\Drivers\SqlsrvResult +class MockResult extends Result { public function __construct() { diff --git a/tests/dibi/PdoDriver.providedConnection.phpt b/tests/dibi/PdoDriver.providedConnection.phpt index eb5243238..7492294d3 100644 --- a/tests/dibi/PdoDriver.providedConnection.phpt +++ b/tests/dibi/PdoDriver.providedConnection.phpt @@ -14,7 +14,7 @@ function buildPdoDriver(?int $errorMode) $pdo->setAttribute(PDO::ATTR_ERRMODE, $errorMode); } - new Dibi\Drivers\PdoDriver(['resource' => $pdo]); + new Dibi\Drivers\PDO\Connection(['resource' => $pdo]); } diff --git a/tests/dibi/bootstrap.php b/tests/dibi/bootstrap.php index 655c40542..c55da32e7 100644 --- a/tests/dibi/bootstrap.php +++ b/tests/dibi/bootstrap.php @@ -19,7 +19,7 @@ // load connection try { $config = Tester\Environment::loadData(); -} catch (Throwable $e) { +} catch (Throwable) { $config = parse_ini_file(__DIR__ . '/../databases.ini', process_sections: true); $config = reset($config); } @@ -62,7 +62,7 @@ function reformat($s) return strtr($s, '[]', '``'); } elseif ($config['system'] === 'postgre') { return strtr($s, '[]', '""'); - } elseif (in_array($config['system'], ['odbc', 'sqlite', 'sqlsrv'], true)) { + } elseif (in_array($config['system'], ['odbc', 'sqlite', 'sqlsrv'], strict: true)) { return $s; } else { trigger_error("Unsupported driver $config[system]", E_USER_WARNING); @@ -73,7 +73,7 @@ function reformat($s) function num($n) { $config = $GLOBALS['config']; - if (substr($config['dsn'] ?? '', 0, 5) === 'odbc:') { + if (str_starts_with($config['dsn'] ?? '', 'odbc:')) { $n = is_float($n) ? "$n.0" : (string) $n; } return $n;