php_oci8_int.h 25 KB

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