2
+----------------------------------------------------------------------+
4
+----------------------------------------------------------------------+
5
| Copyright (c) 1997-2009 The PHP Group |
6
+----------------------------------------------------------------------+
7
| This source file is subject to version 3.01 of the PHP license, |
8
| that is bundled with this package in the file LICENSE, and is |
9
| available through the world-wide-web at the following url: |
10
| http://www.php.net/license/3_01.txt |
11
| If you did not receive a copy of the PHP license and are unable to |
12
| obtain it through the world-wide-web, please send a note to |
13
| license@php.net so we can mail you a copy immediately. |
14
+----------------------------------------------------------------------+
15
| Authors: Scott MacVicar <scottmac@php.net> |
16
+----------------------------------------------------------------------+
19
/* $Id: sqlite3.c,v 1.1.2.39 2009/06/08 02:15:54 scottmac Exp $ */
27
#include "ext/standard/info.h"
28
#include "php_sqlite3.h"
29
#include "php_sqlite3_structs.h"
30
#include "main/SAPI.h"
34
#include "zend_exceptions.h"
35
#include "zend_interfaces.h"
38
ZEND_DECLARE_MODULE_GLOBALS(sqlite3)
40
static PHP_GINIT_FUNCTION(sqlite3);
41
static int php_sqlite3_authorizer(void *autharg, int access_type, const char *arg3, const char *arg4, const char *arg5, const char *arg6);
42
static void sqlite3_param_dtor(void *data);
43
static int php_sqlite3_compare_stmt_zval_free( php_sqlite3_free_list **free_list, zval *statement );
47
static void php_sqlite3_error(php_sqlite3_db_object *db_obj, char *format, ...)
53
va_start(arg, format);
54
vspprintf(&message, 0, format, arg);
57
if (db_obj->exception) {
58
zend_throw_exception(zend_exception_get_default(TSRMLS_C), message, 0 TSRMLS_CC);
60
php_error_docref(NULL TSRMLS_CC, E_WARNING, "%s", message);
69
#define SQLITE3_CHECK_INITIALIZED(db_obj, member, class_name) \
71
php_sqlite3_error(db_obj, "The " #class_name " object has not been correctly initialised"); \
78
STD_PHP_INI_ENTRY("sqlite3.extension_dir", NULL, PHP_INI_SYSTEM, OnUpdateString, extension_dir, zend_sqlite3_globals, sqlite3_globals)
83
static zend_object_handlers sqlite3_object_handlers;
84
static zend_object_handlers sqlite3_stmt_object_handlers;
85
static zend_object_handlers sqlite3_result_object_handlers;
88
zend_class_entry *php_sqlite3_sc_entry;
89
zend_class_entry *php_sqlite3_stmt_entry;
90
zend_class_entry *php_sqlite3_result_entry;
92
/* {{{ proto bool SQLite3::open(String filename [, int Flags [, string Encryption Key]])
93
Opens a SQLite 3 Database, if the build includes encryption then it will attempt to use the key. */
94
PHP_METHOD(sqlite3, open)
96
php_sqlite3_db_object *db_obj;
97
zval *object = getThis();
98
char *filename, *encryption_key, *fullpath;
99
int filename_len, encryption_key_len = 0;
100
long flags = SQLITE_OPEN_READWRITE | SQLITE_OPEN_CREATE;
101
zend_error_handling error_handling;
103
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
104
zend_replace_error_handling(EH_THROW, NULL, &error_handling TSRMLS_CC);
106
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|ls", &filename, &filename_len, &flags, &encryption_key, &encryption_key_len)) {
107
zend_restore_error_handling(&error_handling TSRMLS_CC);
111
zend_restore_error_handling(&error_handling TSRMLS_CC);
113
if (db_obj->initialised) {
114
zend_throw_exception(zend_exception_get_default(TSRMLS_C), "Already initialised DB Object", 0 TSRMLS_CC);
117
if (strncmp(filename, ":memory:", 8) != 0) {
118
if (!(fullpath = expand_filepath(filename, NULL TSRMLS_CC))) {
119
zend_throw_exception(zend_exception_get_default(TSRMLS_C), "Unable to expand filepath", 0 TSRMLS_CC);
123
if (PG(safe_mode) && (!php_checkuid(fullpath, NULL, CHECKUID_CHECK_FILE_AND_DIR))) {
124
zend_throw_exception_ex(zend_exception_get_default(TSRMLS_C), 0 TSRMLS_CC, "safe_mode prohibits opening %s", fullpath);
129
if (php_check_open_basedir(fullpath TSRMLS_CC)) {
130
zend_throw_exception_ex(zend_exception_get_default(TSRMLS_C), 0 TSRMLS_CC, "open_basedir prohibits opening %s", fullpath);
135
fullpath = estrdup(filename);
138
#if SQLITE_VERSION_NUMBER >= 3005000
139
if (sqlite3_open_v2(fullpath, &(db_obj->db), flags, NULL) != SQLITE_OK) {
141
if (sqlite3_open(fullpath, &(db_obj->db)) != SQLITE_OK) {
143
zend_throw_exception_ex(zend_exception_get_default(TSRMLS_C), 0 TSRMLS_CC, "Unable to open database: %s", sqlite3_errmsg(db_obj->db));
150
db_obj->initialised = 1;
153
if (encryption_key_len > 0) {
154
if (sqlite3_key(db_obj->db, encryption_key, encryption_key_len) != SQLITE_OK) {
155
zend_throw_exception_ex(zend_exception_get_default(TSRMLS_C), 0 TSRMLS_CC, "Unable to open database: %s", sqlite3_errmsg(db_obj->db));
161
if (PG(safe_mode) || (PG(open_basedir) && *PG(open_basedir))) {
162
sqlite3_set_authorizer(db_obj->db, php_sqlite3_authorizer, NULL);
171
/* {{{ proto bool SQLite3::close()
172
Close a SQLite 3 Database. */
173
PHP_METHOD(sqlite3, close)
175
php_sqlite3_db_object *db_obj;
176
zval *object = getThis();
178
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
180
if (zend_parse_parameters_none() == FAILURE) {
184
if (db_obj->initialised) {
185
zend_llist_clean(&(db_obj->free_list));
186
errcode = sqlite3_close(db_obj->db);
187
if (errcode != SQLITE_OK) {
188
php_sqlite3_error(db_obj, "Unable to close database: %d, %s", errcode, sqlite3_errmsg(db_obj->db));
191
db_obj->initialised = 0;
198
/* {{{ proto bool SQLite3::exec(String Query)
199
Executes a result-less query against a given database. */
200
PHP_METHOD(sqlite3, exec)
202
php_sqlite3_db_object *db_obj;
203
zval *object = getThis();
204
char *sql, *errtext = NULL;
206
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
208
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
210
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &sql, &sql_len)) {
214
if (sqlite3_exec(db_obj->db, sql, NULL, NULL, &errtext) != SQLITE_OK) {
215
php_sqlite3_error(db_obj, "%s", errtext);
216
sqlite3_free(errtext);
224
/* {{{ proto Array SQLite3::version()
225
Returns the SQLite3 Library version as a string constant and as a number. */
226
PHP_METHOD(sqlite3, version)
228
if (zend_parse_parameters_none() == FAILURE) {
232
array_init(return_value);
234
add_assoc_string(return_value, "versionString", (char*)sqlite3_libversion(), 1);
235
add_assoc_long(return_value, "versionNumber", sqlite3_libversion_number());
241
/* {{{ proto int SQLite3::lastInsertRowID()
242
Returns the rowid of the most recent INSERT into the database from the database connection. */
243
PHP_METHOD(sqlite3, lastInsertRowID)
245
php_sqlite3_db_object *db_obj;
246
zval *object = getThis();
247
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
249
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
251
if (zend_parse_parameters_none() == FAILURE) {
255
RETURN_LONG(sqlite3_last_insert_rowid(db_obj->db));
259
/* {{{ proto int SQLite3::lastErrorCode()
260
Returns the numeric result code of the most recent failed sqlite API call for the database connection. */
261
PHP_METHOD(sqlite3, lastErrorCode)
263
php_sqlite3_db_object *db_obj;
264
zval *object = getThis();
265
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
267
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->db, SQLite3)
269
if (zend_parse_parameters_none() == FAILURE) {
273
RETURN_LONG(sqlite3_errcode(db_obj->db));
277
/* {{{ proto string SQLite3::lastErrorMsg()
278
Returns english text describing the most recent failed sqlite API call for the database connection. */
279
PHP_METHOD(sqlite3, lastErrorMsg)
281
php_sqlite3_db_object *db_obj;
282
zval *object = getThis();
283
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
285
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->db, SQLite3)
287
if (zend_parse_parameters_none() == FAILURE) {
291
RETVAL_STRING((char *)sqlite3_errmsg(db_obj->db), 1);
295
#ifndef SQLITE_OMIT_LOAD_EXTENSION
296
/* {{{ proto bool SQLite3::loadExtension(String Shared Library)
297
Attempts to load an SQLite extension library. */
298
PHP_METHOD(sqlite3, loadExtension)
300
php_sqlite3_db_object *db_obj;
301
zval *object = getThis();
302
char *extension, *lib_path, *extension_dir, *errtext = NULL;
303
char fullpath[MAXPATHLEN];
304
int extension_len, extension_dir_len;
305
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
307
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
309
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &extension, &extension_len)) {
314
if ((strncmp(sapi_module.name, "cgi", 3) != 0) &&
315
(strcmp(sapi_module.name, "cli") != 0) &&
316
(strncmp(sapi_module.name, "embed", 5) != 0)
317
) { php_sqlite3_error(db_obj, "Not supported in multithreaded Web servers");
322
if (!SQLITE3G(extension_dir)) {
323
php_sqlite3_error(db_obj, "SQLite Extension are disabled");
327
if (extension_len == 0) {
328
php_sqlite3_error(db_obj, "Empty string as an extension");
332
extension_dir = SQLITE3G(extension_dir);
333
extension_dir_len = strlen(SQLITE3G(extension_dir));
335
if (IS_SLASH(extension_dir[extension_dir_len-1])) {
336
spprintf(&lib_path, 0, "%s%s", extension_dir, extension);
338
spprintf(&lib_path, 0, "%s%c%s", extension_dir, DEFAULT_SLASH, extension);
341
if (!VCWD_REALPATH(lib_path, fullpath)) {
342
php_sqlite3_error(db_obj, "Unable to load extension at '%s'", lib_path);
349
if (strncmp(fullpath, extension_dir, extension_dir_len) != 0) {
350
php_sqlite3_error(db_obj, "Unable to open extensions outside the defined directory");
354
/* Extension loading should only be enabled for when we attempt to load */
355
sqlite3_enable_load_extension(db_obj->db, 1);
356
if (sqlite3_load_extension(db_obj->db, fullpath, 0, &errtext) != SQLITE_OK) {
357
php_sqlite3_error(db_obj, "%s", errtext);
358
sqlite3_free(errtext);
359
sqlite3_enable_load_extension(db_obj->db, 0);
362
sqlite3_enable_load_extension(db_obj->db, 0);
369
/* {{{ proto int SQLite3::changes()
370
Returns the number of database rows that were changed (or inserted or deleted) by the most recent SQL statement. */
371
PHP_METHOD(sqlite3, changes)
373
php_sqlite3_db_object *db_obj;
374
zval *object = getThis();
375
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
377
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
379
if (zend_parse_parameters_none() == FAILURE) {
383
RETURN_LONG(sqlite3_changes(db_obj->db));
387
/* {{{ proto String SQLite3::escapeString(String value)
388
Returns a string that has been properly escaped. */
389
PHP_METHOD(sqlite3, escapeString)
394
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &sql, &sql_len)) {
399
ret = sqlite3_mprintf("%q", sql);
401
RETVAL_STRING(ret, 1);
405
RETURN_EMPTY_STRING();
410
/* {{{ proto SQLite3Stmt SQLite3::prepare(String Query)
411
Returns a prepared SQL statement for execution. */
412
PHP_METHOD(sqlite3, prepare)
414
php_sqlite3_db_object *db_obj;
415
php_sqlite3_stmt *stmt_obj;
416
zval *object = getThis();
418
int sql_len, errcode;
419
php_sqlite3_free_list *free_item;
421
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
423
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
425
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &sql, &sql_len)) {
433
object_init_ex(return_value, php_sqlite3_stmt_entry);
434
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(return_value TSRMLS_CC);
435
stmt_obj->db_obj = db_obj;
436
stmt_obj->db_obj_zval = getThis();
440
errcode = sqlite3_prepare_v2(db_obj->db, sql, sql_len, &(stmt_obj->stmt), NULL);
441
if (errcode != SQLITE_OK) {
442
php_sqlite3_error(db_obj, "Unable to prepare statement: %d, %s", errcode, sqlite3_errmsg(db_obj->db));
443
zval_dtor(return_value);
447
stmt_obj->initialised = 1;
449
free_item = emalloc(sizeof(php_sqlite3_free_list));
450
free_item->stmt_obj = stmt_obj;
451
free_item->stmt_obj_zval = return_value;
453
zend_llist_add_element(&(db_obj->free_list), &free_item);
457
/* {{{ proto SQLite3Result SQLite3::query(String Query)
458
Returns true or false, for queries that return data it will return a SQLite3Result object. */
459
PHP_METHOD(sqlite3, query)
461
php_sqlite3_db_object *db_obj;
462
php_sqlite3_result *result;
463
php_sqlite3_stmt *stmt_obj;
464
zval *object = getThis();
466
char *sql, *errtext = NULL;
467
int sql_len, return_code;
468
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
470
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
472
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &sql, &sql_len)) {
480
/* If there was no return value then just execute the query */
481
if (!return_value_used) {
482
if (sqlite3_exec(db_obj->db, sql, NULL, NULL, &errtext) != SQLITE_OK) {
483
php_sqlite3_error(db_obj, "%s", errtext);
484
sqlite3_free(errtext);
491
object_init_ex(stmt, php_sqlite3_stmt_entry);
492
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(stmt TSRMLS_CC);
493
stmt_obj->db_obj = db_obj;
494
stmt_obj->db_obj_zval = getThis();
498
return_code = sqlite3_prepare_v2(db_obj->db, sql, sql_len, &(stmt_obj->stmt), NULL);
499
if (return_code != SQLITE_OK) {
500
php_sqlite3_error(db_obj, "Unable to prepare statement: %d, %s", return_code, sqlite3_errmsg(db_obj->db));
501
zval_ptr_dtor(&stmt);
505
stmt_obj->initialised = 1;
507
object_init_ex(return_value, php_sqlite3_result_entry);
508
result = (php_sqlite3_result *)zend_object_store_get_object(return_value TSRMLS_CC);
509
result->db_obj = db_obj;
510
result->stmt_obj = stmt_obj;
511
result->stmt_obj_zval = stmt;
513
return_code = sqlite3_step(result->stmt_obj->stmt);
515
switch (return_code) {
516
case SQLITE_ROW: /* Valid Row */
517
case SQLITE_DONE: /* Valid but no results */
519
php_sqlite3_free_list *free_item;
520
free_item = emalloc(sizeof(php_sqlite3_free_list));
521
free_item->stmt_obj = stmt_obj;
522
free_item->stmt_obj_zval = stmt;
523
zend_llist_add_element(&(db_obj->free_list), &free_item);
524
sqlite3_reset(result->stmt_obj->stmt);
528
php_sqlite3_error(db_obj, "Unable to execute statement: %s", sqlite3_errmsg(db_obj->db));
529
sqlite3_finalize(stmt_obj->stmt);
530
stmt_obj->initialised = 0;
531
zval_dtor(return_value);
537
static zval* sqlite_value_to_zval(sqlite3_stmt *stmt, int column) /* {{{ */
541
switch (sqlite3_column_type(stmt, column)) {
543
if ((sqlite3_column_int64(stmt, column)) >= INT_MAX || sqlite3_column_int64(stmt, column) <= INT_MIN) {
544
ZVAL_STRINGL(data, (char *)sqlite3_column_text(stmt, column), sqlite3_column_bytes(stmt, column), 1);
546
ZVAL_LONG(data, sqlite3_column_int64(stmt, column));
551
ZVAL_DOUBLE(data, sqlite3_column_double(stmt, column));
559
ZVAL_STRING(data, (char*)sqlite3_column_text(stmt, column), 1);
564
ZVAL_STRINGL(data, (char*)sqlite3_column_blob(stmt, column), sqlite3_column_bytes(stmt, column), 1);
570
/* {{{ proto SQLite3Result SQLite3::querySingle(String Query [, bool entire_row = false])
571
Returns a string of the first column, or an array of the entire row. */
572
PHP_METHOD(sqlite3, querySingle)
574
php_sqlite3_db_object *db_obj;
575
zval *object = getThis();
576
char *sql, *errtext = NULL;
577
int sql_len, return_code;
578
zend_bool entire_row = 0;
580
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
582
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
584
if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &sql, &sql_len, &entire_row)) {
592
/* If there was no return value then just execute the query */
593
if (!return_value_used) {
594
if (sqlite3_exec(db_obj->db, sql, NULL, NULL, &errtext) != SQLITE_OK) {
595
php_sqlite3_error(db_obj, "%s", errtext);
596
sqlite3_free(errtext);
601
return_code = sqlite3_prepare_v2(db_obj->db, sql, sql_len, &stmt, NULL);
602
if (return_code != SQLITE_OK) {
603
php_sqlite3_error(db_obj, "Unable to prepare statement: %d, %s", return_code, sqlite3_errmsg(db_obj->db));
607
return_code = sqlite3_step(stmt);
609
switch (return_code) {
610
case SQLITE_ROW: /* Valid Row */
614
data = sqlite_value_to_zval(stmt, 0);
615
*return_value = *data;
616
zval_copy_ctor(return_value);
621
array_init(return_value);
622
for (i = 0; i < sqlite3_data_count(stmt); i++) {
624
data = sqlite_value_to_zval(stmt, i);
625
add_assoc_zval(return_value, (char*)sqlite3_column_name(stmt, i), data);
630
case SQLITE_DONE: /* Valid but no results */
635
array_init(return_value);
640
php_sqlite3_error(db_obj, "Unable to execute statement: %s", sqlite3_errmsg(db_obj->db));
643
sqlite3_finalize(stmt);
647
static int sqlite3_do_callback(struct php_sqlite3_fci *fc, zval *cb, int argc, sqlite3_value **argv, sqlite3_context *context, int is_agg TSRMLS_DC) /* {{{ */
649
zval ***zargs = NULL;
654
php_sqlite3_agg_context *agg_context = NULL;
660
fake_argc = argc + is_agg;
662
fc->fci.size = sizeof(fc->fci);
663
fc->fci.function_table = EG(function_table);
664
fc->fci.function_name = cb;
665
fc->fci.symbol_table = NULL;
666
fc->fci.object_ptr = NULL;
667
fc->fci.retval_ptr_ptr = &retval;
668
fc->fci.param_count = fake_argc;
670
/* build up the params */
673
zargs = (zval ***)safe_emalloc(fake_argc, sizeof(zval **), 0);
677
/* summon the aggregation context */
678
agg_context = (php_sqlite3_agg_context *)sqlite3_aggregate_context(context, sizeof(php_sqlite3_agg_context));
680
if (!agg_context->zval_context) {
681
MAKE_STD_ZVAL(agg_context->zval_context);
682
ZVAL_NULL(agg_context->zval_context);
684
zargs[0] = &agg_context->zval_context;
686
zargs[1] = emalloc(sizeof(zval*));
687
MAKE_STD_ZVAL(*zargs[1]);
688
ZVAL_LONG(*zargs[1], agg_context->row_count);
691
for (i = 0; i < argc; i++) {
692
zargs[i + is_agg] = emalloc(sizeof(zval *));
693
MAKE_STD_ZVAL(*zargs[i + is_agg]);
695
switch (sqlite3_value_type(argv[i])) {
697
ZVAL_LONG(*zargs[i + is_agg], sqlite3_value_int(argv[i]));
701
ZVAL_DOUBLE(*zargs[i + is_agg], sqlite3_value_double(argv[i]));
705
ZVAL_NULL(*zargs[i + is_agg]);
711
ZVAL_STRINGL(*zargs[i + is_agg], (char*)sqlite3_value_text(argv[i]), sqlite3_value_bytes(argv[i]), 1);
716
fc->fci.params = zargs;
718
if ((ret = zend_call_function(&fc->fci, &fc->fcc TSRMLS_CC)) == FAILURE) {
719
php_error_docref(NULL TSRMLS_CC, E_WARNING, "An error occurred while invoking the callback");
722
/* clean up the params */
724
for (i = is_agg; i < argc + is_agg; i++) {
725
zval_ptr_dtor(zargs[i]);
729
zval_ptr_dtor(zargs[1]);
735
if (!is_agg || !argv) {
736
/* only set the sqlite return value if we are a scalar function,
737
* or if we are finalizing an aggregate */
739
switch (Z_TYPE_P(retval)) {
741
sqlite3_result_int(context, Z_LVAL_P(retval));
745
sqlite3_result_null(context);
749
sqlite3_result_double(context, Z_DVAL_P(retval));
753
convert_to_string_ex(&retval);
754
sqlite3_result_text(context, Z_STRVAL_P(retval), Z_STRLEN_P(retval), SQLITE_TRANSIENT);
758
sqlite3_result_error(context, "failed to invoke callback", 0);
761
if (agg_context && agg_context->zval_context) {
762
zval_ptr_dtor(&agg_context->zval_context);
765
/* we're stepping in an aggregate; the return value goes into
767
if (agg_context && agg_context->zval_context) {
768
zval_ptr_dtor(&agg_context->zval_context);
771
agg_context->zval_context = retval;
774
agg_context->zval_context = NULL;
779
zval_ptr_dtor(&retval);
785
static void php_sqlite3_callback_func(sqlite3_context *context, int argc, sqlite3_value **argv) /* {{{ */
787
php_sqlite3_func *func = (php_sqlite3_func *)sqlite3_user_data(context);
790
sqlite3_do_callback(&func->afunc, func->func, argc, argv, context, 0 TSRMLS_CC);
794
static void php_sqlite3_callback_step(sqlite3_context *context, int argc, sqlite3_value **argv) /* {{{ */
796
php_sqlite3_func *func = (php_sqlite3_func *)sqlite3_user_data(context);
797
php_sqlite3_agg_context *agg_context = (php_sqlite3_agg_context *)sqlite3_aggregate_context(context, sizeof(php_sqlite3_agg_context));
800
agg_context->row_count++;
802
sqlite3_do_callback(&func->astep, func->step, argc, argv, context, 1 TSRMLS_CC);
806
static void php_sqlite3_callback_final(sqlite3_context *context) /* {{{ */
808
php_sqlite3_func *func = (php_sqlite3_func *)sqlite3_user_data(context);
809
php_sqlite3_agg_context *agg_context = (php_sqlite3_agg_context *)sqlite3_aggregate_context(context, sizeof(php_sqlite3_agg_context));
812
agg_context->row_count = 0;
814
sqlite3_do_callback(&func->afini, func->fini, 0, NULL, context, 1 TSRMLS_CC);
818
/* {{{ proto bool SQLite3::createFunction(string name, mixed callback [, int argcount])
819
Allows registration of a PHP function as a SQLite UDF that can be called within SQL statements. */
820
PHP_METHOD(sqlite3, createFunction)
822
php_sqlite3_db_object *db_obj;
823
zval *object = getThis();
824
php_sqlite3_func *func;
825
char *sql_func, *callback_name;
828
long sql_func_num_args = -1;
829
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
831
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
833
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz|l", &sql_func, &sql_func_len, &callback_func, &sql_func_num_args) == FAILURE) {
841
if (!zend_is_callable(callback_func, 0, &callback_name TSRMLS_CC)) {
842
php_sqlite3_error(db_obj, "Not a valid callback function %s", callback_name);
843
efree(callback_name);
846
efree(callback_name);
848
func = (php_sqlite3_func *)ecalloc(1, sizeof(*func));
850
if (sqlite3_create_function(db_obj->db, sql_func, sql_func_num_args, SQLITE_UTF8, func, php_sqlite3_callback_func, NULL, NULL) == SQLITE_OK) {
851
func->func_name = estrdup(sql_func);
853
MAKE_STD_ZVAL(func->func);
854
*(func->func) = *callback_func;
855
zval_copy_ctor(func->func);
856
INIT_PZVAL(func->func);
858
func->argc = sql_func_num_args;
859
func->next = db_obj->funcs;
860
db_obj->funcs = func;
870
/* {{{ proto bool SQLite3::createAggregate(string name, mixed step, mixed final [, int argcount])
871
Allows registration of a PHP function for use as an aggregate. */
872
PHP_METHOD(sqlite3, createAggregate)
874
php_sqlite3_db_object *db_obj;
875
zval *object = getThis();
876
php_sqlite3_func *func;
877
char *sql_func, *callback_name;
879
zval *step_callback, *fini_callback;
880
long sql_func_num_args = -1;
881
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
883
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
885
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "szz|l", &sql_func, &sql_func_len, &step_callback, &fini_callback, &sql_func_num_args) == FAILURE) {
893
if (!zend_is_callable(step_callback, 0, &callback_name TSRMLS_CC)) {
894
php_sqlite3_error(db_obj, "Not a valid callback function %s", callback_name);
895
efree(callback_name);
898
efree(callback_name);
900
if (!zend_is_callable(fini_callback, 0, &callback_name TSRMLS_CC)) {
901
php_sqlite3_error(db_obj, "Not a valid callback function %s", callback_name);
902
efree(callback_name);
905
efree(callback_name);
907
func = (php_sqlite3_func *)ecalloc(1, sizeof(*func));
909
if (sqlite3_create_function(db_obj->db, sql_func, sql_func_num_args, SQLITE_UTF8, func, NULL, php_sqlite3_callback_step, php_sqlite3_callback_final) == SQLITE_OK) {
910
func->func_name = estrdup(sql_func);
912
MAKE_STD_ZVAL(func->step);
913
*(func->step) = *step_callback;
914
zval_copy_ctor(func->step);
915
INIT_PZVAL(func->step);
917
MAKE_STD_ZVAL(func->fini);
918
*(func->fini) = *fini_callback;
919
zval_copy_ctor(func->fini);
920
INIT_PZVAL(func->fini);
922
func->argc = sql_func_num_args;
923
func->next = db_obj->funcs;
924
db_obj->funcs = func;
938
} php_stream_sqlite3_data;
940
static size_t php_sqlite3_stream_write(php_stream *stream, const char *buf, size_t count TSRMLS_DC)
942
/* php_stream_sqlite3_data *sqlite3_stream = (php_stream_sqlite3_data *) stream->abstract; */
947
static size_t php_sqlite3_stream_read(php_stream *stream, char *buf, size_t count TSRMLS_DC)
949
php_stream_sqlite3_data *sqlite3_stream = (php_stream_sqlite3_data *) stream->abstract;
951
if (sqlite3_stream->position + count >= sqlite3_stream->size) {
952
count = sqlite3_stream->size - sqlite3_stream->position;
956
if (sqlite3_blob_read(sqlite3_stream->blob, buf, count, sqlite3_stream->position) != SQLITE_OK) {
959
sqlite3_stream->position += count;
964
static int php_sqlite3_stream_close(php_stream *stream, int close_handle TSRMLS_DC)
966
php_stream_sqlite3_data *sqlite3_stream = (php_stream_sqlite3_data *) stream->abstract;
968
if (sqlite3_blob_close(sqlite3_stream->blob) != SQLITE_OK) {
969
/* Error occured, but it still closed */
972
efree(sqlite3_stream);
977
static int php_sqlite3_stream_flush(php_stream *stream TSRMLS_DC)
984
static int php_sqlite3_stream_seek(php_stream *stream, off_t offset, int whence, off_t *newoffs TSRMLS_DC)
986
php_stream_sqlite3_data *sqlite3_stream = (php_stream_sqlite3_data *) stream->abstract;
991
if (sqlite3_stream->position < (size_t)(-offset)) {
992
sqlite3_stream->position = 0;
996
sqlite3_stream->position = sqlite3_stream->position + offset;
997
*newoffs = sqlite3_stream->position;
1002
if (sqlite3_stream->position + (size_t)(offset) > sqlite3_stream->size) {
1003
sqlite3_stream->position = sqlite3_stream->size;
1007
sqlite3_stream->position = sqlite3_stream->position + offset;
1008
*newoffs = sqlite3_stream->position;
1014
if (sqlite3_stream->size < (size_t)(offset)) {
1015
sqlite3_stream->position = sqlite3_stream->size;
1019
sqlite3_stream->position = offset;
1020
*newoffs = sqlite3_stream->position;
1026
sqlite3_stream->position = sqlite3_stream->size;
1029
} else if (sqlite3_stream->size < (size_t)(-offset)) {
1030
sqlite3_stream->position = 0;
1034
sqlite3_stream->position = sqlite3_stream->size + offset;
1035
*newoffs = sqlite3_stream->position;
1040
*newoffs = sqlite3_stream->position;
1047
static int php_sqlite3_stream_cast(php_stream *stream, int castas, void **ret TSRMLS_DC)
1052
static int php_sqlite3_stream_stat(php_stream *stream, php_stream_statbuf *ssb TSRMLS_DC)
1054
/* TODO: fill in details based on Data: and Content-Length: headers, and/or data
1055
* from curl_easy_getinfo().
1056
* For now, return -1 to indicate that it doesn't make sense to stat this stream */
1060
static php_stream_ops php_stream_sqlite3_ops = {
1061
php_sqlite3_stream_write,
1062
php_sqlite3_stream_read,
1063
php_sqlite3_stream_close,
1064
php_sqlite3_stream_flush,
1066
php_sqlite3_stream_seek,
1067
php_sqlite3_stream_cast,
1068
php_sqlite3_stream_stat
1071
/* {{{ proto resource SQLite3::openBlob(string table, string column, int rowid [, string dbname])
1072
Open a blob as a stream which we can read / write to. */
1073
PHP_METHOD(sqlite3, openBlob)
1075
php_sqlite3_db_object *db_obj;
1076
zval *object = getThis();
1077
char *table, *column, *dbname = "main";
1078
int table_len, column_len, dbname_len;
1079
long rowid, flags = 0;
1080
sqlite3_blob *blob = NULL;
1081
php_stream_sqlite3_data *sqlite3_stream;
1084
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
1086
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
1088
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ssl|s", &table, &table_len, &column, &column_len, &rowid, &dbname, &dbname_len) == FAILURE) {
1092
if (sqlite3_blob_open(db_obj->db, dbname, table, column, rowid, flags, &blob) != SQLITE_OK) {
1093
php_sqlite3_error(db_obj, "Unable to open blob: %s", sqlite3_errmsg(db_obj->db));
1097
sqlite3_stream = emalloc(sizeof(php_stream_sqlite3_data));
1098
sqlite3_stream->blob = blob;
1099
sqlite3_stream->position = 0;
1100
sqlite3_stream->size = sqlite3_blob_bytes(blob);
1102
stream = php_stream_alloc(&php_stream_sqlite3_ops, sqlite3_stream, 0, "rb");
1105
php_stream_to_zval(stream, return_value);
1112
/* {{{ proto bool SQLite3::enableExceptions([bool enableExceptions = false])
1113
Enables an exception error mode. */
1114
PHP_METHOD(sqlite3, enableExceptions)
1116
php_sqlite3_db_object *db_obj;
1117
zval *object = getThis();
1118
zend_bool enableExceptions = 0;
1120
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(object TSRMLS_CC);
1122
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &enableExceptions) == FAILURE) {
1126
RETVAL_BOOL(db_obj->exception);
1128
db_obj->exception = enableExceptions;
1132
/* {{{ proto int SQLite3Stmt::paramCount()
1133
Returns the number of parameters within the prepared statement. */
1134
PHP_METHOD(sqlite3stmt, paramCount)
1136
php_sqlite3_stmt *stmt_obj;
1137
zval *object = getThis();
1138
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1140
if (zend_parse_parameters_none() == FAILURE) {
1144
RETURN_LONG(sqlite3_bind_parameter_count(stmt_obj->stmt));
1148
/* {{{ proto bool SQLite3Stmt::close()
1149
Closes the prepared statement. */
1150
PHP_METHOD(sqlite3stmt, close)
1152
php_sqlite3_stmt *stmt_obj;
1153
zval *object = getThis();
1154
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1156
if (zend_parse_parameters_none() == FAILURE) {
1160
zend_llist_del_element(&(stmt_obj->db_obj->free_list), object, (int (*)(void *, void *)) php_sqlite3_compare_stmt_zval_free);
1166
/* {{{ proto bool SQLite3Stmt::reset()
1167
Reset the prepared statement to the state before it was executed, bindings still remain. */
1168
PHP_METHOD(sqlite3stmt, reset)
1170
php_sqlite3_stmt *stmt_obj;
1171
zval *object = getThis();
1172
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1174
if (zend_parse_parameters_none() == FAILURE) {
1178
if (sqlite3_reset(stmt_obj->stmt) != SQLITE_OK) {
1179
php_sqlite3_error(stmt_obj->db_obj, "Unable to reset statement: %s", sqlite3_errmsg(sqlite3_db_handle(stmt_obj->stmt)));
1186
/* {{{ proto bool SQLite3Stmt::clear()
1187
Clear all current bound parameters. */
1188
PHP_METHOD(sqlite3stmt, clear)
1190
php_sqlite3_stmt *stmt_obj;
1191
zval *object = getThis();
1192
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1194
if (zend_parse_parameters_none() == FAILURE) {
1198
if (sqlite3_clear_bindings(stmt_obj->stmt) != SQLITE_OK) {
1199
php_sqlite3_error(stmt_obj->db_obj, "Unable to clear statement: %s", sqlite3_errmsg(sqlite3_db_handle(stmt_obj->stmt)));
1207
static int register_bound_parameter_to_sqlite(struct php_sqlite3_bound_param *param, php_sqlite3_stmt *stmt TSRMLS_DC) /* {{{ */
1210
hash = stmt->bound_params;
1213
ALLOC_HASHTABLE(hash);
1214
zend_hash_init(hash, 13, NULL, sqlite3_param_dtor, 0);
1215
stmt->bound_params = hash;
1218
/* We need a : prefix to resolve a name to a parameter number */
1220
if (param->name[0] != ':') {
1221
/* pre-increment for character + 1 for null */
1222
char *temp = emalloc(++param->name_len + 1);
1224
memmove(temp+1, param->name, param->name_len);
1227
param->name = estrndup(param->name, param->name_len);
1230
param->param_number = sqlite3_bind_parameter_index(stmt->stmt, param->name);
1233
if (param->param_number < 1) {
1238
if (param->param_number >= 1) {
1239
zend_hash_index_del(hash, param->param_number);
1243
zend_hash_update(hash, param->name, param->name_len, param, sizeof(*param), NULL);
1245
zend_hash_index_update(hash, param->param_number, param, sizeof(*param), NULL);
1252
/* {{{ proto bool SQLite3Stmt::bindParam(int parameter_number, mixed parameter [, int type])
1253
Bind Paramater to a stmt variable. */
1254
PHP_METHOD(sqlite3stmt, bindParam)
1256
php_sqlite3_stmt *stmt_obj;
1257
zval *object = getThis();
1258
struct php_sqlite3_bound_param param = {0};
1259
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1261
param.param_number = -1;
1262
param.type = SQLITE3_TEXT;
1264
if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC, "lz|l", ¶m.param_number, ¶m.parameter, ¶m.type) == FAILURE) {
1265
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz|l", ¶m.name, ¶m.name_len, ¶m.parameter, ¶m.type) == FAILURE) {
1270
Z_ADDREF_P(param.parameter);
1272
if (!register_bound_parameter_to_sqlite(¶m, stmt_obj TSRMLS_CC)) {
1273
if (param.parameter) {
1274
zval_ptr_dtor(&(param.parameter));
1275
param.parameter = NULL;
1283
/* {{{ proto bool SQLite3Stmt::bindValue(int parameter_number, mixed parameter [, int type])
1284
Bind Value of a parameter to a stmt variable. */
1285
PHP_METHOD(sqlite3stmt, bindValue)
1287
php_sqlite3_stmt *stmt_obj;
1288
zval *object = getThis();
1289
struct php_sqlite3_bound_param param = {0};
1290
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1292
param.param_number = -1;
1293
param.type = SQLITE3_TEXT;
1295
if (zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS() TSRMLS_CC, "lz/|l", ¶m.param_number, ¶m.parameter, ¶m.type) == FAILURE) {
1296
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz/|l", ¶m.name, ¶m.name_len, ¶m.parameter, ¶m.type) == FAILURE) {
1301
Z_ADDREF_P(param.parameter);
1303
if (!register_bound_parameter_to_sqlite(¶m, stmt_obj TSRMLS_CC)) {
1304
if (param.parameter) {
1305
zval_ptr_dtor(&(param.parameter));
1306
param.parameter = NULL;
1314
/* {{{ proto SQLite3Result SQLite3Stmt::execute()
1315
Executes a prepared statement and returns a result set object. */
1316
PHP_METHOD(sqlite3stmt, execute)
1318
php_sqlite3_stmt *stmt_obj;
1319
php_sqlite3_result *result;
1320
zval *object = getThis();
1321
int return_code = 0;
1322
struct php_sqlite3_bound_param *param;
1324
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1326
if (zend_parse_parameters_none() == FAILURE) {
1330
SQLITE3_CHECK_INITIALIZED(stmt_obj->db_obj, stmt_obj->initialised, SQLite3)
1332
if (stmt_obj->bound_params) {
1333
zend_hash_internal_pointer_reset(stmt_obj->bound_params);
1334
while (zend_hash_get_current_data(stmt_obj->bound_params, (void **)¶m) == SUCCESS) {
1335
/* If the ZVAL is null then it should be bound as that */
1336
if (Z_TYPE_P(param->parameter) == IS_NULL) {
1337
sqlite3_bind_null(stmt_obj->stmt, param->param_number);
1338
zend_hash_move_forward(stmt_obj->bound_params);
1342
switch (param->type) {
1343
case SQLITE_INTEGER:
1344
convert_to_long(param->parameter);
1345
sqlite3_bind_int(stmt_obj->stmt, param->param_number, Z_LVAL_P(param->parameter));
1349
/* convert_to_double(param->parameter);*/
1350
sqlite3_bind_double(stmt_obj->stmt, param->param_number, Z_DVAL_P(param->parameter));
1355
php_stream *stream = NULL;
1357
char *buffer = NULL;
1358
if (Z_TYPE_P(param->parameter) == IS_RESOURCE) {
1359
php_stream_from_zval_no_verify(stream, ¶m->parameter);
1360
if (stream == NULL) {
1361
php_sqlite3_error(stmt_obj->db_obj, "Unable to read stream for parameter %ld", param->param_number);
1364
blength = php_stream_copy_to_mem(stream, (void *)&buffer, PHP_STREAM_COPY_ALL, 0);
1366
convert_to_string(param->parameter);
1367
blength = Z_STRLEN_P(param->parameter);
1368
buffer = Z_STRVAL_P(param->parameter);
1371
sqlite3_bind_blob(stmt_obj->stmt, param->param_number, buffer, blength, SQLITE_TRANSIENT);
1380
convert_to_string(param->parameter);
1381
sqlite3_bind_text(stmt_obj->stmt, param->param_number, Z_STRVAL_P(param->parameter), Z_STRLEN_P(param->parameter), SQLITE_STATIC);
1385
sqlite3_bind_null(stmt_obj->stmt, param->param_number);
1389
php_sqlite3_error(stmt_obj->db_obj, "Unknown parameter type: %ld for parameter %ld", param->type, param->param_number);
1392
zend_hash_move_forward(stmt_obj->bound_params);
1396
return_code = sqlite3_step(stmt_obj->stmt);
1398
switch (return_code) {
1399
case SQLITE_ROW: /* Valid Row */
1400
case SQLITE_DONE: /* Valid but no results */
1402
sqlite3_reset(stmt_obj->stmt);
1403
object_init_ex(return_value, php_sqlite3_result_entry);
1404
result = (php_sqlite3_result *)zend_object_store_get_object(return_value TSRMLS_CC);
1408
result->is_prepared_statement = 1;
1409
result->db_obj = stmt_obj->db_obj;
1410
result->stmt_obj = stmt_obj;
1411
result->stmt_obj_zval = getThis();
1416
sqlite3_reset(stmt_obj->stmt);
1419
php_sqlite3_error(stmt_obj->db_obj, "Unable to execute statement: %s", sqlite3_errmsg(sqlite3_db_handle(stmt_obj->stmt)));
1420
zval_dtor(return_value);
1428
/* {{{ proto int SQLite3Stmt::__construct(SQLite3 dbobject, String Statement)
1429
__constructor for SQLite3Stmt. */
1430
PHP_METHOD(sqlite3stmt, __construct)
1432
php_sqlite3_stmt *stmt_obj;
1433
php_sqlite3_db_object *db_obj;
1434
zval *object = getThis();
1437
int sql_len, errcode;
1438
zend_error_handling error_handling;
1439
php_sqlite3_free_list *free_item;
1441
stmt_obj = (php_sqlite3_stmt *)zend_object_store_get_object(object TSRMLS_CC);
1442
zend_replace_error_handling(EH_THROW, NULL, &error_handling TSRMLS_CC);
1444
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "Os", &db_zval, php_sqlite3_sc_entry, &sql, &sql_len) == FAILURE) {
1445
zend_restore_error_handling(&error_handling TSRMLS_CC);
1449
db_obj = (php_sqlite3_db_object *)zend_object_store_get_object(db_zval TSRMLS_CC);
1451
SQLITE3_CHECK_INITIALIZED(db_obj, db_obj->initialised, SQLite3)
1453
zend_restore_error_handling(&error_handling TSRMLS_CC);
1459
stmt_obj->db_obj = db_obj;
1460
stmt_obj->db_obj_zval = db_zval;
1462
Z_ADDREF_P(db_zval);
1464
errcode = sqlite3_prepare_v2(db_obj->db, sql, sql_len, &(stmt_obj->stmt), NULL);
1465
if (errcode != SQLITE_OK) {
1466
php_sqlite3_error(db_obj, "Unable to prepare statement: %d, %s", errcode, sqlite3_errmsg(db_obj->db));
1467
zval_dtor(return_value);
1470
stmt_obj->initialised = 1;
1472
free_item = emalloc(sizeof(php_sqlite3_free_list));
1473
free_item->stmt_obj = stmt_obj;
1474
free_item->stmt_obj_zval = getThis();
1476
zend_llist_add_element(&(db_obj->free_list), &free_item);
1480
/* {{{ proto int SQLite3Result::numColumns()
1481
Number of columns in the result set. */
1482
PHP_METHOD(sqlite3result, numColumns)
1484
php_sqlite3_result *result_obj;
1485
zval *object = getThis();
1486
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1488
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1490
if (zend_parse_parameters_none() == FAILURE) {
1494
RETURN_LONG(sqlite3_column_count(result_obj->stmt_obj->stmt));
1498
/* {{{ proto string SQLite3Result::columnName(int column)
1499
Returns the name of the nth column. */
1500
PHP_METHOD(sqlite3result, columnName)
1502
php_sqlite3_result *result_obj;
1503
zval *object = getThis();
1505
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1507
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1509
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &column) == FAILURE) {
1513
RETVAL_STRING((char*)sqlite3_column_name(result_obj->stmt_obj->stmt, column), 1);
1517
/* {{{ proto int SQLite3Result::columnType(int column)
1518
Returns the type of the nth column. */
1519
PHP_METHOD(sqlite3result, columnType)
1521
php_sqlite3_result *result_obj;
1522
zval *object = getThis();
1524
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1526
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1528
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &column) == FAILURE) {
1532
RETURN_LONG(sqlite3_column_type(result_obj->stmt_obj->stmt, column));
1536
/* {{{ proto array SQLite3Result::fetchArray([int mode])
1537
Fetch a result row as both an associative or numerically indexed array or both. */
1538
PHP_METHOD(sqlite3result, fetchArray)
1540
php_sqlite3_result *result_obj;
1541
zval *object = getThis();
1543
long mode = PHP_SQLITE3_BOTH;
1544
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1546
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1548
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &mode) == FAILURE) {
1552
ret = sqlite3_step(result_obj->stmt_obj->stmt);
1555
/* If there was no return value then just skip fetching */
1556
if (!return_value_used) {
1560
array_init(return_value);
1562
for (i = 0; i < sqlite3_data_count(result_obj->stmt_obj->stmt); i++) {
1565
data = sqlite_value_to_zval(result_obj->stmt_obj->stmt, i);
1567
if (mode & PHP_SQLITE3_NUM) {
1568
add_index_zval(return_value, i, data);
1571
if (mode & PHP_SQLITE3_ASSOC) {
1572
if (mode & PHP_SQLITE3_NUM) {
1575
add_assoc_zval(return_value, (char*)sqlite3_column_name(result_obj->stmt_obj->stmt, i), data);
1585
php_sqlite3_error(result_obj->db_obj, "Unable to execute statement: %s", sqlite3_errmsg(sqlite3_db_handle(result_obj->stmt_obj->stmt)));
1590
/* {{{ proto bool SQLite3Result::reset()
1591
Resets the result set back to the first row. */
1592
PHP_METHOD(sqlite3result, reset)
1594
php_sqlite3_result *result_obj;
1595
zval *object = getThis();
1596
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1598
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1600
if (zend_parse_parameters_none() == FAILURE) {
1604
if (sqlite3_reset(result_obj->stmt_obj->stmt) != SQLITE_OK) {
1608
result_obj->complete = 0;
1614
/* {{{ proto bool SQLite3Result::finalize()
1615
Closes the result set. */
1616
PHP_METHOD(sqlite3result, finalize)
1618
php_sqlite3_result *result_obj;
1619
zval *object = getThis();
1620
result_obj = (php_sqlite3_result *)zend_object_store_get_object(object TSRMLS_CC);
1622
SQLITE3_CHECK_INITIALIZED(result_obj->db_obj, result_obj->stmt_obj->initialised, SQLite3Result)
1624
if (zend_parse_parameters_none() == FAILURE) {
1628
/* We need to finalize an internal statement */
1629
if (result_obj->is_prepared_statement == 0) {
1630
zend_llist_del_element(&(result_obj->db_obj->free_list), result_obj->stmt_obj_zval,
1631
(int (*)(void *, void *)) php_sqlite3_compare_stmt_zval_free);
1633
sqlite3_reset(result_obj->stmt_obj->stmt);
1640
/* {{{ proto int SQLite3Result::__construct()
1641
__constructor for SQLite3Result. */
1642
PHP_METHOD(sqlite3result, __construct)
1644
zend_throw_exception(zend_exception_get_default(TSRMLS_C), "SQLite3Result cannot be directly instantiated", 0 TSRMLS_CC);
1649
ZEND_BEGIN_ARG_INFO(arginfo_sqlite3_open, 0)
1650
ZEND_ARG_INFO(0, filename)
1651
ZEND_ARG_INFO(0, flags)
1652
ZEND_ARG_INFO(0, encryption_key)
1655
#ifndef SQLITE_OMIT_LOAD_EXTENSION
1656
ZEND_BEGIN_ARG_INFO(arginfo_sqlite3_loadextension, 0)
1657
ZEND_ARG_INFO(0, shared_library)
1661
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3_escapestring, 0, 0, 1)
1662
ZEND_ARG_INFO(0, value)
1665
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3_query, 0, 0, 1)
1666
ZEND_ARG_INFO(0, query)
1669
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3_querysingle, 0, 0, 1)
1670
ZEND_ARG_INFO(0, query)
1671
ZEND_ARG_INFO(0, entire_row)
1674
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3_createfunction, 0, 0, 2)
1675
ZEND_ARG_INFO(0, name)
1676
ZEND_ARG_INFO(0, callback)
1677
ZEND_ARG_INFO(0, argument_count)
1680
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3_createaggregate, 0, 0, 3)
1681
ZEND_ARG_INFO(0, name)
1682
ZEND_ARG_INFO(0, step_callback)
1683
ZEND_ARG_INFO(0, final_callback)
1684
ZEND_ARG_INFO(0, argument_count)
1687
ZEND_BEGIN_ARG_INFO_EX(argingo_sqlite3_openblob, 0, 0, 3)
1688
ZEND_ARG_INFO(0, table)
1689
ZEND_ARG_INFO(0, column)
1690
ZEND_ARG_INFO(0, rowid)
1691
ZEND_ARG_INFO(0, dbname)
1694
ZEND_BEGIN_ARG_INFO_EX(argingo_sqlite3_enableexceptions, 0, 0, 1)
1695
ZEND_ARG_INFO(0, enableExceptions)
1698
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3stmt_bindparam, 0, 0, 2)
1699
ZEND_ARG_INFO(0, param_number)
1700
ZEND_ARG_INFO(1, param)
1701
ZEND_ARG_INFO(0, type)
1704
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3stmt_bindvalue, 0, 0, 2)
1705
ZEND_ARG_INFO(0, param_number)
1706
ZEND_ARG_INFO(0, param)
1707
ZEND_ARG_INFO(0, type)
1710
ZEND_BEGIN_ARG_INFO(arginfo_sqlite3stmt_construct, 1)
1711
ZEND_ARG_INFO(0, sqlite3)
1714
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3result_columnname, 0, 0, 1)
1715
ZEND_ARG_INFO(0, column_number)
1718
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3result_columntype, 0, 0, 1)
1719
ZEND_ARG_INFO(0, column_number)
1722
ZEND_BEGIN_ARG_INFO_EX(arginfo_sqlite3result_fetcharray, 0, 0, 1)
1723
ZEND_ARG_INFO(0, mode)
1726
ZEND_BEGIN_ARG_INFO(arginfo_sqlite3_void, 0)
1730
/* {{{ php_sqlite3_class_methods */
1731
static zend_function_entry php_sqlite3_class_methods[] = {
1732
PHP_ME(sqlite3, open, arginfo_sqlite3_open, ZEND_ACC_PUBLIC)
1733
PHP_ME(sqlite3, close, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1734
PHP_ME(sqlite3, exec, arginfo_sqlite3_query, ZEND_ACC_PUBLIC)
1735
PHP_ME(sqlite3, version, arginfo_sqlite3_void, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
1736
PHP_ME(sqlite3, lastInsertRowID, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1737
PHP_ME(sqlite3, lastErrorCode, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1738
PHP_ME(sqlite3, lastErrorMsg, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1739
#ifndef SQLITE_OMIT_LOAD_EXTENSION
1740
PHP_ME(sqlite3, loadExtension, arginfo_sqlite3_loadextension, ZEND_ACC_PUBLIC)
1742
PHP_ME(sqlite3, changes, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1743
PHP_ME(sqlite3, escapeString, arginfo_sqlite3_escapestring, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
1744
PHP_ME(sqlite3, prepare, arginfo_sqlite3_query, ZEND_ACC_PUBLIC)
1745
PHP_ME(sqlite3, query, arginfo_sqlite3_query, ZEND_ACC_PUBLIC)
1746
PHP_ME(sqlite3, querySingle, arginfo_sqlite3_querysingle, ZEND_ACC_PUBLIC)
1747
PHP_ME(sqlite3, createFunction, arginfo_sqlite3_createfunction, ZEND_ACC_PUBLIC)
1748
PHP_ME(sqlite3, createAggregate, arginfo_sqlite3_createaggregate, ZEND_ACC_PUBLIC)
1749
PHP_ME(sqlite3, openBlob, argingo_sqlite3_openblob, ZEND_ACC_PUBLIC)
1750
PHP_ME(sqlite3, enableExceptions, argingo_sqlite3_enableexceptions, ZEND_ACC_PUBLIC)
1752
PHP_MALIAS(sqlite3, __construct, open, arginfo_sqlite3_open, ZEND_ACC_PUBLIC|ZEND_ACC_CTOR)
1757
/* {{{ php_sqlite3_stmt_class_methods */
1758
static zend_function_entry php_sqlite3_stmt_class_methods[] = {
1759
PHP_ME(sqlite3stmt, paramCount, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1760
PHP_ME(sqlite3stmt, close, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1761
PHP_ME(sqlite3stmt, reset, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1762
PHP_ME(sqlite3stmt, clear, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1763
PHP_ME(sqlite3stmt, execute, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1764
PHP_ME(sqlite3stmt, bindParam, arginfo_sqlite3stmt_bindparam, ZEND_ACC_PUBLIC)
1765
PHP_ME(sqlite3stmt, bindValue, arginfo_sqlite3stmt_bindvalue, ZEND_ACC_PUBLIC)
1766
PHP_ME(sqlite3stmt, __construct, arginfo_sqlite3stmt_construct, ZEND_ACC_PRIVATE|ZEND_ACC_CTOR)
1771
/* {{{ php_sqlite3_result_class_methods */
1772
static zend_function_entry php_sqlite3_result_class_methods[] = {
1773
PHP_ME(sqlite3result, numColumns, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1774
PHP_ME(sqlite3result, columnName, arginfo_sqlite3result_columnname, ZEND_ACC_PUBLIC)
1775
PHP_ME(sqlite3result, columnType, arginfo_sqlite3result_columntype, ZEND_ACC_PUBLIC)
1776
PHP_ME(sqlite3result, fetchArray, arginfo_sqlite3result_fetcharray, ZEND_ACC_PUBLIC)
1777
PHP_ME(sqlite3result, reset, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1778
PHP_ME(sqlite3result, finalize, arginfo_sqlite3_void, ZEND_ACC_PUBLIC)
1779
PHP_ME(sqlite3result, __construct, arginfo_sqlite3_void, ZEND_ACC_PRIVATE|ZEND_ACC_CTOR)
1784
/* {{{ Authorization Callback
1786
static int php_sqlite3_authorizer(void *autharg, int access_type, const char *arg3, const char *arg4, const char *arg5, const char *arg6)
1789
switch (access_type) {
1792
if (strncmp(arg3, ":memory:", sizeof(":memory:")-1)) {
1793
if (PG(safe_mode) && (!php_checkuid(arg3, NULL, CHECKUID_CHECK_FILE_AND_DIR))) {
1796
if (php_check_open_basedir(arg3 TSRMLS_CC)) {
1804
/* access allowed */
1810
/* {{{ php_sqlite3_free_list_dtor
1812
static void php_sqlite3_free_list_dtor(void **item)
1814
php_sqlite3_free_list *free_item = (php_sqlite3_free_list *)*item;
1816
if (free_item->stmt_obj && free_item->stmt_obj->initialised) {
1817
sqlite3_finalize(free_item->stmt_obj->stmt);
1818
free_item->stmt_obj->initialised = 0;
1824
static int php_sqlite3_compare_stmt_zval_free( php_sqlite3_free_list **free_list, zval *statement ) /* {{{ */
1826
return ((*free_list)->stmt_obj->initialised && statement == (*free_list)->stmt_obj_zval);
1830
static int php_sqlite3_compare_stmt_free( php_sqlite3_free_list **free_list, sqlite3_stmt *statement ) /* {{{ */
1832
return ((*free_list)->stmt_obj->initialised && statement == (*free_list)->stmt_obj->stmt);
1836
static void php_sqlite3_object_free_storage(void *object TSRMLS_DC) /* {{{ */
1838
php_sqlite3_db_object *intern = (php_sqlite3_db_object *)object;
1839
php_sqlite3_func *func;
1845
while (intern->funcs) {
1846
func = intern->funcs;
1847
intern->funcs = func->next;
1848
if (intern->initialised && intern->db) {
1849
sqlite3_create_function(intern->db, func->func_name, func->argc, SQLITE_UTF8, func, NULL, NULL, NULL);
1852
efree((char*)func->func_name);
1855
zval_ptr_dtor(&func->func);
1858
zval_ptr_dtor(&func->step);
1861
zval_ptr_dtor(&func->fini);
1866
if (intern->initialised && intern->db) {
1867
sqlite3_close(intern->db);
1868
intern->initialised = 0;
1871
zend_object_std_dtor(&intern->zo TSRMLS_CC);
1876
static void php_sqlite3_stmt_object_free_storage(void *object TSRMLS_DC) /* {{{ */
1878
php_sqlite3_stmt *intern = (php_sqlite3_stmt *)object;
1884
if (intern->bound_params) {
1885
zend_hash_destroy(intern->bound_params);
1886
FREE_HASHTABLE(intern->bound_params);
1887
intern->bound_params = NULL;
1890
if (intern->initialised) {
1891
zend_llist_del_element(&(intern->db_obj->free_list), intern->stmt,
1892
(int (*)(void *, void *)) php_sqlite3_compare_stmt_free);
1895
if (intern->db_obj_zval) {
1896
Z_DELREF_P(intern->db_obj_zval);
1899
zend_object_std_dtor(&intern->zo TSRMLS_CC);
1904
static void php_sqlite3_result_object_free_storage(void *object TSRMLS_DC) /* {{{ */
1906
php_sqlite3_result *intern = (php_sqlite3_result *)object;
1912
if (intern->stmt_obj_zval) {
1913
if (intern->stmt_obj->initialised) {
1914
sqlite3_reset(intern->stmt_obj->stmt);
1917
if (intern->is_prepared_statement == 0) {
1918
zval_dtor(intern->stmt_obj_zval);
1919
FREE_ZVAL(intern->stmt_obj_zval);
1921
zval_ptr_dtor(&intern->stmt_obj_zval);
1925
zend_object_std_dtor(&intern->zo TSRMLS_CC);
1930
static zend_object_value php_sqlite3_object_new(zend_class_entry *class_type TSRMLS_DC) /* {{{ */
1933
zend_object_value retval;
1934
php_sqlite3_db_object *intern;
1936
/* Allocate memory for it */
1937
intern = emalloc(sizeof(php_sqlite3_db_object));
1938
memset(&intern->zo, 0, sizeof(php_sqlite3_db_object));
1939
intern->exception = 0;
1941
/* Need to keep track of things to free */
1942
zend_llist_init(&(intern->free_list), sizeof(php_sqlite3_free_list *), (llist_dtor_func_t)php_sqlite3_free_list_dtor, 0);
1944
zend_object_std_init(&intern->zo, class_type TSRMLS_CC);
1945
zend_hash_copy(intern->zo.properties, &class_type->default_properties, (copy_ctor_func_t) zval_add_ref,(void *) &tmp, sizeof(zval *));
1947
retval.handle = zend_objects_store_put(intern, NULL, (zend_objects_free_object_storage_t) php_sqlite3_object_free_storage, NULL TSRMLS_CC);
1948
retval.handlers = (zend_object_handlers *) &sqlite3_object_handlers;
1954
static zend_object_value php_sqlite3_stmt_object_new(zend_class_entry *class_type TSRMLS_DC) /* {{{ */
1957
zend_object_value retval;
1958
php_sqlite3_stmt *intern;
1960
/* Allocate memory for it */
1961
intern = emalloc(sizeof(php_sqlite3_stmt));
1962
memset(&intern->zo, 0, sizeof(php_sqlite3_stmt));
1964
intern->db_obj_zval = NULL;
1966
zend_object_std_init(&intern->zo, class_type TSRMLS_CC);
1967
zend_hash_copy(intern->zo.properties, &class_type->default_properties, (copy_ctor_func_t) zval_add_ref,(void *) &tmp, sizeof(zval *));
1969
retval.handle = zend_objects_store_put(intern, NULL, (zend_objects_free_object_storage_t) php_sqlite3_stmt_object_free_storage, NULL TSRMLS_CC);
1970
retval.handlers = (zend_object_handlers *) &sqlite3_stmt_object_handlers;
1976
static zend_object_value php_sqlite3_result_object_new(zend_class_entry *class_type TSRMLS_DC) /* {{{ */
1979
zend_object_value retval;
1980
php_sqlite3_result *intern;
1982
/* Allocate memory for it */
1983
intern = emalloc(sizeof(php_sqlite3_result));
1984
memset(&intern->zo, 0, sizeof(php_sqlite3_result));
1986
intern->complete = 0;
1987
intern->is_prepared_statement = 0;
1988
intern->stmt_obj_zval = NULL;
1990
zend_object_std_init(&intern->zo, class_type TSRMLS_CC);
1991
zend_hash_copy(intern->zo.properties, &class_type->default_properties, (copy_ctor_func_t) zval_add_ref,(void *) &tmp, sizeof(zval *));
1993
retval.handle = zend_objects_store_put(intern, NULL, (zend_objects_free_object_storage_t) php_sqlite3_result_object_free_storage, NULL TSRMLS_CC);
1994
retval.handlers = (zend_object_handlers *) &sqlite3_result_object_handlers;
2000
static void sqlite3_param_dtor(void *data) /* {{{ */
2002
struct php_sqlite3_bound_param *param = (struct php_sqlite3_bound_param*)data;
2008
if (param->parameter) {
2009
zval_ptr_dtor(&(param->parameter));
2010
param->parameter = NULL;
2015
/* {{{ PHP_MINIT_FUNCTION
2017
PHP_MINIT_FUNCTION(sqlite3)
2019
zend_class_entry ce;
2022
/* Refuse to load if this wasn't a threasafe library loaded */
2023
if (!sqlite3_threadsafe()) {
2024
php_error_docref(NULL TSRMLS_CC, E_WARNING, "A thread safe version of SQLite is required when using a thread safe version of PHP.");
2029
memcpy(&sqlite3_object_handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers));
2030
memcpy(&sqlite3_stmt_object_handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers));
2031
memcpy(&sqlite3_result_object_handlers, zend_get_std_object_handlers(), sizeof(zend_object_handlers));
2033
/* Register SQLite 3 Class */
2034
INIT_CLASS_ENTRY(ce, "SQLite3", php_sqlite3_class_methods);
2035
ce.create_object = php_sqlite3_object_new;
2036
sqlite3_object_handlers.clone_obj = NULL;
2037
php_sqlite3_sc_entry = zend_register_internal_class(&ce TSRMLS_CC);
2039
/* Register SQLite 3 Prepared Statement Class */
2040
INIT_CLASS_ENTRY(ce, "SQLite3Stmt", php_sqlite3_stmt_class_methods);
2041
ce.create_object = php_sqlite3_stmt_object_new;
2042
sqlite3_stmt_object_handlers.clone_obj = NULL;
2043
php_sqlite3_stmt_entry = zend_register_internal_class(&ce TSRMLS_CC);
2045
/* Register SQLite 3 Result Class */
2046
INIT_CLASS_ENTRY(ce, "SQLite3Result", php_sqlite3_result_class_methods);
2047
ce.create_object = php_sqlite3_result_object_new;
2048
sqlite3_result_object_handlers.clone_obj = NULL;
2049
php_sqlite3_result_entry = zend_register_internal_class(&ce TSRMLS_CC);
2051
REGISTER_INI_ENTRIES();
2053
REGISTER_LONG_CONSTANT("SQLITE3_ASSOC", PHP_SQLITE3_ASSOC, CONST_CS | CONST_PERSISTENT);
2054
REGISTER_LONG_CONSTANT("SQLITE3_NUM", PHP_SQLITE3_NUM, CONST_CS | CONST_PERSISTENT);
2055
REGISTER_LONG_CONSTANT("SQLITE3_BOTH", PHP_SQLITE3_BOTH, CONST_CS | CONST_PERSISTENT);
2057
REGISTER_LONG_CONSTANT("SQLITE3_INTEGER", SQLITE_INTEGER, CONST_CS | CONST_PERSISTENT);
2058
REGISTER_LONG_CONSTANT("SQLITE3_FLOAT", SQLITE_FLOAT, CONST_CS | CONST_PERSISTENT);
2059
REGISTER_LONG_CONSTANT("SQLITE3_TEXT", SQLITE3_TEXT, CONST_CS | CONST_PERSISTENT);
2060
REGISTER_LONG_CONSTANT("SQLITE3_BLOB", SQLITE_BLOB, CONST_CS | CONST_PERSISTENT);
2061
REGISTER_LONG_CONSTANT("SQLITE3_NULL", SQLITE_NULL, CONST_CS | CONST_PERSISTENT);
2063
REGISTER_LONG_CONSTANT("SQLITE3_OPEN_READONLY", SQLITE_OPEN_READONLY, CONST_CS | CONST_PERSISTENT);
2064
REGISTER_LONG_CONSTANT("SQLITE3_OPEN_READWRITE", SQLITE_OPEN_READWRITE, CONST_CS | CONST_PERSISTENT);
2065
REGISTER_LONG_CONSTANT("SQLITE3_OPEN_CREATE", SQLITE_OPEN_CREATE, CONST_CS | CONST_PERSISTENT);
2071
/* {{{ PHP_MSHUTDOWN_FUNCTION
2073
PHP_MSHUTDOWN_FUNCTION(sqlite3)
2075
UNREGISTER_INI_ENTRIES();
2081
/* {{{ PHP_MINFO_FUNCTION
2083
PHP_MINFO_FUNCTION(sqlite3)
2085
php_info_print_table_start();
2086
php_info_print_table_header(2, "SQLite3 support", "enabled");
2087
php_info_print_table_row(2, "SQLite3 module version", PHP_SQLITE3_VERSION);
2088
php_info_print_table_row(2, "SQLite Library", sqlite3_libversion());
2089
php_info_print_table_end();
2091
DISPLAY_INI_ENTRIES();
2095
/* {{{ PHP_GINIT_FUNCTION
2097
static PHP_GINIT_FUNCTION(sqlite3)
2099
memset(sqlite3_globals, 0, sizeof(*sqlite3_globals));
2103
/* {{{ sqlite3_module_entry
2105
zend_module_entry sqlite3_module_entry = {
2106
STANDARD_MODULE_HEADER,
2110
PHP_MSHUTDOWN(sqlite3),
2114
PHP_SQLITE3_VERSION,
2115
PHP_MODULE_GLOBALS(sqlite3),
2119
STANDARD_MODULE_PROPERTIES_EX
2123
#ifdef COMPILE_DL_SQLITE3
2124
ZEND_GET_MODULE(sqlite3)
2132
* vim600: sw=4 ts=4 fdm=marker
2133
* vim<600: sw=4 ts=4