1/*
2   +----------------------------------------------------------------------+
3   | PHP Version 7                                                        |
4   +----------------------------------------------------------------------+
5   | Copyright (c) 1997-2014 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: Ard Biesheuvel <a.k.biesheuvel@its.tudelft.nl>              |
16   +----------------------------------------------------------------------+
17 */
18
19#ifdef HAVE_CONFIG_H
20#include "config.h"
21#endif
22
23#include "php.h"
24#include "php_ini.h"
25
26#if HAVE_IBASE
27
28#include "ext/standard/php_standard.h"
29#include "php_interbase.h"
30#include "php_ibase_includes.h"
31
32#define ISC_LONG_MIN    INT_MIN
33#define ISC_LONG_MAX    INT_MAX
34
35#define QUERY_RESULT    1
36#define EXECUTE_RESULT  2
37
38#define FETCH_ROW       1
39#define FETCH_ARRAY     2
40
41typedef struct {
42    ISC_ARRAY_DESC ar_desc;
43    ISC_LONG ar_size; /* size of entire array in bytes */
44    unsigned short el_type, el_size;
45} ibase_array;
46
47typedef struct {
48    ibase_db_link *link;
49    ibase_trans *trans;
50    struct _ib_query *query;
51    isc_stmt_handle stmt;
52    unsigned short type;
53    unsigned char has_more_rows, statement_type;
54    XSQLDA *out_sqlda;
55    ibase_array out_array[1]; /* last member */
56} ibase_result;
57
58typedef struct _ib_query {
59    ibase_db_link *link;
60    ibase_trans *trans;
61    ibase_result *result;
62    int result_res_id;
63    isc_stmt_handle stmt;
64    XSQLDA *in_sqlda, *out_sqlda;
65    ibase_array *in_array, *out_array;
66    unsigned short in_array_cnt, out_array_cnt;
67    unsigned short dialect;
68    char statement_type;
69    char *query;
70    long trans_res_id;
71} ibase_query;
72
73typedef struct {
74    unsigned short vary_length;
75    char vary_string[1];
76} IBVARY;
77
78/* sql variables union
79 * used for convert and binding input variables
80 */
81typedef struct {
82    union {
83        short sval;
84        float fval;
85        ISC_LONG lval;
86        ISC_QUAD qval;
87        ISC_TIMESTAMP tsval;
88        ISC_DATE dtval;
89        ISC_TIME tmval;
90    } val;
91    short sqlind;
92} BIND_BUF;
93
94static int le_result, le_query;
95
96#define LE_RESULT "Firebird/InterBase result"
97#define LE_QUERY "Firebird/InterBase query"
98
99static void _php_ibase_free_xsqlda(XSQLDA *sqlda) /* {{{ */
100{
101    int i;
102    XSQLVAR *var;
103
104    IBDEBUG("Free XSQLDA?");
105    if (sqlda) {
106        IBDEBUG("Freeing XSQLDA...");
107        var = sqlda->sqlvar;
108        for (i = 0; i < sqlda->sqld; i++, var++) {
109            efree(var->sqldata);
110            if (var->sqlind) {
111                efree(var->sqlind);
112            }
113        }
114        efree(sqlda);
115    }
116}
117/* }}} */
118
119static void _php_ibase_free_stmt_handle(ibase_db_link *link, isc_stmt_handle stmt) /* {{{ */
120{
121    static char info[] = { isc_info_base_level, isc_info_end };
122
123    if (stmt) {
124        char res_buf[8];
125        IBDEBUG("Dropping statement handle (free_stmt_handle)...");
126        /* Only free statement if db-connection is still open */
127        if (SUCCESS == isc_database_info(IB_STATUS, &link->handle,
128                            sizeof(info), info, sizeof(res_buf), res_buf)) {
129            if (isc_dsql_free_statement(IB_STATUS, &stmt, DSQL_drop)) {
130                _php_ibase_error();
131            }
132        }
133    }
134}
135/* }}} */
136
137static void _php_ibase_free_result(zend_resource *rsrc) /* {{{ */
138{
139    ibase_result *ib_result = (ibase_result *) rsrc->ptr;
140
141    IBDEBUG("Freeing result by dtor...");
142    if (ib_result) {
143        _php_ibase_free_xsqlda(ib_result->out_sqlda);
144        if (ib_result->query != NULL) {
145            IBDEBUG("query still valid; don't drop statement handle");
146            ib_result->query->result = NULL;    /* Indicate to query, that result is released */
147        } else {
148            _php_ibase_free_stmt_handle(ib_result->link, ib_result->stmt);
149        }
150        efree(ib_result);
151    }
152}
153/* }}} */
154
155static void _php_ibase_free_query(ibase_query *ib_query) /* {{{ */
156{
157    IBDEBUG("Freeing query...");
158
159    if (ib_query->in_sqlda) {
160        efree(ib_query->in_sqlda);
161    }
162    if (ib_query->out_sqlda) {
163        efree(ib_query->out_sqlda);
164    }
165    if (ib_query->result != NULL) {
166        IBDEBUG("result still valid; don't drop statement handle");
167        ib_query->result->query = NULL; /* Indicate to result, that query is released */
168    } else {
169        _php_ibase_free_stmt_handle(ib_query->link, ib_query->stmt);
170    }
171    if (ib_query->in_array) {
172        efree(ib_query->in_array);
173    }
174    if (ib_query->out_array) {
175        efree(ib_query->out_array);
176    }
177    if (ib_query->query) {
178        efree(ib_query->query);
179    }
180}
181/* }}} */
182
183static void php_ibase_free_query_rsrc(zend_resource *rsrc) /* {{{ */
184{
185    ibase_query *ib_query = (ibase_query *)rsrc->ptr;
186
187    if (ib_query != NULL) {
188        IBDEBUG("Preparing to free query by dtor...");
189        _php_ibase_free_query(ib_query);
190        efree(ib_query);
191    }
192}
193/* }}} */
194
195void php_ibase_query_minit(INIT_FUNC_ARGS) /* {{{ */
196{
197    le_result = zend_register_list_destructors_ex(_php_ibase_free_result, NULL,
198        "interbase result", module_number);
199    le_query = zend_register_list_destructors_ex(php_ibase_free_query_rsrc, NULL,
200        "interbase query", module_number);
201}
202/* }}} */
203
204static int _php_ibase_alloc_array(ibase_array **ib_arrayp, XSQLDA *sqlda, /* {{{ */
205    isc_db_handle link, isc_tr_handle trans, unsigned short *array_cnt)
206{
207    unsigned short i, n;
208    ibase_array *ar;
209
210    /* first check if we have any arrays at all */
211    for (i = *array_cnt = 0; i < sqlda->sqld; ++i) {
212        if ((sqlda->sqlvar[i].sqltype & ~1) == SQL_ARRAY) {
213            ++*array_cnt;
214        }
215    }
216    if (! *array_cnt) return SUCCESS;
217
218    ar = safe_emalloc(sizeof(ibase_array), *array_cnt, 0);
219
220    for (i = n = 0; i < sqlda->sqld; ++i) {
221        unsigned short dim;
222        unsigned long ar_size = 1;
223        XSQLVAR *var = &sqlda->sqlvar[i];
224
225        if ((var->sqltype & ~1) == SQL_ARRAY) {
226            ibase_array *a = &ar[n++];
227            ISC_ARRAY_DESC *ar_desc = &a->ar_desc;
228
229            if (isc_array_lookup_bounds(IB_STATUS, &link, &trans, var->relname,
230                    var->sqlname, ar_desc)) {
231                _php_ibase_error();
232                efree(ar);
233                return FAILURE;
234            }
235
236            switch (ar_desc->array_desc_dtype) {
237                case blr_text:
238                case blr_text2:
239                    a->el_type = SQL_TEXT;
240                    a->el_size = ar_desc->array_desc_length;
241                    break;
242                case blr_short:
243                    a->el_type = SQL_SHORT;
244                    a->el_size = sizeof(short);
245                    break;
246                case blr_long:
247                    a->el_type = SQL_LONG;
248                    a->el_size = sizeof(ISC_LONG);
249                    break;
250                case blr_float:
251                    a->el_type = SQL_FLOAT;
252                    a->el_size = sizeof(float);
253                    break;
254                case blr_double:
255                    a->el_type = SQL_DOUBLE;
256                    a->el_size = sizeof(double);
257                    break;
258                case blr_int64:
259                    a->el_type = SQL_INT64;
260                    a->el_size = sizeof(ISC_INT64);
261                    break;
262                case blr_timestamp:
263                    a->el_type = SQL_TIMESTAMP;
264                    a->el_size = sizeof(ISC_TIMESTAMP);
265                    break;
266                case blr_sql_date:
267                    a->el_type = SQL_TYPE_DATE;
268                    a->el_size = sizeof(ISC_DATE);
269                    break;
270                case blr_sql_time:
271                    a->el_type = SQL_TYPE_TIME;
272                    a->el_size = sizeof(ISC_TIME);
273                    break;
274                case blr_varying:
275                case blr_varying2:
276                    /**
277                     * IB has a strange way of handling VARCHAR arrays. It doesn't store
278                     * the length in the first short, as with VARCHAR fields. It does,
279                     * however, expect the extra short to be allocated for each element.
280                     */
281                    a->el_type = SQL_TEXT;
282                    a->el_size = ar_desc->array_desc_length + sizeof(short);
283                    break;
284                case blr_quad:
285                case blr_blob_id:
286                case blr_cstring:
287                case blr_cstring2:
288                    /**
289                     * These types are mentioned as array types in the manual, but I
290                     * wouldn't know how to create an array field with any of these
291                     * types. I assume these types are not applicable to arrays, and
292                     * were mentioned erroneously.
293                     */
294                default:
295                    _php_ibase_module_error("Unsupported array type %d in relation '%s' column '%s'"
296                        TSRMLS_CC, ar_desc->array_desc_dtype, var->relname, var->sqlname);
297                    efree(ar);
298                    return FAILURE;
299            } /* switch array_desc_type */
300
301            /* calculate elements count */
302            for (dim = 0; dim < ar_desc->array_desc_dimensions; dim++) {
303                ar_size *= 1 + ar_desc->array_desc_bounds[dim].array_bound_upper
304                    -ar_desc->array_desc_bounds[dim].array_bound_lower;
305            }
306            a->ar_size = a->el_size * ar_size;
307        } /* if SQL_ARRAY */
308    } /* for column */
309    *ib_arrayp = ar;
310    return SUCCESS;
311}
312/* }}} */
313
314/* allocate and prepare query */
315static int _php_ibase_alloc_query(ibase_query *ib_query, ibase_db_link *link, /* {{{ */
316    ibase_trans *trans, char *query, unsigned short dialect, int trans_res_id)
317{
318    static char info_type[] = {isc_info_sql_stmt_type};
319    char result[8];
320
321    /* Return FAILURE, if querystring is empty */
322    if (*query == '\0') {
323        php_error_docref(NULL, E_WARNING, "Querystring empty.");
324        return FAILURE;
325    }
326
327    ib_query->link = link;
328    ib_query->trans = trans;
329    ib_query->result_res_id = 0;
330    ib_query->result = NULL;
331    ib_query->stmt = NULL;
332    ib_query->in_array = NULL;
333    ib_query->out_array = NULL;
334    ib_query->dialect = dialect;
335    ib_query->query = estrdup(query);
336    ib_query->trans_res_id = trans_res_id;
337    ib_query->out_sqlda = NULL;
338    ib_query->in_sqlda = NULL;
339
340    if (isc_dsql_allocate_statement(IB_STATUS, &link->handle, &ib_query->stmt)) {
341        _php_ibase_error();
342        goto _php_ibase_alloc_query_error;
343    }
344
345    ib_query->out_sqlda = (XSQLDA *) emalloc(XSQLDA_LENGTH(1));
346    ib_query->out_sqlda->sqln = 1;
347    ib_query->out_sqlda->version = SQLDA_CURRENT_VERSION;
348
349    if (isc_dsql_prepare(IB_STATUS, &ib_query->trans->handle, &ib_query->stmt,
350            0, query, dialect, ib_query->out_sqlda)) {
351        _php_ibase_error();
352        goto _php_ibase_alloc_query_error;
353    }
354
355    /* find out what kind of statement was prepared */
356    if (isc_dsql_sql_info(IB_STATUS, &ib_query->stmt, sizeof(info_type),
357            info_type, sizeof(result), result)) {
358        _php_ibase_error();
359        goto _php_ibase_alloc_query_error;
360    }
361    ib_query->statement_type = result[3];
362
363    /* not enough output variables ? */
364    if (ib_query->out_sqlda->sqld > ib_query->out_sqlda->sqln) {
365        ib_query->out_sqlda = erealloc(ib_query->out_sqlda, XSQLDA_LENGTH(ib_query->out_sqlda->sqld));
366        ib_query->out_sqlda->sqln = ib_query->out_sqlda->sqld;
367        ib_query->out_sqlda->version = SQLDA_CURRENT_VERSION;
368        if (isc_dsql_describe(IB_STATUS, &ib_query->stmt, SQLDA_CURRENT_VERSION, ib_query->out_sqlda)) {
369            _php_ibase_error();
370            goto _php_ibase_alloc_query_error;
371        }
372    }
373
374    /* maybe have input placeholders? */
375    ib_query->in_sqlda = emalloc(XSQLDA_LENGTH(1));
376    ib_query->in_sqlda->sqln = 1;
377    ib_query->in_sqlda->version = SQLDA_CURRENT_VERSION;
378    if (isc_dsql_describe_bind(IB_STATUS, &ib_query->stmt, SQLDA_CURRENT_VERSION, ib_query->in_sqlda)) {
379        _php_ibase_error();
380        goto _php_ibase_alloc_query_error;
381    }
382
383    /* not enough input variables ? */
384    if (ib_query->in_sqlda->sqln < ib_query->in_sqlda->sqld) {
385        ib_query->in_sqlda = erealloc(ib_query->in_sqlda, XSQLDA_LENGTH(ib_query->in_sqlda->sqld));
386        ib_query->in_sqlda->sqln = ib_query->in_sqlda->sqld;
387        ib_query->in_sqlda->version = SQLDA_CURRENT_VERSION;
388
389        if (isc_dsql_describe_bind(IB_STATUS, &ib_query->stmt,
390                SQLDA_CURRENT_VERSION, ib_query->in_sqlda)) {
391            _php_ibase_error();
392            goto _php_ibase_alloc_query_error;
393        }
394    }
395
396    /* no, haven't placeholders at all */
397    if (ib_query->in_sqlda->sqld == 0) {
398        efree(ib_query->in_sqlda);
399        ib_query->in_sqlda = NULL;
400    } else if (FAILURE == _php_ibase_alloc_array(&ib_query->in_array, ib_query->in_sqlda,
401            link->handle, trans->handle, &ib_query->in_array_cnt)) {
402        goto _php_ibase_alloc_query_error;
403    }
404
405    if (ib_query->out_sqlda->sqld == 0) {
406        efree(ib_query->out_sqlda);
407        ib_query->out_sqlda = NULL;
408    } else  if (FAILURE == _php_ibase_alloc_array(&ib_query->out_array, ib_query->out_sqlda,
409            link->handle, trans->handle, &ib_query->out_array_cnt)) {
410        goto _php_ibase_alloc_query_error;
411    }
412
413    return SUCCESS;
414
415_php_ibase_alloc_query_error:
416
417    if (ib_query->out_sqlda) {
418        efree(ib_query->out_sqlda);
419    }
420    if (ib_query->in_sqlda) {
421        efree(ib_query->in_sqlda);
422    }
423    if (ib_query->out_array) {
424        efree(ib_query->out_array);
425    }
426    if (ib_query->query) {
427        efree(ib_query->query);
428    }
429    return FAILURE;
430}
431/* }}} */
432
433static int _php_ibase_bind_array(zval *val, char *buf, unsigned long buf_size, /* {{{ */
434    ibase_array *array, int dim)
435{
436    zval null_val, *pnull_val = &null_val;
437    int u_bound = array->ar_desc.array_desc_bounds[dim].array_bound_upper,
438        l_bound = array->ar_desc.array_desc_bounds[dim].array_bound_lower,
439        dim_len = 1 + u_bound - l_bound;
440
441    ZVAL_NULL(pnull_val);
442
443    if (dim < array->ar_desc.array_desc_dimensions) {
444        unsigned long slice_size = buf_size / dim_len;
445        unsigned short i;
446        zval *subval = val;
447
448        if (Z_TYPE_P(val) == IS_ARRAY) {
449            zend_hash_internal_pointer_reset(Z_ARRVAL_P(val));
450        }
451
452        for (i = 0; i < dim_len; ++i) {
453
454            if (Z_TYPE_P(val) == IS_ARRAY &&
455                (subval = zend_hash_get_current_data(Z_ARRVAL_P(val))) == NULL)
456            {
457                subval = pnull_val;
458            }
459
460            if (_php_ibase_bind_array(subval, buf, slice_size, array, dim+1) == FAILURE)
461            {
462                return FAILURE;
463            }
464            buf += slice_size;
465
466            if (Z_TYPE_P(val) == IS_ARRAY) {
467                zend_hash_move_forward(Z_ARRVAL_P(val));
468            }
469        }
470
471        if (Z_TYPE_P(val) == IS_ARRAY) {
472            zend_hash_internal_pointer_reset(Z_ARRVAL_P(val));
473        }
474
475    } else {
476        /* expect a single value */
477        if (Z_TYPE_P(val) == IS_NULL) {
478            memset(buf, 0, buf_size);
479        } else if (array->ar_desc.array_desc_scale < 0) {
480
481            /* no coercion for array types */
482            double l;
483
484            convert_to_double(val);
485
486            if (Z_DVAL_P(val) > 0) {
487                l = Z_DVAL_P(val) * pow(10, -array->ar_desc.array_desc_scale) + .5;
488            } else {
489                l = Z_DVAL_P(val) * pow(10, -array->ar_desc.array_desc_scale) - .5;
490            }
491
492            switch (array->el_type) {
493                case SQL_SHORT:
494                    if (l > SHRT_MAX || l < SHRT_MIN) {
495                        _php_ibase_module_error("Array parameter exceeds field width");
496                        return FAILURE;
497                    }
498                    *(short*) buf = (short) l;
499                    break;
500                case SQL_LONG:
501                    if (l > ISC_LONG_MAX || l < ISC_LONG_MIN) {
502                        _php_ibase_module_error("Array parameter exceeds field width");
503                        return FAILURE;
504                    }
505                    *(ISC_LONG*) buf = (ISC_LONG) l;
506                    break;
507                case SQL_INT64:
508                    {
509                        long double l;
510
511                        convert_to_string(val);
512
513                        if (!sscanf(Z_STRVAL_P(val), "%Lf", &l)) {
514                            _php_ibase_module_error("Cannot convert '%s' to long double"
515                                TSRMLS_CC, Z_STRVAL_P(val));
516                            return FAILURE;
517                        }
518
519                        if (l > 0) {
520                            *(ISC_INT64 *) buf = (ISC_INT64) (l * pow(10,
521                                -array->ar_desc.array_desc_scale) + .5);
522                        } else {
523                            *(ISC_INT64 *) buf = (ISC_INT64) (l * pow(10,
524                                -array->ar_desc.array_desc_scale) - .5);
525                        }
526                    }
527                    break;
528            }
529        } else {
530            struct tm t = { 0, 0, 0, 0, 0, 0 };
531
532            switch (array->el_type) {
533                unsigned short n;
534                ISC_INT64 l;
535
536                case SQL_SHORT:
537                    convert_to_long(val);
538                    if (Z_LVAL_P(val) > SHRT_MAX || Z_LVAL_P(val) < SHRT_MIN) {
539                        _php_ibase_module_error("Array parameter exceeds field width");
540                        return FAILURE;
541                    }
542                    *(short *) buf = (short) Z_LVAL_P(val);
543                    break;
544                case SQL_LONG:
545                    convert_to_long(val);
546#if (SIZEOF_LONG > 4)
547                    if (Z_LVAL_P(val) > ISC_LONG_MAX || Z_LVAL_P(val) < ISC_LONG_MIN) {
548                        _php_ibase_module_error("Array parameter exceeds field width");
549                        return FAILURE;
550                    }
551#endif
552                    *(ISC_LONG *) buf = (ISC_LONG) Z_LVAL_P(val);
553                    break;
554                case SQL_INT64:
555#if (SIZEOF_LONG >= 8)
556                    convert_to_long(val);
557                    *(long *) buf = Z_LVAL_P(val);
558#else
559                    convert_to_string(val);
560                    if (!sscanf(Z_STRVAL_P(val), "%" LL_MASK "d", &l)) {
561                        _php_ibase_module_error("Cannot convert '%s' to long integer"
562                            TSRMLS_CC, Z_STRVAL_P(val));
563                        return FAILURE;
564                    } else {
565                        *(ISC_INT64 *) buf = l;
566                    }
567#endif
568                    break;
569                case SQL_FLOAT:
570                    convert_to_double(val);
571                    *(float*) buf = (float) Z_DVAL_P(val);
572                    break;
573                case SQL_DOUBLE:
574                    convert_to_double(val);
575                    *(double*) buf = Z_DVAL_P(val);
576                    break;
577                case SQL_TIMESTAMP:
578                    convert_to_string(val);
579#ifdef HAVE_STRPTIME
580                    strptime(Z_STRVAL_P(val), INI_STR("ibase.timestampformat"), &t);
581#else
582                    n = sscanf(Z_STRVAL_P(val), "%d%*[/]%d%*[/]%d %d%*[:]%d%*[:]%d",
583                        &t.tm_mon, &t.tm_mday, &t.tm_year, &t.tm_hour, &t.tm_min, &t.tm_sec);
584
585                    if (n != 3 && n != 6) {
586                        _php_ibase_module_error("Invalid date/time format (expected 3 or 6 fields, got %d."
587                            " Use format 'm/d/Y H:i:s'. You gave '%s')", n, Z_STRVAL_P(val));
588                        return FAILURE;
589                    }
590                    t.tm_year -= 1900;
591                    t.tm_mon--;
592#endif
593                    isc_encode_timestamp(&t, (ISC_TIMESTAMP * ) buf);
594                    break;
595                case SQL_TYPE_DATE:
596                    convert_to_string(val);
597#ifdef HAVE_STRPTIME
598                    strptime(Z_STRVAL_P(val), INI_STR("ibase.dateformat"), &t);
599#else
600                    n = sscanf(Z_STRVAL_P(val), "%d%*[/]%d%*[/]%d", &t.tm_mon, &t.tm_mday, &t.tm_year);
601
602                    if (n != 3) {
603                        _php_ibase_module_error("Invalid date format (expected 3 fields, got %d. "
604                            "Use format 'm/d/Y' You gave '%s')", n, Z_STRVAL_P(val));
605                        return FAILURE;
606                    }
607                    t.tm_year -= 1900;
608                    t.tm_mon--;
609#endif
610                    isc_encode_sql_date(&t, (ISC_DATE *) buf);
611                    break;
612                case SQL_TYPE_TIME:
613                    convert_to_string(val);
614#ifdef HAVE_STRPTIME
615                    strptime(Z_STRVAL_P(val), INI_STR("ibase.timeformat"), &t);
616#else
617                    n = sscanf(Z_STRVAL_P(val), "%d%*[:]%d%*[:]%d", &t.tm_hour, &t.tm_min, &t.tm_sec);
618
619                    if (n != 3) {
620                        _php_ibase_module_error("Invalid time format (expected 3 fields, got %d. "
621                            "Use format 'H:i:s'. You gave '%s')", n, Z_STRVAL_P(val));
622                        return FAILURE;
623                    }
624#endif
625                    isc_encode_sql_time(&t, (ISC_TIME *) buf);
626                    break;
627                default:
628                    convert_to_string(val);
629                    strlcpy(buf, Z_STRVAL_P(val), buf_size);
630            }
631        }
632    }
633    return SUCCESS;
634}
635/* }}} */
636
637static int _php_ibase_bind(XSQLDA *sqlda, zval *b_vars, BIND_BUF *buf, /* {{{ */
638    ibase_query *ib_query)
639{
640    int i, array_cnt = 0, rv = SUCCESS;
641
642    for (i = 0; i < sqlda->sqld; ++i) { /* bound vars */
643
644        zval *b_var = &b_vars[i];
645        XSQLVAR *var = &sqlda->sqlvar[i];
646
647        var->sqlind = &buf[i].sqlind;
648
649        /* check if a NULL should be inserted */
650        switch (Z_TYPE_P(b_var)) {
651            int force_null;
652
653            case IS_STRING:
654
655                force_null = 0;
656
657                /* for these types, an empty string can be handled like a NULL value */
658                switch (var->sqltype & ~1) {
659                    case SQL_SHORT:
660                    case SQL_LONG:
661                    case SQL_INT64:
662                    case SQL_FLOAT:
663                    case SQL_DOUBLE:
664                    case SQL_TIMESTAMP:
665                    case SQL_TYPE_DATE:
666                    case SQL_TYPE_TIME:
667                        force_null = (Z_STRLEN_P(b_var) == 0);
668                }
669
670                if (! force_null) break;
671
672            case IS_NULL:
673                    buf[i].sqlind = -1;
674
675                if (var->sqltype & SQL_ARRAY) ++array_cnt;
676
677                continue;
678        }
679
680        /* if we make it to this point, we must provide a value for the parameter */
681
682        buf[i].sqlind = 0;
683
684        var->sqldata = (void*)&buf[i].val;
685
686        switch (var->sqltype & ~1) {
687            struct tm t;
688
689            case SQL_TIMESTAMP:
690            case SQL_TYPE_DATE:
691            case SQL_TYPE_TIME:
692                if (Z_TYPE_P(b_var) == IS_LONG) {
693                    struct tm *res;
694                    res = php_gmtime_r(&Z_LVAL_P(b_var), &t);
695                    if (!res) {
696                        return FAILURE;
697                    }
698                } else {
699#ifdef HAVE_STRPTIME
700                    char *format = INI_STR("ibase.timestampformat");
701
702                    convert_to_string(b_var);
703
704                    switch (var->sqltype & ~1) {
705                        case SQL_TYPE_DATE:
706                            format = INI_STR("ibase.dateformat");
707                            break;
708                        case SQL_TYPE_TIME:
709                            format = INI_STR("ibase.timeformat");
710                    }
711                    if (!strptime(Z_STRVAL_P(b_var), format, &t)) {
712                        /* strptime() cannot handle it, so let IB have a try */
713                        break;
714                    }
715#else /* ifndef HAVE_STRPTIME */
716                    break; /* let IB parse it as a string */
717#endif
718                }
719
720                switch (var->sqltype & ~1) {
721                    default: /* == case SQL_TIMESTAMP */
722                        isc_encode_timestamp(&t, &buf[i].val.tsval);
723                        break;
724                    case SQL_TYPE_DATE:
725                        isc_encode_sql_date(&t, &buf[i].val.dtval);
726                        break;
727                    case SQL_TYPE_TIME:
728                        isc_encode_sql_time(&t, &buf[i].val.tmval);
729                        break;
730                }
731                continue;
732
733            case SQL_BLOB:
734
735                convert_to_string(b_var);
736
737                if (Z_STRLEN_P(b_var) != BLOB_ID_LEN ||
738                    !_php_ibase_string_to_quad(Z_STRVAL_P(b_var), &buf[i].val.qval)) {
739
740                    ibase_blob ib_blob = { NULL, BLOB_INPUT };
741
742                    if (isc_create_blob(IB_STATUS, &ib_query->link->handle,
743                            &ib_query->trans->handle, &ib_blob.bl_handle, &ib_blob.bl_qd)) {
744                        _php_ibase_error();
745                        return FAILURE;
746                    }
747
748                    if (_php_ibase_blob_add(b_var, &ib_blob) != SUCCESS) {
749                        return FAILURE;
750                    }
751
752                    if (isc_close_blob(IB_STATUS, &ib_blob.bl_handle)) {
753                        _php_ibase_error();
754                        return FAILURE;
755                    }
756                    buf[i].val.qval = ib_blob.bl_qd;
757                }
758                continue;
759
760            case SQL_ARRAY:
761
762                if (Z_TYPE_P(b_var) != IS_ARRAY) {
763                    convert_to_string(b_var);
764
765                    if (Z_STRLEN_P(b_var) != BLOB_ID_LEN ||
766                        !_php_ibase_string_to_quad(Z_STRVAL_P(b_var), &buf[i].val.qval)) {
767
768                        _php_ibase_module_error("Parameter %d: invalid array ID",i+1);
769                        rv = FAILURE;
770                    }
771                } else {
772                    /* convert the array data into something IB can understand */
773                    ibase_array *ar = &ib_query->in_array[array_cnt];
774                    void *array_data = emalloc(ar->ar_size);
775                    ISC_QUAD array_id = { 0, 0 };
776
777                    if (FAILURE == _php_ibase_bind_array(b_var, array_data, ar->ar_size,
778                            ar, 0)) {
779                        _php_ibase_module_error("Parameter %d: failed to bind array argument"
780                            TSRMLS_CC,i+1);
781                        efree(array_data);
782                        rv = FAILURE;
783                        continue;
784                    }
785
786                    if (isc_array_put_slice(IB_STATUS, &ib_query->link->handle, &ib_query->trans->handle,
787                            &array_id, &ar->ar_desc, array_data, &ar->ar_size)) {
788                        _php_ibase_error();
789                        efree(array_data);
790                        return FAILURE;
791                    }
792                    buf[i].val.qval = array_id;
793                    efree(array_data);
794                }
795                ++array_cnt;
796                continue;
797            } /* switch */
798
799            /* we end up here if none of the switch cases handled the field */
800            convert_to_string(b_var);
801            var->sqldata = Z_STRVAL_P(b_var);
802            var->sqllen  = Z_STRLEN_P(b_var);
803            var->sqltype = SQL_TEXT;
804    } /* for */
805    return rv;
806}
807/* }}} */
808
809static void _php_ibase_alloc_xsqlda(XSQLDA *sqlda) /* {{{ */
810{
811    int i;
812
813    for (i = 0; i < sqlda->sqld; i++) {
814        XSQLVAR *var = &sqlda->sqlvar[i];
815
816        switch (var->sqltype & ~1) {
817            case SQL_TEXT:
818                var->sqldata = safe_emalloc(sizeof(char), var->sqllen, 0);
819                break;
820            case SQL_VARYING:
821                var->sqldata = safe_emalloc(sizeof(char), var->sqllen + sizeof(short), 0);
822                break;
823            case SQL_SHORT:
824                var->sqldata = emalloc(sizeof(short));
825                break;
826            case SQL_LONG:
827                var->sqldata = emalloc(sizeof(ISC_LONG));
828                break;
829            case SQL_FLOAT:
830                var->sqldata = emalloc(sizeof(float));
831                    break;
832            case SQL_DOUBLE:
833                var->sqldata = emalloc(sizeof(double));
834                break;
835            case SQL_INT64:
836                var->sqldata = emalloc(sizeof(ISC_INT64));
837                break;
838            case SQL_TIMESTAMP:
839                var->sqldata = emalloc(sizeof(ISC_TIMESTAMP));
840                break;
841            case SQL_TYPE_DATE:
842                var->sqldata = emalloc(sizeof(ISC_DATE));
843                break;
844            case SQL_TYPE_TIME:
845                var->sqldata = emalloc(sizeof(ISC_TIME));
846                break;
847            case SQL_BLOB:
848            case SQL_ARRAY:
849                var->sqldata = emalloc(sizeof(ISC_QUAD));
850                break;
851        } /* switch */
852
853        if (var->sqltype & 1) { /* sql NULL flag */
854            var->sqlind = emalloc(sizeof(short));
855        } else {
856            var->sqlind = NULL;
857        }
858    } /* for */
859}
860/* }}} */
861
862static int _php_ibase_exec(INTERNAL_FUNCTION_PARAMETERS, ibase_result **ib_resultp, /* {{{ */
863    ibase_query *ib_query, zval *args)
864{
865    XSQLDA *in_sqlda = NULL, *out_sqlda = NULL;
866    BIND_BUF *bind_buf = NULL;
867    int i, rv = FAILURE;
868    static char info_count[] = { isc_info_sql_records };
869    char result[64];
870    ISC_STATUS isc_result;
871    int argc = ib_query->in_sqlda ? ib_query->in_sqlda->sqld : 0;
872
873    RESET_ERRMSG;
874
875    for (i = 0; i < argc; ++i) {
876        SEPARATE_ZVAL(&args[i]);
877    }
878
879    switch (ib_query->statement_type) {
880        isc_tr_handle tr;
881        ibase_tr_list **l;
882        ibase_trans *trans;
883
884        case isc_info_sql_stmt_start_trans:
885
886            /* a SET TRANSACTION statement should be executed with a NULL trans handle */
887            tr = NULL;
888
889            if (isc_dsql_execute_immediate(IB_STATUS, &ib_query->link->handle, &tr, 0,
890                    ib_query->query, ib_query->dialect, NULL)) {
891                _php_ibase_error();
892                goto _php_ibase_exec_error;
893            }
894
895            trans = (ibase_trans *) emalloc(sizeof(ibase_trans));
896            trans->handle = tr;
897            trans->link_cnt = 1;
898            trans->affected_rows = 0;
899            trans->db_link[0] = ib_query->link;
900
901            if (ib_query->link->tr_list == NULL) {
902                ib_query->link->tr_list = (ibase_tr_list *) emalloc(sizeof(ibase_tr_list));
903                ib_query->link->tr_list->trans = NULL;
904                ib_query->link->tr_list->next = NULL;
905            }
906
907            /* link the transaction into the connection-transaction list */
908            for (l = &ib_query->link->tr_list; *l != NULL; l = &(*l)->next);
909            *l = (ibase_tr_list *) emalloc(sizeof(ibase_tr_list));
910            (*l)->trans = trans;
911            (*l)->next = NULL;
912
913            ZEND_REGISTER_RESOURCE(return_value, trans, le_trans);
914            Z_ADDREF_P(return_value);
915
916            return SUCCESS;
917
918        case isc_info_sql_stmt_commit:
919        case isc_info_sql_stmt_rollback:
920
921            if (isc_dsql_execute_immediate(IB_STATUS, &ib_query->link->handle,
922                    &ib_query->trans->handle, 0, ib_query->query, ib_query->dialect, NULL)) {
923                _php_ibase_error();
924                goto _php_ibase_exec_error;
925            }
926
927            if (ib_query->trans->handle == NULL && ib_query->trans_res_id != 0) {
928                /* transaction was released by the query and was a registered resource,
929                   so we have to release it */
930                zval *res = zend_hash_index_find(&EG(regular_list), ib_query->trans_res_id);
931                zend_list_delete(Z_RES_P(res));
932            }
933
934            RETVAL_TRUE;
935
936            return SUCCESS;
937
938        default:
939            RETVAL_FALSE;
940    }
941
942    /* allocate sqlda and output buffers */
943    if (ib_query->out_sqlda) { /* output variables in select, select for update */
944        ibase_result *res;
945
946        IBDEBUG("Query wants XSQLDA for output");
947        res = emalloc(sizeof(ibase_result)+sizeof(ibase_array)*max(0,ib_query->out_array_cnt-1));
948        res->link = ib_query->link;
949        res->trans = ib_query->trans;
950        res->stmt = ib_query->stmt;
951        /* ib_result and ib_query point at each other to handle release of statement handle properly */
952        res->query = ib_query;
953        ib_query->result = res;
954        res->statement_type = ib_query->statement_type;
955        res->has_more_rows = 1;
956
957        out_sqlda = res->out_sqlda = emalloc(XSQLDA_LENGTH(ib_query->out_sqlda->sqld));
958        memcpy(out_sqlda, ib_query->out_sqlda, XSQLDA_LENGTH(ib_query->out_sqlda->sqld));
959        _php_ibase_alloc_xsqlda(out_sqlda);
960
961        if (ib_query->out_array) {
962            memcpy(&res->out_array, ib_query->out_array, sizeof(ibase_array)*ib_query->out_array_cnt);
963        }
964        *ib_resultp = res;
965    }
966
967    if (ib_query->in_sqlda) { /* has placeholders */
968        IBDEBUG("Query wants XSQLDA for input");
969        in_sqlda = emalloc(XSQLDA_LENGTH(ib_query->in_sqlda->sqld));
970        memcpy(in_sqlda, ib_query->in_sqlda, XSQLDA_LENGTH(ib_query->in_sqlda->sqld));
971        bind_buf = safe_emalloc(sizeof(BIND_BUF), ib_query->in_sqlda->sqld, 0);
972        if (_php_ibase_bind(in_sqlda, args, bind_buf, ib_query) == FAILURE) {
973            IBDEBUG("Could not bind input XSQLDA");
974            goto _php_ibase_exec_error;
975        }
976    }
977
978    if (ib_query->statement_type == isc_info_sql_stmt_exec_procedure) {
979        isc_result = isc_dsql_execute2(IB_STATUS, &ib_query->trans->handle,
980            &ib_query->stmt, SQLDA_CURRENT_VERSION, in_sqlda, out_sqlda);
981    } else {
982        isc_result = isc_dsql_execute(IB_STATUS, &ib_query->trans->handle,
983            &ib_query->stmt, SQLDA_CURRENT_VERSION, in_sqlda);
984    }
985    if (isc_result) {
986        IBDEBUG("Could not execute query");
987        _php_ibase_error();
988        goto _php_ibase_exec_error;
989    }
990    ib_query->trans->affected_rows = 0;
991
992    switch (ib_query->statement_type) {
993
994        unsigned long affected_rows;
995
996        case isc_info_sql_stmt_insert:
997        case isc_info_sql_stmt_update:
998        case isc_info_sql_stmt_delete:
999        case isc_info_sql_stmt_exec_procedure:
1000
1001            if (isc_dsql_sql_info(IB_STATUS, &ib_query->stmt, sizeof(info_count),
1002                    info_count, sizeof(result), result)) {
1003                _php_ibase_error();
1004                goto _php_ibase_exec_error;
1005            }
1006
1007            affected_rows = 0;
1008
1009            if (result[0] == isc_info_sql_records) {
1010                unsigned i = 3, result_size = isc_vax_integer(&result[1],2);
1011
1012                while (result[i] != isc_info_end && i < result_size) {
1013                    short len = (short)isc_vax_integer(&result[i+1],2);
1014                    if (result[i] != isc_info_req_select_count) {
1015                        affected_rows += isc_vax_integer(&result[i+3],len);
1016                    }
1017                    i += len+3;
1018                }
1019            }
1020
1021            ib_query->trans->affected_rows = affected_rows;
1022
1023            if (!ib_query->out_sqlda) { /* no result set is being returned */
1024                if (affected_rows) {
1025                    RETVAL_LONG(affected_rows);
1026                } else {
1027                    RETVAL_TRUE;
1028                }
1029                break;
1030            }
1031        default:
1032            RETVAL_TRUE;
1033    }
1034
1035    rv = SUCCESS;
1036
1037_php_ibase_exec_error:
1038
1039    if (in_sqlda) {
1040        efree(in_sqlda);
1041    }
1042    if (bind_buf)
1043        efree(bind_buf);
1044
1045    if (rv == FAILURE) {
1046        if (*ib_resultp) {
1047            efree(*ib_resultp);
1048            *ib_resultp = NULL;
1049        }
1050        if (out_sqlda) {
1051            _php_ibase_free_xsqlda(out_sqlda);
1052        }
1053    }
1054
1055    return rv;
1056}
1057/* }}} */
1058
1059/* {{{ proto mixed ibase_query([resource link_identifier, [ resource link_identifier, ]] string query [, mixed bind_arg [, mixed bind_arg [, ...]]])
1060   Execute a query */
1061PHP_FUNCTION(ibase_query)
1062{
1063    zval *zlink, *ztrans, *bind_args = NULL;
1064    char *query;
1065    int bind_i, query_len, bind_num;
1066    long trans_res_id = 0;
1067    ibase_db_link *ib_link = NULL;
1068    ibase_trans *trans = NULL;
1069    ibase_query ib_query = { NULL, NULL, 0, 0 };
1070    ibase_result *result = NULL;
1071
1072    RESET_ERRMSG;
1073
1074    RETVAL_FALSE;
1075
1076    switch (ZEND_NUM_ARGS()) {
1077        long l;
1078
1079        default:
1080            if (SUCCESS == zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, 3, "rrs",
1081                    &zlink, &ztrans, &query, &query_len)) {
1082
1083                ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link*, zlink, -1, LE_LINK, le_link, le_plink);
1084                ZEND_FETCH_RESOURCE(trans, ibase_trans*, ztrans, -1, LE_TRANS,  le_trans);
1085
1086                trans_res_id = Z_RES_P(ztrans)->handle;
1087                bind_i = 3;
1088                break;
1089            }
1090        case 2:
1091            if (SUCCESS == zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, 2, "rs",
1092                    &zlink, &query, &query_len)) {
1093                _php_ibase_get_link_trans(INTERNAL_FUNCTION_PARAM_PASSTHRU, zlink, &ib_link, &trans);
1094
1095                if (trans != NULL) {
1096                    trans_res_id = Z_RES_P(zlink)->handle;
1097                }
1098                bind_i = 2;
1099                break;
1100            }
1101
1102            /* the statement is 'CREATE DATABASE ...' if the link argument is IBASE_CREATE */
1103            if (SUCCESS == zend_parse_parameters_ex(ZEND_PARSE_PARAMS_QUIET, ZEND_NUM_ARGS()
1104                    TSRMLS_CC, "ls", &l, &query, &query_len) && l == PHP_IBASE_CREATE) {
1105                isc_db_handle db = NULL;
1106                isc_tr_handle trans = NULL;
1107
1108                if (PG(sql_safe_mode)) {
1109                    _php_ibase_module_error("CREATE DATABASE is not allowed in SQL safe mode"
1110                        );
1111
1112                } else if (((l = INI_INT("ibase.max_links")) != -1) && (IBG(num_links) >= l)) {
1113                    _php_ibase_module_error("CREATE DATABASE is not allowed: maximum link count "
1114                        "(%ld) reached", l);
1115
1116                } else if (isc_dsql_execute_immediate(IB_STATUS, &db, &trans, (short)query_len,
1117                        query, SQL_DIALECT_CURRENT, NULL)) {
1118                    _php_ibase_error();
1119
1120                } else if (!db) {
1121                    _php_ibase_module_error("Connection to created database could not be "
1122                        "established");
1123
1124                } else {
1125
1126                    /* register the link as a resource; unfortunately, we cannot register
1127                       it in the hash table, because we don't know the connection params */
1128                    ib_link = (ibase_db_link *) emalloc(sizeof(ibase_db_link));
1129                    ib_link->handle = db;
1130                    ib_link->dialect = SQL_DIALECT_CURRENT;
1131                    ib_link->tr_list = NULL;
1132                    ib_link->event_head = NULL;
1133
1134                    ZEND_REGISTER_RESOURCE(return_value, ib_link, le_link);
1135                    Z_ADDREF_P(return_value);
1136                    IBG(default_link) = Z_RES_P(return_value)->handle;
1137                    ++IBG(num_links);
1138                }
1139                return;
1140            }
1141        case 1:
1142        case 0:
1143            if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() ? 1 : 0, "s", &query,
1144                    &query_len)) {
1145                ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link *, NULL, IBG(default_link), LE_LINK,
1146                    le_link, le_plink);
1147
1148                bind_i = 1;
1149                break;
1150            }
1151            return;
1152    }
1153
1154    /* open default transaction */
1155    if (ib_link == NULL || FAILURE == _php_ibase_def_trans(ib_link, &trans)
1156            || FAILURE == _php_ibase_alloc_query(&ib_query, ib_link, trans, query, ib_link->dialect,
1157                trans_res_id)) {
1158        return;
1159    }
1160
1161    do {
1162        int bind_n = ZEND_NUM_ARGS() - bind_i,
1163            expected_n = ib_query.in_sqlda ? ib_query.in_sqlda->sqld : 0;
1164
1165        if (bind_n != expected_n) {
1166            php_error_docref(NULL, (bind_n < expected_n) ? E_WARNING : E_NOTICE,
1167                "Statement expects %d arguments, %d given", expected_n, bind_n);
1168            if (bind_n < expected_n) {
1169                break;
1170            }
1171        } else if (bind_n > 0) {
1172            if (zend_parse_parameters(ZEND_NUM_ARGS(), "+", &bind_args, &bind_num) == FAILURE) {
1173                return;
1174            }
1175        }
1176
1177        if (FAILURE == _php_ibase_exec(INTERNAL_FUNCTION_PARAM_PASSTHRU, &result, &ib_query,
1178                &bind_args[bind_i])) {
1179            break;
1180        }
1181
1182        if (result != NULL) { /* statement returns a result */
1183            result->type = QUERY_RESULT;
1184
1185            /* EXECUTE PROCEDURE returns only one row => statement can be released immediately */
1186            if (ib_query.statement_type != isc_info_sql_stmt_exec_procedure) {
1187                ib_query.stmt = NULL; /* keep stmt when free query */
1188            }
1189            ZEND_REGISTER_RESOURCE(return_value, result, le_result);
1190            Z_ADDREF_P(return_value);
1191        }
1192    } while (0);
1193
1194    _php_ibase_free_query(&ib_query);
1195
1196}
1197/* }}} */
1198
1199/* {{{ proto int ibase_affected_rows( [ resource link_identifier ] )
1200   Returns the number of rows affected by the previous INSERT, UPDATE or DELETE statement */
1201PHP_FUNCTION(ibase_affected_rows)
1202{
1203    ibase_trans *trans = NULL;
1204    ibase_db_link *ib_link;
1205    zval *arg = NULL;
1206
1207    RESET_ERRMSG;
1208
1209    if (zend_parse_parameters(ZEND_NUM_ARGS(), "|r", &arg) == FAILURE) {
1210        return;
1211    }
1212
1213    if (!arg) {
1214        ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link *, NULL, IBG(default_link), LE_LINK, le_link, le_plink);
1215        if (ib_link->tr_list == NULL || ib_link->tr_list->trans == NULL) {
1216            RETURN_FALSE;
1217        }
1218        trans = ib_link->tr_list->trans;
1219    } else {
1220        /* one id was passed, could be db or trans id */
1221        _php_ibase_get_link_trans(INTERNAL_FUNCTION_PARAM_PASSTHRU, arg, &ib_link, &trans);
1222        if (trans == NULL) {
1223            ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link *, arg, -1, LE_LINK, le_link, le_plink);
1224
1225            if (ib_link->tr_list == NULL || ib_link->tr_list->trans == NULL) {
1226                RETURN_FALSE;
1227            }
1228            trans = ib_link->tr_list->trans;
1229        }
1230    }
1231    RETURN_LONG(trans->affected_rows);
1232}
1233/* }}} */
1234
1235/* {{{ proto int ibase_num_rows( resource result_identifier )
1236   Return the number of rows that are available in a result */
1237#if abies_0
1238PHP_FUNCTION(ibase_num_rows)
1239{
1240    /**
1241     * As this function relies on the InterBase API function isc_dsql_sql_info()
1242     * which has a couple of limitations (which I hope will be fixed in future
1243     * releases of Firebird), this function is fairly useless. I'm leaving it
1244     * in place for people who can live with the limitations, which I only
1245     * found out about after I had implemented it anyway.
1246     *
1247     * Currently, there's no way to determine how many rows can be fetched from
1248     * a cursor. The only number that _can_ be determined is the number of rows
1249     * that have already been pre-fetched by the client library.
1250     * This implies the following:
1251     * - num_rows() always returns zero before the first fetch;
1252     * - num_rows() for SELECT ... FOR UPDATE is broken -> never returns a
1253     *   higher number than the number of records fetched so far (no pre-fetch);
1254     * - the result of num_rows() for other statements is merely a lower bound
1255     *   on the number of records => calling ibase_num_rows() again after a couple
1256     *   of fetches will most likely return a new (higher) figure for large result
1257     *   sets.
1258     */
1259
1260    zval *result_arg;
1261    ibase_result *ib_result;
1262    static char info_count[] = {isc_info_sql_records};
1263    char result[64];
1264
1265    RESET_ERRMSG;
1266
1267    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r", &result_arg) == FAILURE) {
1268        return;
1269    }
1270
1271    ZEND_FETCH_RESOURCE(ib_result, ibase_result *, &result_arg, -1, LE_RESULT, le_result);
1272
1273    if (isc_dsql_sql_info(IB_STATUS, &ib_result->stmt, sizeof(info_count), info_count, sizeof(result), result)) {
1274        _php_ibase_error();
1275        RETURN_FALSE;
1276    }
1277
1278    if (result[0] == isc_info_sql_records) {
1279        unsigned i = 3, result_size = isc_vax_integer(&result[1],2);
1280
1281        while (result[i] != isc_info_end && i < result_size) {
1282            short len = (short)isc_vax_integer(&result[i+1],2);
1283            if (result[i] == isc_info_req_select_count) {
1284                RETURN_LONG(isc_vax_integer(&result[i+3],len));
1285            }
1286            i += len+3;
1287        }
1288    }
1289}
1290#endif
1291/* }}} */
1292
1293static int _php_ibase_var_zval(zval *val, void *data, int type, int len, /* {{{ */
1294    int scale, int flag)
1295{
1296    static ISC_INT64 const scales[] = { 1, 10, 100, 1000,
1297        10000,
1298        100000,
1299        1000000,
1300        10000000,
1301        100000000,
1302        1000000000,
1303        LL_LIT(10000000000),
1304        LL_LIT(100000000000),
1305        LL_LIT(1000000000000),
1306        LL_LIT(10000000000000),
1307        LL_LIT(100000000000000),
1308        LL_LIT(1000000000000000),
1309        LL_LIT(10000000000000000),
1310        LL_LIT(100000000000000000),
1311        LL_LIT(1000000000000000000)
1312    };
1313
1314    switch (type & ~1) {
1315        unsigned short l;
1316        long n;
1317        char string_data[255];
1318        struct tm t;
1319        char *format;
1320
1321        case SQL_VARYING:
1322            len = ((IBVARY *) data)->vary_length;
1323            data = ((IBVARY *) data)->vary_string;
1324            /* no break */
1325        case SQL_TEXT:
1326            ZVAL_STRINGL(val, (char*)data, len);
1327            break;
1328        case SQL_SHORT:
1329            n = *(short *) data;
1330            goto _sql_long;
1331        case SQL_INT64:
1332#if (SIZEOF_LONG >= 8)
1333            n = *(long *) data;
1334            goto _sql_long;
1335#else
1336            if (scale == 0) {
1337                l = slprintf(string_data, sizeof(string_data), "%" LL_MASK "d", *(ISC_INT64 *) data);
1338                ZVAL_STRINGL(val,string_data,l,1);
1339            } else {
1340                ISC_INT64 n = *(ISC_INT64 *) data, f = scales[-scale];
1341
1342                if (n >= 0) {
1343                    l = slprintf(string_data, sizeof(string_data), "%" LL_MASK "d.%0*" LL_MASK "d", n / f, -scale, n % f);
1344                } else if (n <= -f) {
1345                    l = slprintf(string_data, sizeof(string_data), "%" LL_MASK "d.%0*" LL_MASK "d", n / f, -scale, -n % f);
1346                 } else {
1347                    l = slprintf(string_data, sizeof(string_data), "-0.%0*" LL_MASK "d", -scale, -n % f);
1348                }
1349                ZVAL_STRINGL(val,string_data,l,1);
1350            }
1351            break;
1352#endif
1353        case SQL_LONG:
1354            n = *(ISC_LONG *) data;
1355        _sql_long:
1356            if (scale == 0) {
1357                ZVAL_LONG(val,n);
1358            } else {
1359                long f = (long) scales[-scale];
1360
1361                if (n >= 0) {
1362                    l = slprintf(string_data, sizeof(string_data), "%ld.%0*ld", n / f, -scale,  n % f);
1363                } else if (n <= -f) {
1364                    l = slprintf(string_data, sizeof(string_data), "%ld.%0*ld", n / f, -scale,  -n % f);
1365                } else {
1366                    l = slprintf(string_data, sizeof(string_data), "-0.%0*ld", -scale, -n % f);
1367                }
1368                ZVAL_STRINGL(val, string_data, l);
1369            }
1370            break;
1371        case SQL_FLOAT:
1372            ZVAL_DOUBLE(val, *(float *) data);
1373            break;
1374        case SQL_DOUBLE:
1375            ZVAL_DOUBLE(val, *(double *) data);
1376            break;
1377        case SQL_DATE: /* == case SQL_TIMESTAMP: */
1378            format = INI_STR("ibase.timestampformat");
1379            isc_decode_timestamp((ISC_TIMESTAMP *) data, &t);
1380            goto format_date_time;
1381        case SQL_TYPE_DATE:
1382            format = INI_STR("ibase.dateformat");
1383            isc_decode_sql_date((ISC_DATE *) data, &t);
1384            goto format_date_time;
1385        case SQL_TYPE_TIME:
1386            format = INI_STR("ibase.timeformat");
1387            isc_decode_sql_time((ISC_TIME *) data, &t);
1388
1389format_date_time:
1390            /*
1391              XXX - Might have to remove this later - seems that isc_decode_date()
1392               always sets tm_isdst to 0, sometimes incorrectly (InterBase 6 bug?)
1393            */
1394            t.tm_isdst = -1;
1395#if HAVE_TM_ZONE
1396            t.tm_zone = tzname[0];
1397#endif
1398            if (flag & PHP_IBASE_UNIXTIME) {
1399                ZVAL_LONG(val, mktime(&t));
1400            } else {
1401#if HAVE_STRFTIME
1402                l = strftime(string_data, sizeof(string_data), format, &t);
1403#else
1404                switch (type & ~1) {
1405                    default:
1406                        l = slprintf(string_data, sizeof(string_data), "%02d/%02d/%4d %02d:%02d:%02d", t.tm_mon+1, t.tm_mday,
1407                            t.tm_year + 1900, t.tm_hour, t.tm_min, t.tm_sec);
1408                        break;
1409                    case SQL_TYPE_DATE:
1410                        l = slprintf(string_data, sizeof(string_data), "%02d/%02d/%4d", t.tm_mon + 1, t.tm_mday, t.tm_year+1900);
1411                        break;
1412                    case SQL_TYPE_TIME:
1413                        l = slprintf(string_data, sizeof(string_data), "%02d:%02d:%02d", t.tm_hour, t.tm_min, t.tm_sec);
1414                        break;
1415                }
1416#endif
1417                ZVAL_STRINGL(val, string_data, l);
1418                break;
1419            }
1420    } /* switch (type) */
1421    return SUCCESS;
1422}
1423/* }}}  */
1424
1425static int _php_ibase_arr_zval(zval *ar_zval, char *data, unsigned long data_size, /* {{{ */
1426    ibase_array *ib_array, int dim, int flag)
1427{
1428    /**
1429     * Create multidimension array - recursion function
1430     */
1431    int
1432        u_bound = ib_array->ar_desc.array_desc_bounds[dim].array_bound_upper,
1433        l_bound = ib_array->ar_desc.array_desc_bounds[dim].array_bound_lower,
1434        dim_len = 1 + u_bound - l_bound;
1435    unsigned short i;
1436
1437    if (dim < ib_array->ar_desc.array_desc_dimensions) { /* array again */
1438        unsigned long slice_size = data_size / dim_len;
1439
1440        array_init(ar_zval);
1441
1442        for (i = 0; i < dim_len; ++i) {
1443            zval slice_zval;
1444
1445            /* recursion here */
1446            if (FAILURE == _php_ibase_arr_zval(&slice_zval, data, slice_size, ib_array, dim + 1,
1447                    flag)) {
1448                return FAILURE;
1449            }
1450            data += slice_size;
1451
1452            add_index_zval(ar_zval, l_bound + i, &slice_zval);
1453        }
1454    } else { /* data at last */
1455
1456        if (FAILURE == _php_ibase_var_zval(ar_zval, data, ib_array->el_type,
1457                ib_array->ar_desc.array_desc_length, ib_array->ar_desc.array_desc_scale, flag)) {
1458            return FAILURE;
1459        }
1460
1461        /* fix for peculiar handling of VARCHAR arrays;
1462           truncate the field to the cstring length */
1463        if (ib_array->ar_desc.array_desc_dtype == blr_varying ||
1464            ib_array->ar_desc.array_desc_dtype == blr_varying2) {
1465
1466            Z_STRLEN_P(ar_zval) = strlen(Z_STRVAL_P(ar_zval));
1467        }
1468    }
1469    return SUCCESS;
1470}
1471/* }}} */
1472
1473static void _php_ibase_fetch_hash(INTERNAL_FUNCTION_PARAMETERS, int fetch_type) /* {{{ */
1474{
1475    zval *result_arg;
1476    long i, array_cnt = 0, flag = 0;
1477    ibase_result *ib_result;
1478
1479    RESET_ERRMSG;
1480
1481    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r|l", &result_arg, &flag)) {
1482        return;
1483    }
1484
1485    ZEND_FETCH_RESOURCE(ib_result, ibase_result *, result_arg, -1, LE_RESULT, le_result);
1486
1487    if (ib_result->out_sqlda == NULL || !ib_result->has_more_rows) {
1488        RETURN_FALSE;
1489    }
1490
1491    if (ib_result->statement_type != isc_info_sql_stmt_exec_procedure) {
1492        if (isc_dsql_fetch(IB_STATUS, &ib_result->stmt, 1, ib_result->out_sqlda)) {
1493            ib_result->has_more_rows = 0;
1494            if (IB_STATUS[0] && IB_STATUS[1]) { /* error in fetch */
1495                _php_ibase_error();
1496            }
1497            RETURN_FALSE;
1498        }
1499    } else {
1500        ib_result->has_more_rows = 0;
1501    }
1502
1503    array_init(return_value);
1504
1505    for (i = 0; i < ib_result->out_sqlda->sqld; ++i) {
1506        XSQLVAR *var = &ib_result->out_sqlda->sqlvar[i];
1507        char buf[METADATALENGTH+4], *alias = var->aliasname;
1508
1509        if (! (fetch_type & FETCH_ROW)) {
1510            int i = 0;
1511            char const *base = "FIELD"; /* use 'FIELD' if name is empty */
1512
1513            /**
1514            * Ensure no two columns have identical names:
1515            * keep generating new names until we find one that is unique.
1516            */
1517            switch (*alias) {
1518                void *p;
1519
1520                default:
1521                    i = 1;
1522                    base = alias;
1523
1524                    while ((p = zend_symtable_str_find_ptr(
1525                            Z_ARRVAL_P(return_value), alias, strlen(alias))) != NULL) {
1526
1527                case '\0':
1528                        snprintf(alias = buf, sizeof(buf), "%s_%02d", base, i++);
1529                    }
1530            }
1531        }
1532
1533        if (((var->sqltype & 1) == 0) || *var->sqlind != -1) {
1534            zval result;
1535
1536            switch (var->sqltype & ~1) {
1537
1538                default:
1539                    _php_ibase_var_zval(&result, var->sqldata, var->sqltype, var->sqllen,
1540                        var->sqlscale, flag);
1541                    break;
1542                case SQL_BLOB:
1543                    if (flag & PHP_IBASE_FETCH_BLOBS) { /* fetch blob contents into hash */
1544
1545                        ibase_blob blob_handle;
1546                        unsigned long max_len = 0;
1547                        static char bl_items[] = {isc_info_blob_total_length};
1548                        char bl_info[20];
1549                        unsigned short i;
1550
1551                        blob_handle.bl_handle = NULL;
1552                        blob_handle.bl_qd = *(ISC_QUAD *) var->sqldata;
1553
1554                        if (isc_open_blob(IB_STATUS, &ib_result->link->handle, &ib_result->trans->handle,
1555                                &blob_handle.bl_handle, &blob_handle.bl_qd)) {
1556                            _php_ibase_error();
1557                            goto _php_ibase_fetch_error;
1558                        }
1559
1560                        if (isc_blob_info(IB_STATUS, &blob_handle.bl_handle, sizeof(bl_items),
1561                                bl_items, sizeof(bl_info), bl_info)) {
1562                            _php_ibase_error();
1563                            goto _php_ibase_fetch_error;
1564                        }
1565
1566                        /* find total length of blob's data */
1567                        for (i = 0; i < sizeof(bl_info); ) {
1568                            unsigned short item_len;
1569                            char item = bl_info[i++];
1570
1571                            if (item == isc_info_end || item == isc_info_truncated ||
1572                                item == isc_info_error || i >= sizeof(bl_info)) {
1573
1574                                _php_ibase_module_error("Could not determine BLOB size (internal error)"
1575                                    );
1576                                goto _php_ibase_fetch_error;
1577                            }
1578
1579                            item_len = (unsigned short) isc_vax_integer(&bl_info[i], 2);
1580
1581                            if (item == isc_info_blob_total_length) {
1582                                max_len = isc_vax_integer(&bl_info[i+2], item_len);
1583                                break;
1584                            }
1585                            i += item_len+2;
1586                        }
1587
1588                        if (max_len == 0) {
1589                            ZVAL_STRING(&result, "");
1590                        } else if (SUCCESS != _php_ibase_blob_get(&result, &blob_handle,
1591                                max_len)) {
1592                            goto _php_ibase_fetch_error;
1593                        }
1594
1595                        if (isc_close_blob(IB_STATUS, &blob_handle.bl_handle)) {
1596                            _php_ibase_error();
1597                            goto _php_ibase_fetch_error;
1598                        }
1599
1600                    } else { /* blob id only */
1601                        char *s;
1602                        ISC_QUAD bl_qd = *(ISC_QUAD *) var->sqldata;
1603                        s = _php_ibase_quad_to_string(bl_qd);
1604                        ZVAL_STRINGL(&result, s, BLOB_ID_LEN);
1605                        efree(s);
1606                    }
1607                    break;
1608                case SQL_ARRAY:
1609                    if (flag & PHP_IBASE_FETCH_ARRAYS) { /* array can be *huge* so only fetch if asked */
1610                        ISC_QUAD ar_qd = *(ISC_QUAD *) var->sqldata;
1611                        ibase_array *ib_array = &ib_result->out_array[array_cnt++];
1612                        void *ar_data = emalloc(ib_array->ar_size);
1613
1614                        if (isc_array_get_slice(IB_STATUS, &ib_result->link->handle,
1615                                &ib_result->trans->handle, &ar_qd, &ib_array->ar_desc,
1616                                ar_data, &ib_array->ar_size)) {
1617                            _php_ibase_error();
1618                            efree(ar_data);
1619                            goto _php_ibase_fetch_error;
1620                        }
1621
1622                        if (FAILURE == _php_ibase_arr_zval(&result, ar_data, ib_array->ar_size, ib_array,
1623                                0, flag)) {
1624                            efree(ar_data);
1625                            goto _php_ibase_fetch_error;
1626                        }
1627                        efree(ar_data);
1628
1629                    } else { /* blob id only */
1630                        char *s;
1631                        ISC_QUAD ar_qd = *(ISC_QUAD *) var->sqldata;
1632                        s = _php_ibase_quad_to_string(ar_qd);
1633                        ZVAL_STRINGL(&result, s, BLOB_ID_LEN);
1634                    }
1635                    break;
1636                _php_ibase_fetch_error:
1637                    zval_dtor(&result);
1638                    RETURN_FALSE;
1639            } /* switch */
1640
1641            if (fetch_type & FETCH_ROW) {
1642                add_index_zval(return_value, i, &result);
1643            } else {
1644                add_assoc_zval(return_value, alias, &result);
1645            }
1646        } else {
1647            if (fetch_type & FETCH_ROW) {
1648                add_index_null(return_value, i);
1649            } else {
1650                add_assoc_null(return_value, alias);
1651            }
1652        }
1653    } /* for field */
1654}
1655/* }}} */
1656
1657/* {{{ proto array ibase_fetch_row(resource result [, int fetch_flags])
1658   Fetch a row  from the results of a query */
1659PHP_FUNCTION(ibase_fetch_row)
1660{
1661    _php_ibase_fetch_hash(INTERNAL_FUNCTION_PARAM_PASSTHRU, FETCH_ROW);
1662}
1663/* }}} */
1664
1665/* {{{ proto array ibase_fetch_assoc(resource result [, int fetch_flags])
1666   Fetch a row  from the results of a query */
1667PHP_FUNCTION(ibase_fetch_assoc)
1668{
1669    _php_ibase_fetch_hash(INTERNAL_FUNCTION_PARAM_PASSTHRU, FETCH_ARRAY);
1670}
1671/* }}} */
1672
1673/* {{{ proto object ibase_fetch_object(resource result [, int fetch_flags])
1674   Fetch a object from the results of a query */
1675PHP_FUNCTION(ibase_fetch_object)
1676{
1677    _php_ibase_fetch_hash(INTERNAL_FUNCTION_PARAM_PASSTHRU, FETCH_ARRAY);
1678
1679    if (Z_TYPE_P(return_value) == IS_ARRAY) {
1680        convert_to_object(return_value);
1681    }
1682}
1683/* }}} */
1684
1685
1686/* {{{ proto bool ibase_name_result(resource result, string name)
1687   Assign a name to a result for use with ... WHERE CURRENT OF <name> statements */
1688PHP_FUNCTION(ibase_name_result)
1689{
1690    zval *result_arg;
1691    char *name_arg;
1692    int name_arg_len;
1693    ibase_result *ib_result;
1694
1695    RESET_ERRMSG;
1696
1697    if (zend_parse_parameters(ZEND_NUM_ARGS(), "rs", &result_arg, &name_arg, &name_arg_len) == FAILURE) {
1698        return;
1699    }
1700
1701    ZEND_FETCH_RESOURCE(ib_result, ibase_result *, result_arg, -1, LE_RESULT, le_result);
1702
1703    if (isc_dsql_set_cursor_name(IB_STATUS, &ib_result->stmt, name_arg, 0)) {
1704        _php_ibase_error();
1705        RETURN_FALSE;
1706    }
1707    RETURN_TRUE;
1708}
1709/* }}} */
1710
1711
1712/* {{{ proto bool ibase_free_result(resource result)
1713   Free the memory used by a result */
1714PHP_FUNCTION(ibase_free_result)
1715{
1716    zval *result_arg;
1717    ibase_result *ib_result;
1718
1719    RESET_ERRMSG;
1720
1721    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r", &result_arg) == FAILURE) {
1722        return;
1723    }
1724
1725    ZEND_FETCH_RESOURCE(ib_result, ibase_result *, result_arg, -1, LE_RESULT, le_result);
1726    zend_list_delete(Z_RES_P(result_arg));
1727    RETURN_TRUE;
1728}
1729/* }}} */
1730
1731/* {{{ proto resource ibase_prepare(resource link_identifier[, string query [, resource trans_identifier ]])
1732   Prepare a query for later execution */
1733PHP_FUNCTION(ibase_prepare)
1734{
1735    zval *link_arg, *trans_arg;
1736    ibase_db_link *ib_link;
1737    ibase_trans *trans = NULL;
1738    size_t query_len, trans_res_id = 0;
1739    ibase_query *ib_query;
1740    char *query;
1741
1742    RESET_ERRMSG;
1743
1744    if (ZEND_NUM_ARGS() == 1) {
1745        if (zend_parse_parameters(ZEND_NUM_ARGS(), "s", &query, &query_len) == FAILURE) {
1746            return;
1747        }
1748        ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link *, NULL, IBG(default_link), LE_LINK, le_link, le_plink);
1749    } else if (ZEND_NUM_ARGS() == 2) {
1750        if (zend_parse_parameters(ZEND_NUM_ARGS(), "rs", &link_arg, &query, &query_len) == FAILURE) {
1751            return;
1752        }
1753        _php_ibase_get_link_trans(INTERNAL_FUNCTION_PARAM_PASSTHRU, link_arg, &ib_link, &trans);
1754
1755        if (trans != NULL) {
1756            trans_res_id = Z_RES_P(link_arg)->handle;
1757        }
1758    } else {
1759        if (zend_parse_parameters(ZEND_NUM_ARGS(), "rrs", &link_arg, &trans_arg, &query, &query_len) == FAILURE) {
1760            return;
1761        }
1762        ZEND_FETCH_RESOURCE2(ib_link, ibase_db_link *, link_arg, -1, LE_LINK, le_link, le_plink);
1763        ZEND_FETCH_RESOURCE(trans, ibase_trans *, trans_arg, -1, LE_TRANS, le_trans);
1764        trans_res_id = Z_RES_P(trans_arg)->handle;
1765    }
1766
1767    if (FAILURE == _php_ibase_def_trans(ib_link, &trans)) {
1768        RETURN_FALSE;
1769    }
1770
1771    ib_query = (ibase_query *) emalloc(sizeof(ibase_query));
1772
1773    if (FAILURE == _php_ibase_alloc_query(ib_query, ib_link, trans, query, ib_link->dialect, trans_res_id)) {
1774        efree(ib_query);
1775        RETURN_FALSE;
1776    }
1777    ZEND_REGISTER_RESOURCE(return_value, ib_query, le_query);
1778    Z_ADDREF_P(return_value);
1779}
1780/* }}} */
1781
1782/* {{{ proto mixed ibase_execute(resource query [, mixed bind_arg [, mixed bind_arg [, ...]]])
1783   Execute a previously prepared query */
1784PHP_FUNCTION(ibase_execute)
1785{
1786    zval *query, *args = NULL;
1787    ibase_query *ib_query;
1788    ibase_result *result = NULL;
1789    int bind_n = 0;
1790
1791    RESET_ERRMSG;
1792
1793    RETVAL_FALSE;
1794
1795    if (FAILURE == zend_parse_parameters(ZEND_NUM_ARGS(), "|r*", &query, &args, &bind_n)) {
1796        return;
1797    }
1798
1799    ZEND_FETCH_RESOURCE(ib_query, ibase_query *, query, -1, LE_QUERY, le_query);
1800
1801    do {
1802        int expected_n = ib_query->in_sqlda ? ib_query->in_sqlda->sqld : 0;
1803
1804        if (bind_n != expected_n) {
1805            php_error_docref(NULL, (bind_n < expected_n) ? E_WARNING : E_NOTICE,
1806                "Statement expects %d arguments, %d given", expected_n, bind_n);
1807
1808            if (bind_n < expected_n) {
1809                break;
1810            }
1811        }
1812
1813        /* Have we used this cursor before and it's still open (exec proc has no cursor) ? */
1814        if (ib_query->result_res_id != 0
1815                && ib_query->statement_type != isc_info_sql_stmt_exec_procedure) {
1816            zval *res;
1817
1818            IBDEBUG("Implicitly closing a cursor");
1819
1820            if (isc_dsql_free_statement(IB_STATUS, &ib_query->stmt, DSQL_close)) {
1821                _php_ibase_error();
1822                break;
1823            }
1824            /* invalidate previous results returned by this query (not necessary for exec proc) */
1825            res = zend_hash_index_find(&EG(regular_list), ib_query->result_res_id);
1826            if (res) {
1827                zend_list_delete(Z_RES_P(res));
1828            }
1829        }
1830
1831        if (FAILURE == _php_ibase_exec(INTERNAL_FUNCTION_PARAM_PASSTHRU, &result, ib_query,
1832                args)) {
1833            break;
1834        }
1835
1836        /* free the query if trans handle was released */
1837        if (ib_query->trans->handle == NULL) {
1838            zend_list_delete(Z_RES_P(query));
1839        }
1840
1841        if (result != NULL) {
1842            zval *ret;
1843
1844            result->type = EXECUTE_RESULT;
1845            if (ib_query->statement_type == isc_info_sql_stmt_exec_procedure) {
1846                result->stmt = NULL;
1847            }
1848
1849            ret = zend_list_insert(result, le_result);
1850            ib_query->result_res_id = Z_RES_HANDLE_P(ret);
1851            ZVAL_COPY_VALUE(return_value, ret);
1852            Z_ADDREF_P(return_value);
1853            Z_ADDREF_P(return_value);
1854        }
1855    } while (0);
1856}
1857/* }}} */
1858
1859/* {{{ proto bool ibase_free_query(resource query)
1860   Free memory used by a query */
1861PHP_FUNCTION(ibase_free_query)
1862{
1863    zval *query_arg;
1864    ibase_query *ib_query;
1865
1866    RESET_ERRMSG;
1867
1868    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r", &query_arg) == FAILURE) {
1869        return;
1870    }
1871
1872    ZEND_FETCH_RESOURCE(ib_query, ibase_query *, query_arg, -1, LE_QUERY, le_query);
1873    zend_list_close(Z_RES_P(query_arg));
1874    RETURN_TRUE;
1875}
1876/* }}} */
1877
1878/* {{{ proto int ibase_num_fields(resource query_result)
1879   Get the number of fields in result */
1880PHP_FUNCTION(ibase_num_fields)
1881{
1882    zval *result;
1883    int type;
1884    XSQLDA *sqlda;
1885
1886    RESET_ERRMSG;
1887
1888    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r", &result) == FAILURE) {
1889        return;
1890    }
1891
1892    type = Z_RES_P(result)->type;
1893
1894    if (type == le_query) {
1895        ibase_query *ib_query;
1896
1897        ZEND_FETCH_RESOURCE(ib_query, ibase_query *, result, -1, LE_QUERY, le_query);
1898        sqlda = ib_query->out_sqlda;
1899    } else {
1900        ibase_result *ib_result;
1901
1902        ZEND_FETCH_RESOURCE(ib_result, ibase_result *, result, -1, LE_RESULT, le_result);
1903        sqlda = ib_result->out_sqlda;
1904    }
1905
1906    if (sqlda == NULL) {
1907        RETURN_LONG(0);
1908    } else {
1909        RETURN_LONG(sqlda->sqld);
1910    }
1911}
1912/* }}} */
1913
1914static void _php_ibase_field_info(zval *return_value, XSQLVAR *var) /* {{{ */
1915{
1916    unsigned short len;
1917    char buf[16], *s = buf;
1918
1919    array_init(return_value);
1920
1921    add_index_stringl(return_value, 0, var->sqlname, var->sqlname_length);
1922    add_assoc_stringl(return_value, "name", var->sqlname, var->sqlname_length);
1923
1924    add_index_stringl(return_value, 1, var->aliasname, var->aliasname_length);
1925    add_assoc_stringl(return_value, "alias", var->aliasname, var->aliasname_length);
1926
1927    add_index_stringl(return_value, 2, var->relname, var->relname_length);
1928    add_assoc_stringl(return_value, "relation", var->relname, var->relname_length);
1929
1930    len = slprintf(buf, 16, "%d", var->sqllen);
1931    add_index_stringl(return_value, 3, buf, len);
1932    add_assoc_stringl(return_value, "length", buf, len);
1933
1934    if (var->sqlscale < 0) {
1935        unsigned short precision = 0;
1936
1937        switch (var->sqltype & ~1) {
1938
1939            case SQL_SHORT:
1940                precision = 4;
1941                break;
1942            case SQL_LONG:
1943                precision = 9;
1944                break;
1945            case SQL_INT64:
1946                precision = 18;
1947                break;
1948        }
1949        len = slprintf(buf, 16, "NUMERIC(%d,%d)", precision, -var->sqlscale);
1950        add_index_stringl(return_value, 4, s, len);
1951        add_assoc_stringl(return_value, "type", s, len);
1952    } else {
1953        switch (var->sqltype & ~1) {
1954            case SQL_TEXT:
1955                s = "CHAR";
1956                break;
1957            case SQL_VARYING:
1958                s = "VARCHAR";
1959                break;
1960            case SQL_SHORT:
1961                s = "SMALLINT";
1962                break;
1963            case SQL_LONG:
1964                s = "INTEGER";
1965                break;
1966            case SQL_FLOAT:
1967                s = "FLOAT"; break;
1968            case SQL_DOUBLE:
1969            case SQL_D_FLOAT:
1970                s = "DOUBLE PRECISION"; break;
1971            case SQL_INT64:
1972                s = "BIGINT";
1973                break;
1974            case SQL_TIMESTAMP:
1975                s = "TIMESTAMP";
1976                break;
1977            case SQL_TYPE_DATE:
1978                s = "DATE";
1979                break;
1980            case SQL_TYPE_TIME:
1981                s = "TIME";
1982                break;
1983            case SQL_BLOB:
1984                s = "BLOB";
1985                break;
1986            case SQL_ARRAY:
1987                s = "ARRAY";
1988                break;
1989                /* FIXME: provide more detailed information about the field type, field size
1990                 * and array dimensions */
1991            case SQL_QUAD:
1992                s = "QUAD";
1993                break;
1994        }
1995        add_index_string(return_value, 4, s);
1996        add_assoc_string(return_value, "type", s);
1997    }
1998}
1999/* }}} */
2000
2001/* {{{ proto array ibase_field_info(resource query_result, int field_number)
2002   Get information about a field */
2003PHP_FUNCTION(ibase_field_info)
2004{
2005    zval *result_arg;
2006    long field_arg;
2007    int type;
2008    XSQLDA *sqlda;
2009
2010    RESET_ERRMSG;
2011
2012    if (zend_parse_parameters(ZEND_NUM_ARGS(), "rl", &result_arg, &field_arg) == FAILURE) {
2013        return;
2014    }
2015
2016    type = Z_RES_P(result_arg)->type;
2017
2018    if (type == le_query) {
2019        ibase_query *ib_query;
2020
2021        ZEND_FETCH_RESOURCE(ib_query, ibase_query *, result_arg, -1, LE_QUERY, le_query);
2022        sqlda = ib_query->out_sqlda;
2023    } else {
2024        ibase_result *ib_result;
2025
2026        ZEND_FETCH_RESOURCE(ib_result, ibase_result *, result_arg, -1, LE_RESULT, le_result);
2027        sqlda = ib_result->out_sqlda;
2028    }
2029
2030    if (sqlda == NULL) {
2031        _php_ibase_module_error("Trying to get field info from a non-select query");
2032        RETURN_FALSE;
2033    }
2034
2035    if (field_arg < 0 || field_arg >= sqlda->sqld) {
2036        RETURN_FALSE;
2037    }
2038    _php_ibase_field_info(return_value, sqlda->sqlvar + field_arg);
2039}
2040/* }}} */
2041
2042/* {{{ proto int ibase_num_params(resource query)
2043   Get the number of params in a prepared query */
2044PHP_FUNCTION(ibase_num_params)
2045{
2046    zval *result;
2047    ibase_query *ib_query;
2048
2049    RESET_ERRMSG;
2050
2051    if (zend_parse_parameters(ZEND_NUM_ARGS(), "r", &result) == FAILURE) {
2052        return;
2053    }
2054
2055    ZEND_FETCH_RESOURCE(ib_query, ibase_query *, result, -1, LE_QUERY, le_query);
2056
2057    if (ib_query->in_sqlda == NULL) {
2058        RETURN_LONG(0);
2059    } else {
2060        RETURN_LONG(ib_query->in_sqlda->sqld);
2061    }
2062}
2063/* }}} */
2064
2065/* {{{ proto array ibase_param_info(resource query, int field_number)
2066   Get information about a parameter */
2067PHP_FUNCTION(ibase_param_info)
2068{
2069    zval *result_arg;
2070    long field_arg;
2071    ibase_query *ib_query;
2072
2073    RESET_ERRMSG;
2074
2075    if (zend_parse_parameters(ZEND_NUM_ARGS(), "rl", &result_arg, &field_arg) == FAILURE) {
2076        return;
2077    }
2078
2079    ZEND_FETCH_RESOURCE(ib_query, ibase_query *, result_arg, -1, LE_QUERY, le_query);
2080
2081    if (ib_query->in_sqlda == NULL) {
2082        RETURN_FALSE;
2083    }
2084
2085    if (field_arg < 0 || field_arg >= ib_query->in_sqlda->sqld) {
2086        RETURN_FALSE;
2087    }
2088
2089    _php_ibase_field_info(return_value,ib_query->in_sqlda->sqlvar + field_arg);
2090}
2091/* }}} */
2092
2093#endif /* HAVE_IBASE */
2094
2095/*
2096 * Local variables:
2097 * tab-width: 4
2098 * c-basic-offset: 4
2099 * End:
2100 * vim600: sw=4 ts=4 fdm=marker
2101 * vim<600: sw=4 ts=4
2102 */
2103