196

PHP: rfc:implement_sqlite_openblob_in_pdo

 6 years ago
source link: https://wiki.php.net/rfc/implement_sqlite_openblob_in_pdo
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

PHP RFC: Implement missing SQLite feature "openBlob" in PDO

Introduction

The “SQLite” driver of PDO is missing some features provided by the “SQLite3” extension, namely “openBlob” which allows to access a stored blob as a stream/file pointer.

Proposal

As discussed on internals the SQLite driver of PDO is missing some features that are present in the SQLite3 extension.

One of those features has already been proposed and merged: Add support for SQLite open flags.

A second one has been proposed and is awaiting merging: Implement sqlite_stmt_readonly in PDO

But we are still missing this feature: SQLite3::openBlob: opening blobs for reading and writing as streams.

This would be implemented following the current practice of adding a driver-specific method:

PDO::sqliteOpenBlob(string $table , string $column , int $rowid [, string $dbname = “main” [, int $flags = PDO::SQLITE_OPEN_READONLY ]] )

This would return a resource file pointer. This would match exactly the behaviour of SQLite3::openBlob.

This is following what already exists in PDO, examples:

These driver-specific methods are only defined when instantiating PDO with the right driver, trying to call them with another driver results in an error due to calling an undefined method.

Why not just use PDO LOBs support via PDO::bindColumn and PDO::bindParam?

For reference: http://www.php.net/manual/en/pdo.lobs.php

As this was discussed on internals, the PDO LOB support is for accessing LOB using SQL queries, openBlob is for accessing LOBs directly. This is a very fast and efficient way of using SQLite as a blob store, which can't be done if going through SQL queries as traditional PDO::PARAM_LOB support is doing. Furthermore, openBlob allows to both read and write in a blob at the same time. And finally the current code handling LOBs in PDO via bindParam and bindColumn is broken, it is returning a string (with MySQL and SQLite, but not PostgreSQL) instead of a resource file pointer. I will try to spend time fixing that in the coming months.

In conclusion this new method and the existing PDO LOB support provide different features for different needs, and both are useful.

Backward Incompatible Changes

None.

Proposed PHP Version(s)

PHP 7.3

RFC Impact

To SAPIs

None.

To Existing Extensions

None.

To Opcache

None.

New Constants

None.

php.ini Defaults

None.

Open Issues

None so far.

Unaffected PHP Functionality

Nothing else is affected.

Future Scope

Any proposal to review and change current style and behaviour of driver-specific methods in PDO. This is out of the scope of this proposal.

Proposed Voting Choices

This proposal requires a 50%+1 majority. Vote closing on Oct 27, 2017.

Implement sqliteOpenBlob in PDO?
Real name Yes No
adambaratz (adambaratz) success.png 
ashnazg (ashnazg)  success.png
bukka (bukka)  success.png
danack (danack)  success.png
daverandom (daverandom)  success.png
galvao (galvao) success.png 
kalle (kalle) success.png 
kelunik (kelunik)  success.png
mariano (mariano) success.png 
mbeccati (mbeccati) success.png 
ocramius (ocramius)  success.png
peehaa (peehaa)  success.png
salathe (salathe) success.png 
yunosh (yunosh) success.png 
Final result: 7 7
This poll has been closed.

Patches and Tests

Implementation

After the project is implemented, this section should contain

  1. the version(s) it was merged to
  2. a link to the git commit(s)
  3. a link to the PHP manual entry for the feature
  4. a link to the language specification section (if any)

References

Rejected Features

Keep this updated with features that were discussed on the mail lists.

rfc/implement_sqlite_openblob_in_pdo.txt · Last modified: 2020/08/01 23:50 by carusogabriel

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK