1 /* 2 +----------------------------------------------------------------------+ 3 | PHP Version 7 | 4 +----------------------------------------------------------------------+ 5 | Copyright (c) 1997-2018 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: Stig Sæther Bakken <ssb@php.net> | 16 | Thies C. Arntzen <thies@thieso.net> | 17 | | 18 | Collection support by Andy Sautins <asautins@veripost.net> | 19 | Temporary LOB support by David Benson <dbenson@mancala.com> | 20 | ZTS per process OCIPLogon by Harald Radi <harald.radi@nme.at> | 21 | | 22 | Redesigned by: Antony Dovgal <antony@zend.com> | 23 | Andi Gutmans <andi@zend.com> | 24 | Wez Furlong <wez@omniti.com> | 25 +----------------------------------------------------------------------+ 26 */ 27 28 #if HAVE_OCI8 29 # ifndef PHP_OCI8_INT_H 30 # define PHP_OCI8_INT_H 31 32 /* {{{ misc defines */ 33 # if (defined(__osf__) && defined(__alpha)) 34 # ifndef A_OSF 35 # define A_OSF 36 # endif 37 # ifndef OSF1 38 # define OSF1 39 # endif 40 # ifndef _INTRINSICS 41 # define _INTRINSICS 42 # endif 43 # endif /* osf alpha */ 44 45 #ifdef HAVE_OCI8_DTRACE 46 #include "oci8_dtrace_gen.h" 47 #endif 48 49 #if defined(min) 50 #undef min 51 #endif 52 #if defined(max) 53 #undef max 54 #endif 55 /* }}} */ 56 57 #include "ext/standard/php_string.h" 58 #include <oci.h> 59 60 extern int le_connection; 61 extern int le_pconnection; 62 extern int le_statement; 63 extern int le_descriptor; 64 extern int le_collection; 65 extern int le_server; 66 extern int le_session; 67 68 extern zend_class_entry *oci_lob_class_entry_ptr; 69 extern zend_class_entry *oci_coll_class_entry_ptr; 70 71 /* {{{ constants */ 72 #define PHP_OCI_SEEK_SET 0 73 #define PHP_OCI_SEEK_CUR 1 74 #define PHP_OCI_SEEK_END 2 75 76 #define PHP_OCI_MAX_NAME_LEN 64 77 #define PHP_OCI_MAX_DATA_SIZE INT_MAX 78 #define PHP_OCI_PIECE_SIZE ((64*1024)-1) 79 #define PHP_OCI_LOB_BUFFER_SIZE 1048576l /* 1Mb seems to be the most reasonable buffer size for LOB reading */ 80 81 #define PHP_OCI_ASSOC (1<<0) 82 #define PHP_OCI_NUM (1<<1) 83 #define PHP_OCI_BOTH (PHP_OCI_ASSOC|PHP_OCI_NUM) 84 85 #define PHP_OCI_RETURN_NULLS (1<<2) 86 #define PHP_OCI_RETURN_LOBS (1<<3) 87 88 #define PHP_OCI_FETCHSTATEMENT_BY_COLUMN (1<<4) 89 #define PHP_OCI_FETCHSTATEMENT_BY_ROW (1<<5) 90 #define PHP_OCI_FETCHSTATEMENT_BY (PHP_OCI_FETCHSTATEMENT_BY_COLUMN | PHP_OCI_FETCHSTATEMENT_BY_ROW) 91 92 #define PHP_OCI_LOB_BUFFER_DISABLED 0 93 #define PHP_OCI_LOB_BUFFER_ENABLED 1 94 #define PHP_OCI_LOB_BUFFER_USED 2 95 96 #ifdef OCI_ERROR_MAXMSG_SIZE2 97 /* Bigger size is defined from 11.2.0.3 onwards */ 98 #define PHP_OCI_ERRBUF_LEN OCI_ERROR_MAXMSG_SIZE2 99 #else 100 #define PHP_OCI_ERRBUF_LEN OCI_ERROR_MAXMSG_SIZE 101 #endif 102 103 /* The mode parameter for oci_connect() is overloaded and accepts both 104 * privilege and external authentication flags OR'd together. 105 * PHP_OCI_CRED_EXT must be distinct from the OCI_xxx privilege 106 * values. 107 */ 108 #define PHP_OCI_CRED_EXT (1<<31) 109 #if ((PHP_OCI_CRED_EXT == OCI_DEFAULT) || (PHP_OCI_CRED_EXT & (OCI_SYSOPER | OCI_SYSDBA))) 110 #error Invalid value for PHP_OCI_CRED_EXT 111 #endif 112 113 #define PHP_OCI_IMPRES_UNKNOWN 0 114 #define PHP_OCI_IMPRES_NO_CHILDREN 1 115 #define PHP_OCI_IMPRES_HAS_CHILDREN 2 116 #define PHP_OCI_IMPRES_IS_CHILD 3 117 118 /* 119 * Name passed to Oracle for tracing. Note some DB views only show 120 * the first nine characters of the driver name. 121 */ 122 #define PHP_OCI8_DRIVER_NAME "PHP OCI8 : " PHP_OCI8_VERSION 123 124 /* }}} */ 125 126 /* {{{ php_oci_spool */ 127 typedef struct { 128 zend_resource *id; /* resource id */ 129 OCIEnv *env; /* env of this session pool */ 130 OCIError *err; /* pool's error handle */ 131 OCISPool *poolh; /* pool handle */ 132 void *poolname; /* session pool name */ 133 unsigned int poolname_len; /* length of session pool name */ 134 zend_string *spool_hash_key; /* Hash key for session pool in plist */ 135 } php_oci_spool; 136 /* }}} */ 137 138 /* {{{ php_oci_connection */ 139 typedef struct { 140 zend_resource *id; /* resource ID */ 141 OCIEnv *env; /* private env handle */ 142 ub2 charset; /* charset ID */ 143 OCIServer *server; /* private server handle */ 144 OCISvcCtx *svc; /* private service context handle */ 145 OCISession *session; /* private session handle */ 146 OCIAuthInfo *authinfo; /* Cached authinfo handle for OCISessionGet */ 147 OCIError *err; /* private error handle */ 148 php_oci_spool *private_spool; /* private session pool (for persistent) */ 149 sb4 errcode; /* last ORA- error number */ 150 151 HashTable *descriptors; /* descriptors hash, used to flush all the LOBs using this connection on commit */ 152 zend_ulong descriptor_count; /* used to index the descriptors hash table. Not an accurate count */ 153 unsigned is_open:1; /* hels to determine if the connection is dead or not */ 154 unsigned is_attached:1; /* hels to determine if we should detach from the server when closing/freeing the connection */ 155 unsigned is_persistent:1; /* self-descriptive */ 156 unsigned used_this_request:1; /* helps to determine if we should reset connection's next ping time and check its timeout */ 157 unsigned rb_on_disconnect:1; /* helps to determine if we should rollback this connection on close/shutdown */ 158 unsigned passwd_changed:1; /* helps determine if a persistent connection hash should be invalidated after a password change */ 159 unsigned is_stub:1; /* flag to keep track whether the connection structure has a real OCI connection associated */ 160 unsigned using_spool:1; /* Is this connection from session pool? */ 161 time_t idle_expiry; /* time when the connection will be considered as expired */ 162 time_t *next_pingp; /* (pointer to) time of the next ping */ 163 zend_string *hash_key; /* hashed details of the connection */ 164 #ifdef HAVE_OCI8_DTRACE 165 char *client_id; /* The oci_set_client_identifier() value */ 166 #endif 167 168 zval taf_callback; /* The Oracle TAF callback function in the userspace */ 169 } php_oci_connection; 170 /* }}} */ 171 172 /* {{{ php_oci_descriptor */ 173 typedef struct { 174 zend_resource *id; 175 zend_ulong index; /* descriptors hash table index */ 176 php_oci_connection *connection; /* parent connection handle */ 177 dvoid *descriptor; /* OCI descriptor handle */ 178 ub4 type; /* descriptor type (FILE/LOB) */ 179 ub4 lob_current_position; /* LOB internal pointer */ 180 int lob_size; /* cached LOB size. -1 = Lob wasn't initialized yet */ 181 int buffering; /* cached buffering flag. 0 - off, 1 - on, 2 - on and buffer was used */ 182 ub4 chunk_size; /* chunk size of the LOB. 0 - unknown */ 183 ub1 charset_form; /* charset form, required for NCLOBs */ 184 ub2 charset_id; /* charset ID */ 185 unsigned is_open:1; /* helps to determine if lob is open or not */ 186 } php_oci_descriptor; 187 /* }}} */ 188 189 /* {{{ php_oci_lob_ctx */ 190 typedef struct { 191 char **lob_data; /* address of pointer to LOB data */ 192 ub4 *lob_len; /* address of LOB length variable (bytes) */ 193 ub4 alloc_len; 194 } php_oci_lob_ctx; 195 /* }}} */ 196 197 /* {{{ php_oci_collection */ 198 typedef struct { 199 zend_resource *id; 200 php_oci_connection *connection; /* parent connection handle */ 201 OCIType *tdo; /* collection's type handle */ 202 OCITypeCode coll_typecode; /* collection's typecode handle */ 203 OCIRef *elem_ref; /* element's reference handle */ 204 OCIType *element_type; /* element's type handle */ 205 OCITypeCode element_typecode; /* element's typecode handle */ 206 OCIColl *collection; /* collection handle */ 207 } php_oci_collection; 208 /* }}} */ 209 210 /* {{{ php_oci_define */ 211 typedef struct { 212 zval val; /* zval used in define */ 213 text *name; /* placeholder's name */ 214 ub4 name_len; /* placeholder's name length */ 215 ub4 type; /* define type */ 216 } php_oci_define; 217 /* }}} */ 218 219 /* {{{ php_oci_statement */ 220 typedef struct { 221 zend_resource *id; 222 zend_resource *parent_stmtid; /* parent statement id */ 223 struct php_oci_statement *impres_child_stmt;/* child of current Implicit Result Set statement handle */ 224 ub4 impres_count; /* count of remaining Implicit Result children on parent statement handle */ 225 php_oci_connection *connection; /* parent connection handle */ 226 sb4 errcode; /* last ORA- error number */ 227 OCIError *err; /* private error handle */ 228 OCIStmt *stmt; /* statement handle */ 229 char *last_query; /* last query issued. also used to determine if this is a statement or a refcursor received from Oracle */ 230 char impres_flag; /* PHP_OCI_IMPRES_*_ */ 231 zend_long last_query_len; /* last query length */ 232 HashTable *columns; /* hash containing all the result columns */ 233 HashTable *binds; /* binds hash */ 234 HashTable *defines; /* defines hash */ 235 int ncolumns; /* number of columns in the result */ 236 unsigned executed:1; /* statement executed flag */ 237 unsigned has_data:1; /* statement has more data flag */ 238 unsigned has_descr:1; /* statement has at least one descriptor or cursor column */ 239 ub2 stmttype; /* statement type */ 240 ub4 prefetch_count; /* current prefetch count */ 241 } php_oci_statement; 242 /* }}} */ 243 244 /* {{{ php_oci_bind */ 245 typedef struct { 246 OCIBind *bind; /* bind handle */ 247 zval val; /* value */ 248 dvoid *descriptor; /* used for binding of LOBS etc */ 249 OCIStmt *statement; /* used for binding REFCURSORs */ 250 php_oci_statement *parent_statement; /* pointer to the parent statement */ 251 ub2 type; /* bind type */ 252 struct { 253 void *elements; 254 sb2 *indicators; 255 ub2 *element_lengths; 256 ub4 current_length; 257 ub4 old_length; 258 ub4 max_length; 259 zend_long type; 260 } array; 261 sb2 indicator; /* -1 means NULL */ 262 ub2 retcode; 263 ub4 dummy_len; /* a dummy var to store alenpp value in bind OUT callback */ 264 } php_oci_bind; 265 /* }}} */ 266 267 /* {{{ php_oci_out_column */ 268 typedef struct { 269 php_oci_statement *statement; /* statement handle. used when fetching REFCURSORS */ 270 php_oci_statement *nested_statement; /* statement handle. used when fetching REFCURSORS */ 271 OCIDefine *oci_define; /* define handle */ 272 char *name; /* column name */ 273 ub4 name_len; /* column name length */ 274 ub2 data_type; /* column data type */ 275 ub2 data_size; /* data size */ 276 ub4 storage_size4; /* size used when allocating buffers */ 277 sb2 indicator; 278 ub2 retcode; /* code returned when fetching this particular column */ 279 ub2 retlen; 280 ub4 retlen4; 281 ub2 is_descr; /* column contains a descriptor */ 282 ub2 is_cursor; /* column contains a cursor */ 283 zend_resource *stmtid; /* statement id for cursors */ 284 zend_resource *descid; /* descriptor id for descriptors */ 285 void *data; 286 php_oci_define *define; /* define handle */ 287 int piecewise; /* column is fetched piece-by-piece */ 288 ub4 cb_retlen; 289 sb1 scale; /* column scale */ 290 sb2 precision; /* column precision */ 291 ub1 charset_form; /* charset form, required for NCLOBs */ 292 ub2 charset_id; /* charset ID */ 293 ub4 chunk_size; /* LOB chunk size */ 294 } php_oci_out_column; 295 /* }}} */ 296 297 /* {{{ macros */ 298 299 #define PHP_OCI_CALL(func, params) \ 300 do { \ 301 OCI_G(in_call) = 1; \ 302 func params; \ 303 OCI_G(in_call) = 0; \ 304 } while (0) 305 306 #define PHP_OCI_CALL_RETURN(__retval, func, params) \ 307 do { \ 308 OCI_G(in_call) = 1; \ 309 __retval = func params; \ 310 OCI_G(in_call) = 0; \ 311 } while (0) 312 313 /* Check for errors that indicate the connection to the DB is no 314 * longer valid. If it isn't, then the PHP connection is marked to be 315 * reopened by the next PHP OCI8 connect command. This is most useful 316 * for persistent connections. The error number list is not 317 * exclusive. The error number comparisons and the 318 * OCI_ATTR_SERVER_STATUS check are done for maximum cross-version 319 * compatibility. In the far future, only the attribute check will be 320 * needed. 321 */ 322 #define PHP_OCI_HANDLE_ERROR(connection, errcode) \ 323 do { \ 324 ub4 serverStatus = OCI_SERVER_NORMAL; \ 325 switch (errcode) { \ 326 case 1013: \ 327 zend_bailout(); \ 328 break; \ 329 case 22: \ 330 case 28: \ 331 case 378: \ 332 case 602: \ 333 case 603: \ 334 case 604: \ 335 case 609: \ 336 case 1012: \ 337 case 1033: \ 338 case 1041: \ 339 case 1043: \ 340 case 1089: \ 341 case 1090: \ 342 case 1092: \ 343 case 3113: \ 344 case 3114: \ 345 case 3122: \ 346 case 3135: \ 347 case 3136: \ 348 case 12153: \ 349 case 12161: \ 350 case 27146: \ 351 case 28511: \ 352 (connection)->is_open = 0; \ 353 break; \ 354 default: \ 355 { \ 356 PHP_OCI_CALL(OCIAttrGet, ((dvoid *)(connection)->server, OCI_HTYPE_SERVER, (dvoid *)&serverStatus, \ 357 (ub4 *)0, OCI_ATTR_SERVER_STATUS, (connection)->err)); \ 358 if (serverStatus != OCI_SERVER_NORMAL) { \ 359 (connection)->is_open = 0; \ 360 } \ 361 } \ 362 break; \ 363 } \ 364 php_oci_dtrace_check_connection(connection, errcode, serverStatus); \ 365 } while (0) 366 367 #define PHP_OCI_REGISTER_RESOURCE(resource, le_resource) \ 368 do { \ 369 resource->id = zend_register_resource(resource, le_resource); \ 370 } while (0) 371 372 #define PHP_OCI_ZVAL_TO_CONNECTION(zval, connection) \ 373 if ((connection = (php_oci_connection *)zend_fetch_resource2(Z_RES_P(zval), "oci8 connection", le_connection, le_pconnection)) == NULL) { \ 374 RETURN_FALSE; \ 375 } 376 377 #define PHP_OCI_ZVAL_TO_STATEMENT(zval, statement) \ 378 if ((statement = (php_oci_statement *)zend_fetch_resource(Z_RES_P(zval), "oci8 statement", le_statement)) == NULL) { \ 379 RETURN_FALSE; \ 380 } 381 382 #define PHP_OCI_ZVAL_TO_DESCRIPTOR(zval, descriptor) \ 383 if ((descriptor = (php_oci_descriptor *)zend_fetch_resource(Z_RES_P(zval), "oci8 descriptor", le_descriptor)) == NULL) { \ 384 RETURN_FALSE; \ 385 } 386 387 #define PHP_OCI_ZVAL_TO_COLLECTION(zval, collection) \ 388 if ((collection = (php_oci_collection *)zend_fetch_resource(Z_RES_P(zval), "oci8 collection", le_collection)) == NULL) { \ 389 RETURN_FALSE; \ 390 } 391 392 #define PHP_OCI_FETCH_RESOURCE_EX(zval, var, type, name, resource_type) \ 393 do { \ 394 var = (type) zend_fetch_resource(Z_RES_P(zval), name, resource_type); \ 395 if (!var) { \ 396 return 1; \ 397 } \ 398 } while (0) 399 400 #define PHP_OCI_ZVAL_TO_CONNECTION_EX(zval, connection) \ 401 PHP_OCI_FETCH_RESOURCE_EX(zval, connection, php_oci_connection *, "oci8 connection", le_connection) 402 403 #define PHP_OCI_ZVAL_TO_STATEMENT_EX(zval, statement) \ 404 PHP_OCI_FETCH_RESOURCE_EX(zval, statement, php_oci_statement *, "oci8 statement", le_statement) 405 406 #define PHP_OCI_ZVAL_TO_DESCRIPTOR_EX(zval, descriptor) \ 407 PHP_OCI_FETCH_RESOURCE_EX(zval, descriptor, php_oci_descriptor *, "oci8 descriptor", le_descriptor) 408 409 #define PHP_OCI_ZVAL_TO_COLLECTION_EX(zval, collection) \ 410 PHP_OCI_FETCH_RESOURCE_EX(zval, collection, php_oci_collection *, "oci8 collection", le_collection) 411 412 /* }}} */ 413 414 /* PROTOS */ 415 416 /* {{{ main prototypes */ 417 418 void php_oci_column_hash_dtor(zval *data); 419 void php_oci_define_hash_dtor(zval *data); 420 void php_oci_bind_hash_dtor(zval *data); 421 void php_oci_descriptor_flush_hash_dtor(zval *data); 422 void php_oci_connection_descriptors_free(php_oci_connection *connection); 423 sb4 php_oci_error(OCIError *err_p, sword status); 424 sb4 php_oci_fetch_errmsg(OCIError *error_handle, text *error_buf, size_t error_buf_size); 425 int php_oci_fetch_sqltext_offset(php_oci_statement *statement, text **sqltext, ub2 *error_offset); 426 void php_oci_do_connect(INTERNAL_FUNCTION_PARAMETERS, int persistent, int exclusive); 427 php_oci_connection *php_oci_do_connect_ex(char *username, int username_len, char *password, int password_len, char *new_password, int new_password_len, char *dbname, int dbname_len, char *charset, zend_long session_mode, int persistent, int exclusive); 428 int php_oci_connection_rollback(php_oci_connection *connection); 429 int php_oci_connection_commit(php_oci_connection *connection); 430 int php_oci_connection_release(php_oci_connection *connection); 431 int php_oci_password_change(php_oci_connection *connection, char *user, int user_len, char *pass_old, int pass_old_len, char *pass_new, int pass_new_len); 432 void php_oci_client_get_version(char *version, size_t version_size); 433 int php_oci_server_get_version(php_oci_connection *connection, char *version, size_t version_size); 434 void php_oci_fetch_row(INTERNAL_FUNCTION_PARAMETERS, int mode, int expected_args); 435 int php_oci_column_to_zval(php_oci_out_column *column, zval *value, int mode); 436 void php_oci_dtrace_check_connection(php_oci_connection *connection, sb4 errcode, ub4 serverStatus); 437 438 /* }}} */ 439 440 /* {{{ lob related prototypes */ 441 442 php_oci_descriptor *php_oci_lob_create(php_oci_connection *connection, zend_long type); 443 int php_oci_lob_get_length(php_oci_descriptor *descriptor, ub4 *length); 444 int php_oci_lob_read(php_oci_descriptor *descriptor, zend_long read_length, zend_long inital_offset, char **data, ub4 *data_len); 445 int php_oci_lob_write(php_oci_descriptor *descriptor, ub4 offset, char *data, int data_len, ub4 *bytes_written); 446 int php_oci_lob_flush(php_oci_descriptor *descriptor, zend_long flush_flag); 447 int php_oci_lob_set_buffering(php_oci_descriptor *descriptor, int on_off); 448 int php_oci_lob_get_buffering(php_oci_descriptor *descriptor); 449 int php_oci_lob_copy(php_oci_descriptor *descriptor, php_oci_descriptor *descriptor_from, zend_long length); 450 int php_oci_lob_close(php_oci_descriptor *descriptor); 451 int php_oci_temp_lob_close(php_oci_descriptor *descriptor); 452 int php_oci_lob_write_tmp(php_oci_descriptor *descriptor, zend_long type, char *data, int data_len); 453 void php_oci_lob_free(php_oci_descriptor *descriptor); 454 int php_oci_lob_import(php_oci_descriptor *descriptor, char *filename); 455 int php_oci_lob_append(php_oci_descriptor *descriptor_dest, php_oci_descriptor *descriptor_from); 456 int php_oci_lob_truncate(php_oci_descriptor *descriptor, zend_long new_lob_length); 457 int php_oci_lob_erase(php_oci_descriptor *descriptor, zend_long offset, ub4 length, ub4 *bytes_erased); 458 int php_oci_lob_is_equal(php_oci_descriptor *descriptor_first, php_oci_descriptor *descriptor_second, boolean *result); 459 sb4 php_oci_lob_callback(dvoid *ctxp, CONST dvoid *bufxp, oraub8 len, ub1 piece, dvoid **changed_bufpp, oraub8 *changed_lenp); 460 /* }}} */ 461 462 /* {{{ collection related prototypes */ 463 464 php_oci_collection *php_oci_collection_create(php_oci_connection *connection, char *tdo, int tdo_len, char *schema, int schema_len); 465 int php_oci_collection_size(php_oci_collection *collection, sb4 *size); 466 int php_oci_collection_max(php_oci_collection *collection, zend_long *max); 467 int php_oci_collection_trim(php_oci_collection *collection, zend_long trim_size); 468 int php_oci_collection_append(php_oci_collection *collection, char *element, int element_len); 469 int php_oci_collection_element_get(php_oci_collection *collection, zend_long index, zval *result_element); 470 int php_oci_collection_element_set(php_oci_collection *collection, zend_long index, char *value, int value_len); 471 int php_oci_collection_element_set_null(php_oci_collection *collection, zend_long index); 472 int php_oci_collection_element_set_date(php_oci_collection *collection, zend_long index, char *date, int date_len); 473 int php_oci_collection_element_set_number(php_oci_collection *collection, zend_long index, char *number, int number_len); 474 int php_oci_collection_element_set_string(php_oci_collection *collection, zend_long index, char *element, int element_len); 475 int php_oci_collection_assign(php_oci_collection *collection_dest, php_oci_collection *collection_from); 476 void php_oci_collection_close(php_oci_collection *collection); 477 int php_oci_collection_append_null(php_oci_collection *collection); 478 int php_oci_collection_append_date(php_oci_collection *collection, char *date, int date_len); 479 int php_oci_collection_append_number(php_oci_collection *collection, char *number, int number_len); 480 int php_oci_collection_append_string(php_oci_collection *collection, char *element, int element_len); 481 482 483 /* }}} */ 484 485 /* {{{ statement related prototypes */ 486 487 php_oci_statement *php_oci_statement_create(php_oci_connection *connection, char *query, int query_len); 488 php_oci_statement *php_oci_get_implicit_resultset(php_oci_statement *statement); 489 int php_oci_statement_set_prefetch(php_oci_statement *statement, ub4 prefetch); 490 int php_oci_statement_fetch(php_oci_statement *statement, ub4 nrows); 491 php_oci_out_column *php_oci_statement_get_column(php_oci_statement *statement, zend_long column_index, char *column_name, int column_name_len); 492 int php_oci_statement_execute(php_oci_statement *statement, ub4 mode); 493 int php_oci_statement_cancel(php_oci_statement *statement); 494 void php_oci_statement_free(php_oci_statement *statement); 495 int php_oci_bind_pre_exec(zval *data, void *result); 496 int php_oci_bind_post_exec(zval *data); 497 int php_oci_bind_by_name(php_oci_statement *statement, char *name, size_t name_len, zval *var, zend_long maxlength, ub2 type); 498 sb4 php_oci_bind_in_callback(dvoid *ictxp, OCIBind *bindp, ub4 iter, ub4 index, dvoid **bufpp, ub4 *alenp, ub1 *piecep, dvoid **indpp); 499 sb4 php_oci_bind_out_callback(dvoid *octxp, OCIBind *bindp, ub4 iter, ub4 index, dvoid **bufpp, ub4 **alenpp, ub1 *piecep, dvoid **indpp, ub2 **rcodepp); 500 php_oci_out_column *php_oci_statement_get_column_helper(INTERNAL_FUNCTION_PARAMETERS, int need_data); 501 int php_oci_cleanup_pre_fetch(zval *data); 502 int php_oci_statement_get_type(php_oci_statement *statement, ub2 *type); 503 int php_oci_statement_get_numrows(php_oci_statement *statement, ub4 *numrows); 504 int php_oci_bind_array_by_name(php_oci_statement *statement, char *name, size_t name_len, zval *var, zend_long max_table_length, zend_long maxlength, zend_long type); 505 php_oci_bind *php_oci_bind_array_helper_number(zval *var, zend_long max_table_length); 506 php_oci_bind *php_oci_bind_array_helper_double(zval *var, zend_long max_table_length); 507 php_oci_bind *php_oci_bind_array_helper_string(zval *var, zend_long max_table_length, zend_long maxlength); 508 php_oci_bind *php_oci_bind_array_helper_date(zval *var, zend_long max_table_length, php_oci_connection *connection); 509 510 /* }}} */ 511 512 ZEND_BEGIN_MODULE_GLOBALS(oci) /* {{{ Module globals */ 513 sb4 errcode; /* global last ORA- error number. Used when connect fails, for example */ 514 OCIError *err; /* global error handle */ 515 516 zend_long max_persistent; /* maximum number of persistent connections per process */ 517 zend_long num_persistent; /* number of existing persistent connections */ 518 zend_long num_links; /* non-persistent + persistent connections */ 519 zend_long num_statements; /* number of statements open */ 520 zend_long ping_interval; /* time interval between pings */ 521 zend_long persistent_timeout; /* time period after which idle persistent connection is considered expired */ 522 zend_long statement_cache_size; /* statement cache size. used with 9i+ clients only*/ 523 zend_long default_prefetch; /* default prefetch setting */ 524 zend_bool privileged_connect; /* privileged connect flag (On/Off) */ 525 zend_bool old_oci_close_semantics; /* old_oci_close_semantics flag (to determine the way oci_close() should behave) */ 526 527 int shutdown; /* in shutdown flag */ 528 529 OCIEnv *env; /* global environment handle */ 530 531 zend_bool in_call; 532 char *connection_class; 533 zend_bool events; 534 char *edition; 535 ZEND_END_MODULE_GLOBALS(oci) /* }}} */ 536 537 /* {{{ transparent failover related prototypes */ 538 539 int php_oci_register_taf_callback(php_oci_connection *connection, zval *callback); 540 int php_oci_unregister_taf_callback(php_oci_connection *connection); 541 542 /* }}} */ 543 544 #ifdef ZTS 545 #define OCI_G(v) TSRMG(oci_globals_id, zend_oci_globals *, v) 546 #else 547 #define OCI_G(v) (oci_globals.v) 548 #endif 549 550 /* Allow install from PECL on PHP < 7.3 */ 551 #ifndef GC_ADDREF 552 # define GC_ADDREF(p) (++GC_REFCOUNT(p)) 553 #endif 554 #ifndef GC_DELREF 555 # define GC_DELREF(p) (GC_REFCOUNT(p)--) 556 #endif 557 558 ZEND_EXTERN_MODULE_GLOBALS(oci) 559 560 # endif /* !PHP_OCI8_INT_H */ 561 #else /* !HAVE_OCI8 */ 562 563 # define oci8_module_ptr NULL 564 565 #endif /* HAVE_OCI8 */ 566 567 /* 568 * Local variables: 569 * tab-width: 4 570 * c-basic-offset: 4 571 * End: 572 * vim600: noet sw=4 ts=4 fdm=marker 573 * vim<600: noet sw=4 ts=4 574 */ 575
