mirror of
https://github.com/php/php-src.git
synced 2025-08-15 21:48:51 +02:00
dfaf7986de
take2 of #12657 ## About Firebird transaction Firebird is a full transactional database, so the DB itself does not support autocommit mode. (Strictly, there is an autocommit mode, but it is a different concept from the "autocommit" that we are used to with MySQL and others.) Therefore, a transaction must have started before any operation is performed, and autocommit mode had to be emulated in PHP. I made sure that a transaction always exists when in autocommit mode. Since the `in_transacntion` function does not work as expected, I have introduced `H->in_manually_txn` to determine whether a transaction is being manually manipulated. ## There are two types of commit/rollback (I'm not talking about two-phase commit. This change does not take into account two-phase commit.) There are `isc_commit_retaining` which starts a transaction again in the same context immediately after committing, and `isc_commit_transaction` which closes the transaction as is. Similarly, there are two types of rollback. ----------- Due to the default value of the transaction isolation level, autocommit mode may obtain unintended results. Regarding this, it would be too large to include support for transaction isolation levels in this PR, so I will leave it as is for now.
145 lines
4.1 KiB
C
145 lines
4.1 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: |
|
|
| https://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. |
|
|
+----------------------------------------------------------------------+
|
|
| Author: Ard Biesheuvel <abies@php.net> |
|
|
+----------------------------------------------------------------------+
|
|
*/
|
|
|
|
#ifndef PHP_PDO_FIREBIRD_INT_H
|
|
#define PHP_PDO_FIREBIRD_INT_H
|
|
|
|
#include <ibase.h>
|
|
|
|
#ifdef SQLDA_VERSION
|
|
#define PDO_FB_SQLDA_VERSION SQLDA_VERSION
|
|
#else
|
|
#define PDO_FB_SQLDA_VERSION 1
|
|
#endif
|
|
|
|
#define PDO_FB_DIALECT 3
|
|
|
|
#define PDO_FB_DEF_DATE_FMT "%Y-%m-%d"
|
|
#define PDO_FB_DEF_TIME_FMT "%H:%M:%S"
|
|
#define PDO_FB_DEF_TIMESTAMP_FMT PDO_FB_DEF_DATE_FMT " " PDO_FB_DEF_TIME_FMT
|
|
|
|
#define SHORT_MAX (1 << (8*sizeof(short)-1))
|
|
|
|
#if SIZEOF_ZEND_LONG == 8 && !defined(PHP_WIN32)
|
|
# define LL_LIT(lit) lit ## L
|
|
#else
|
|
# define LL_LIT(lit) lit ## LL
|
|
#endif
|
|
#define LL_MASK "ll"
|
|
|
|
/* Firebird API has a couple of missing const decls in its API */
|
|
#define const_cast(s) ((char*)(s))
|
|
|
|
#ifdef PHP_WIN32
|
|
typedef void (__stdcall *info_func_t)(char*);
|
|
#else
|
|
typedef void (*info_func_t)(char*);
|
|
#endif
|
|
|
|
#ifndef min
|
|
#define min(a,b) ((a)<(b)?(a):(b))
|
|
#endif
|
|
|
|
#if defined(_LP64) || defined(__LP64__) || defined(__arch64__) || defined(_WIN64)
|
|
# define PDO_FIREBIRD_HANDLE_INITIALIZER 0U
|
|
#else
|
|
# define PDO_FIREBIRD_HANDLE_INITIALIZER NULL
|
|
#endif
|
|
|
|
typedef struct {
|
|
int sqlcode;
|
|
char *errmsg;
|
|
size_t errmsg_length;
|
|
} pdo_firebird_error_info;
|
|
|
|
typedef struct {
|
|
/* the result of the last API call */
|
|
ISC_STATUS isc_status[20];
|
|
|
|
/* the connection handle */
|
|
isc_db_handle db;
|
|
|
|
/* the transaction handle */
|
|
isc_tr_handle tr;
|
|
bool in_manually_txn;
|
|
|
|
/* date and time format strings, can be set by the set_attribute method */
|
|
char *date_format;
|
|
char *time_format;
|
|
char *timestamp_format;
|
|
|
|
unsigned sql_dialect:2;
|
|
|
|
/* prepend table names on column names in fetch */
|
|
unsigned fetch_table_names:1;
|
|
|
|
unsigned _reserved:29;
|
|
|
|
pdo_firebird_error_info einfo;
|
|
} pdo_firebird_db_handle;
|
|
|
|
|
|
typedef struct {
|
|
/* the link that owns this statement */
|
|
pdo_firebird_db_handle *H;
|
|
|
|
/* the statement handle */
|
|
isc_stmt_handle stmt;
|
|
|
|
/* the name of the cursor (if it has one) */
|
|
char name[32];
|
|
|
|
/* the type of statement that was issued */
|
|
char statement_type:8;
|
|
|
|
/* whether EOF was reached for this statement */
|
|
unsigned exhausted:1;
|
|
|
|
/* successful isc_dsql_execute opens a cursor */
|
|
unsigned cursor_open:1;
|
|
|
|
unsigned _reserved:22;
|
|
|
|
/* the named params that were converted to ?'s by the driver */
|
|
HashTable *named_params;
|
|
|
|
/* the input SQLDA */
|
|
XSQLDA *in_sqlda;
|
|
|
|
/* the output SQLDA */
|
|
XSQLDA out_sqlda; /* last member */
|
|
} pdo_firebird_stmt;
|
|
|
|
extern const pdo_driver_t pdo_firebird_driver;
|
|
|
|
extern const struct pdo_stmt_methods firebird_stmt_methods;
|
|
|
|
extern void php_firebird_set_error(pdo_dbh_t *dbh, pdo_stmt_t *stmt, const char *state, const size_t state_len,
|
|
const char *msg, const size_t msg_len);
|
|
#define php_firebird_error(d) php_firebird_set_error(d, NULL, NULL, 0, NULL, 0)
|
|
#define php_firebird_error_stmt(s) php_firebird_set_error(s->dbh, s, NULL, 0, NULL, 0)
|
|
#define php_firebird_error_with_info(d,e,el,m,ml) php_firebird_set_error(d, NULL, e, el, m, ml)
|
|
#define php_firebird_error_stmt_with_info(s,e,el,m,ml) php_firebird_set_error(s->dbh, s, e, el, m, ml)
|
|
|
|
extern bool php_firebird_commit_transaction(pdo_dbh_t *dbh, bool retain);
|
|
|
|
enum {
|
|
PDO_FB_ATTR_DATE_FORMAT = PDO_ATTR_DRIVER_SPECIFIC,
|
|
PDO_FB_ATTR_TIME_FORMAT,
|
|
PDO_FB_ATTR_TIMESTAMP_FORMAT,
|
|
};
|
|
|
|
#endif /* PHP_PDO_FIREBIRD_INT_H */
|