mirror of
https://github.com/php/php-src.git
synced 2025-08-16 05:58:45 +02:00
caa710037e
Instead of requiring the type to be determined in advance by the describer function and then requiring get_col to return a buffer of appropriate type, allow get_col to return an arbitrary zval. See UPGRADING.INTERNALS for a more detailed description of the change. This makes the result fetching simpler, more efficient and more flexible. The general possibility already existed via the special PDO_PARAM_ZVAL type, but the usage was very inconvenient and/or inefficient. Now it's possible to easily implement behavior like "return int if it fits, otherwise string" and to avoid any kind of complex management of temporary buffers. This also fixes bug #40913 (our second highest voted bug of all time, for some reason). PARAM_LOB result bindings will now consistently return a stream resource, independently of the used database driver. I've tried my best to update all PDO drivers for this change, but some of the changes may be broken, as I cannot test or even build some of these drivers (in particular PDO dblib and PDO oci). Fixes are appreciated -- a working CI setup would be even more appreciated ;)
110 lines
3.6 KiB
C
110 lines
3.6 KiB
C
/*
|
|
+----------------------------------------------------------------------+
|
|
| Copyright (c) The PHP Group |
|
|
+----------------------------------------------------------------------+
|
|
| This source file is subject to version 3.01 of the PHP license, |
|
|
| that is bundled with this package in the file LICENSE, and is |
|
|
| available through the world-wide-web at the following url: |
|
|
| http://www.php.net/license/3_01.txt |
|
|
| If you did not receive a copy of the PHP license and are unable to |
|
|
| obtain it through the world-wide-web, please send a note to |
|
|
| license@php.net so we can mail you a copy immediately. |
|
|
+----------------------------------------------------------------------+
|
|
| Authors: Edin Kadribasic <edink@emini.dk> |
|
|
| Ilia Alshanestsky <ilia@prohost.org> |
|
|
| Wez Furlong <wez@php.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef PHP_PDO_PGSQL_INT_H
|
|
#define PHP_PDO_PGSQL_INT_H
|
|
|
|
#include <libpq-fe.h>
|
|
#include <libpq/libpq-fs.h>
|
|
#include <php.h>
|
|
|
|
#define PHP_PDO_PGSQL_CONNECTION_FAILURE_SQLSTATE "08006"
|
|
|
|
typedef struct {
|
|
const char *file;
|
|
int line;
|
|
unsigned int errcode;
|
|
char *errmsg;
|
|
} pdo_pgsql_error_info;
|
|
|
|
/* stuff we use in a pgsql database handle */
|
|
typedef struct {
|
|
PGconn *server;
|
|
unsigned attached:1;
|
|
unsigned _reserved:31;
|
|
pdo_pgsql_error_info einfo;
|
|
Oid pgoid;
|
|
unsigned int stmt_counter;
|
|
/* The following two variables have the same purpose. Unfortunately we need
|
|
to keep track of two different attributes having the same effect. */
|
|
zend_bool emulate_prepares;
|
|
zend_bool disable_native_prepares; /* deprecated since 5.6 */
|
|
zend_bool disable_prepares;
|
|
} pdo_pgsql_db_handle;
|
|
|
|
typedef struct {
|
|
Oid pgsql_type;
|
|
} pdo_pgsql_column;
|
|
|
|
typedef struct {
|
|
pdo_pgsql_db_handle *H;
|
|
PGresult *result;
|
|
pdo_pgsql_column *cols;
|
|
char *cursor_name;
|
|
char *stmt_name;
|
|
zend_string *query;
|
|
char **param_values;
|
|
int *param_lengths;
|
|
int *param_formats;
|
|
Oid *param_types;
|
|
int current_row;
|
|
zend_bool is_prepared;
|
|
} pdo_pgsql_stmt;
|
|
|
|
typedef struct {
|
|
Oid oid;
|
|
} pdo_pgsql_bound_param;
|
|
|
|
extern const pdo_driver_t pdo_pgsql_driver;
|
|
|
|
extern int _pdo_pgsql_error(pdo_dbh_t *dbh, pdo_stmt_t *stmt, int errcode, const char *sqlstate, const char *msg, const char *file, int line);
|
|
#define pdo_pgsql_error(d,e,z) _pdo_pgsql_error(d, NULL, e, z, NULL, __FILE__, __LINE__)
|
|
#define pdo_pgsql_error_msg(d,e,m) _pdo_pgsql_error(d, NULL, e, NULL, m, __FILE__, __LINE__)
|
|
#define pdo_pgsql_error_stmt(s,e,z) _pdo_pgsql_error(s->dbh, s, e, z, NULL, __FILE__, __LINE__)
|
|
#define pdo_pgsql_error_stmt_msg(stmt, e, sqlstate, msg) \
|
|
_pdo_pgsql_error(stmt->dbh, stmt, e, sqlstate, msg, __FILE__, __LINE__)
|
|
|
|
extern const struct pdo_stmt_methods pgsql_stmt_methods;
|
|
|
|
#define pdo_pgsql_sqlstate(r) PQresultErrorField(r, PG_DIAG_SQLSTATE)
|
|
|
|
enum {
|
|
PDO_PGSQL_ATTR_DISABLE_PREPARES = PDO_ATTR_DRIVER_SPECIFIC,
|
|
};
|
|
|
|
struct pdo_pgsql_lob_self {
|
|
zval dbh;
|
|
PGconn *conn;
|
|
int lfd;
|
|
Oid oid;
|
|
};
|
|
|
|
enum pdo_pgsql_specific_constants {
|
|
PGSQL_TRANSACTION_IDLE = PQTRANS_IDLE,
|
|
PGSQL_TRANSACTION_ACTIVE = PQTRANS_ACTIVE,
|
|
PGSQL_TRANSACTION_INTRANS = PQTRANS_INTRANS,
|
|
PGSQL_TRANSACTION_INERROR = PQTRANS_INERROR,
|
|
PGSQL_TRANSACTION_UNKNOWN = PQTRANS_UNKNOWN
|
|
};
|
|
|
|
php_stream *pdo_pgsql_create_lob_stream(zval *pdh, int lfd, Oid oid);
|
|
extern const php_stream_ops pdo_pgsql_lob_stream_ops;
|
|
|
|
void pdo_libpq_version(char *buf, size_t len);
|
|
|
|
#endif /* PHP_PDO_PGSQL_INT_H */
|