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