xref: /PHP-7.1/main/php.h (revision ccd4716e)
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: Andi Gutmans <andi@zend.com>                                |
16    |          Zeev Suraski <zeev@zend.com>                                |
17    +----------------------------------------------------------------------+
18  */
19 
20 /* $Id$ */
21 
22 #ifndef PHP_H
23 #define PHP_H
24 
25 #ifdef HAVE_DMALLOC
26 #include <dmalloc.h>
27 #endif
28 
29 #define PHP_API_VERSION 20160303
30 #define PHP_HAVE_STREAMS
31 #define YYDEBUG 0
32 #define PHP_DEFAULT_CHARSET "UTF-8"
33 
34 #include "php_version.h"
35 #include "zend.h"
36 #include "zend_sort.h"
37 #include "php_compat.h"
38 
39 #include "zend_API.h"
40 
41 #undef sprintf
42 #define sprintf php_sprintf
43 
44 /* PHP's DEBUG value must match Zend's ZEND_DEBUG value */
45 #undef PHP_DEBUG
46 #define PHP_DEBUG ZEND_DEBUG
47 
48 #ifdef PHP_WIN32
49 #	include "tsrm_win32.h"
50 #	include "win95nt.h"
51 #	ifdef PHP_EXPORTS
52 #		define PHPAPI __declspec(dllexport)
53 #	else
54 #		define PHPAPI __declspec(dllimport)
55 #	endif
56 #	define PHP_DIR_SEPARATOR '\\'
57 #	define PHP_EOL "\r\n"
58 #else
59 #	if defined(__GNUC__) && __GNUC__ >= 4
60 #		define PHPAPI __attribute__ ((visibility("default")))
61 #	else
62 #		define PHPAPI
63 #	endif
64 #	define THREAD_LS
65 #	define PHP_DIR_SEPARATOR '/'
66 #	define PHP_EOL "\n"
67 #endif
68 
69 #ifdef NETWARE
70 /* For php_get_uname() function */
71 #define PHP_UNAME  "NetWare"
72 #define PHP_OS      PHP_UNAME
73 #endif
74 
75 #if HAVE_ASSERT_H
76 #if PHP_DEBUG
77 #undef NDEBUG
78 #else
79 #ifndef NDEBUG
80 #define NDEBUG
81 #endif
82 #endif
83 #include <assert.h>
84 #else /* HAVE_ASSERT_H */
85 #define assert(expr) ((void) (0))
86 #endif /* HAVE_ASSERT_H */
87 
88 #define APACHE 0
89 
90 #if HAVE_UNIX_H
91 #include <unix.h>
92 #endif
93 
94 #if HAVE_ALLOCA_H
95 #include <alloca.h>
96 #endif
97 
98 #if HAVE_BUILD_DEFS_H
99 #include <build-defs.h>
100 #endif
101 
102 /*
103  * This is a fast version of strlcpy which should be used, if you
104  * know the size of the destination buffer and if you know
105  * the length of the source string.
106  *
107  * size is the allocated number of bytes of dst
108  * src_size is the number of bytes excluding the NUL of src
109  */
110 
111 #define PHP_STRLCPY(dst, src, size, src_size)	\
112 	{											\
113 		size_t php_str_len;						\
114 												\
115 		if (src_size >= size)					\
116 			php_str_len = size - 1;				\
117 		else									\
118 			php_str_len = src_size;				\
119 		memcpy(dst, src, php_str_len);			\
120 		dst[php_str_len] = '\0';				\
121 	}
122 
123 #ifndef HAVE_STRLCPY
124 BEGIN_EXTERN_C()
125 PHPAPI size_t php_strlcpy(char *dst, const char *src, size_t siz);
126 END_EXTERN_C()
127 #undef strlcpy
128 #define strlcpy php_strlcpy
129 #endif
130 
131 #ifndef HAVE_STRLCAT
132 BEGIN_EXTERN_C()
133 PHPAPI size_t php_strlcat(char *dst, const char *src, size_t siz);
134 END_EXTERN_C()
135 #undef strlcat
136 #define strlcat php_strlcat
137 #endif
138 
139 #ifndef HAVE_STRTOK_R
140 BEGIN_EXTERN_C()
141 char *strtok_r(char *s, const char *delim, char **last);
142 END_EXTERN_C()
143 #endif
144 
145 #ifndef HAVE_SOCKLEN_T
146 # ifdef PHP_WIN32
147 typedef int socklen_t;
148 # else
149 typedef unsigned int socklen_t;
150 # endif
151 #endif
152 
153 #define CREATE_MUTEX(a, b)
154 #define SET_MUTEX(a)
155 #define FREE_MUTEX(a)
156 
157 /*
158  * Then the ODBC support can use both iodbc and Solid,
159  * uncomment this.
160  * #define HAVE_ODBC (HAVE_IODBC|HAVE_SOLID)
161  */
162 
163 #include <stdlib.h>
164 #include <ctype.h>
165 #if HAVE_UNISTD_H
166 #include <unistd.h>
167 #endif
168 #if HAVE_STDARG_H
169 #include <stdarg.h>
170 #else
171 # if HAVE_SYS_VARARGS_H
172 # include <sys/varargs.h>
173 # endif
174 #endif
175 
176 #ifndef va_copy
177 # ifdef __va_copy
178 #  define va_copy(ap1, ap2)         __va_copy((ap1), (ap2))
179 # else
180 #  define va_copy(ap1, ap2)         memcpy((&ap1), (&ap2), sizeof(va_list))
181 # endif
182 #endif
183 
184 #include "php_stdint.h"
185 
186 #include "zend_hash.h"
187 #include "zend_alloc.h"
188 #include "zend_stack.h"
189 
190 #if STDC_HEADERS
191 # include <string.h>
192 #else
193 # ifndef HAVE_MEMCPY
194 #  define memcpy(d, s, n)	bcopy((s), (d), (n))
195 # endif
196 # ifndef HAVE_MEMMOVE
197 #  define memmove(d, s, n)	bcopy ((s), (d), (n))
198 # endif
199 #endif
200 
201 #ifndef HAVE_STRERROR
202 char *strerror(int);
203 #endif
204 
205 #if HAVE_PWD_H
206 # ifdef PHP_WIN32
207 #include "win32/param.h"
208 # else
209 #include <pwd.h>
210 #include <sys/param.h>
211 # endif
212 #endif
213 
214 #if HAVE_LIMITS_H
215 #include <limits.h>
216 #endif
217 
218 #ifndef LONG_MAX
219 #define LONG_MAX 2147483647L
220 #endif
221 
222 #ifndef LONG_MIN
223 #define LONG_MIN (- LONG_MAX - 1)
224 #endif
225 
226 #ifndef INT_MAX
227 #define INT_MAX 2147483647
228 #endif
229 
230 #ifndef INT_MIN
231 #define INT_MIN (- INT_MAX - 1)
232 #endif
233 
234 /* double limits */
235 #include <float.h>
236 #if defined(DBL_MANT_DIG) && defined(DBL_MIN_EXP)
237 #define PHP_DOUBLE_MAX_LENGTH (3 + DBL_MANT_DIG - DBL_MIN_EXP)
238 #else
239 #define PHP_DOUBLE_MAX_LENGTH 1080
240 #endif
241 
242 #define PHP_GCC_VERSION ZEND_GCC_VERSION
243 #define PHP_ATTRIBUTE_MALLOC ZEND_ATTRIBUTE_MALLOC
244 #define PHP_ATTRIBUTE_FORMAT ZEND_ATTRIBUTE_FORMAT
245 
246 BEGIN_EXTERN_C()
247 #include "snprintf.h"
248 END_EXTERN_C()
249 #include "spprintf.h"
250 
251 #define EXEC_INPUT_BUF 4096
252 
253 #define PHP_MIME_TYPE "application/x-httpd-php"
254 
255 /* macros */
256 #define STR_PRINT(str)	((str)?(str):"")
257 
258 #ifndef MAXPATHLEN
259 # ifdef PHP_WIN32
260 #  include "win32/ioutil.h"
261 #  define MAXPATHLEN PHP_WIN32_IOUTIL_MAXPATHLEN
262 # elif PATH_MAX
263 #  define MAXPATHLEN PATH_MAX
264 # elif defined(MAX_PATH)
265 #  define MAXPATHLEN MAX_PATH
266 # else
267 #  define MAXPATHLEN 256    /* Should be safe for any weird systems that do not define it */
268 # endif
269 #endif
270 
271 #define php_ignore_value(x) ZEND_IGNORE_VALUE(x)
272 
273 /* global variables */
274 #if !defined(PHP_WIN32)
275 #define PHP_SLEEP_NON_VOID
276 #define php_sleep sleep
277 extern char **environ;
278 #endif	/* !defined(PHP_WIN32) */
279 
280 #ifdef PHP_PWRITE_64
281 ssize_t pwrite(int, void *, size_t, off64_t);
282 #endif
283 
284 #ifdef PHP_PREAD_64
285 ssize_t pread(int, void *, size_t, off64_t);
286 #endif
287 
288 BEGIN_EXTERN_C()
289 void phperror(char *error);
290 PHPAPI size_t php_write(void *buf, size_t size);
291 PHPAPI size_t php_printf(const char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 1,
292 		2);
293 PHPAPI int php_get_module_initialized(void);
294 #ifdef HAVE_SYSLOG_H
295 #include "php_syslog.h"
296 #define php_log_err(msg) php_log_err_with_severity(msg, LOG_NOTICE)
297 #else
298 #define php_log_err(msg) php_log_err_with_severity(msg, 5)
299 #endif
300 PHPAPI ZEND_COLD void php_log_err_with_severity(char *log_message, int syslog_type_int);
301 int Debug(char *format, ...) PHP_ATTRIBUTE_FORMAT(printf, 1, 2);
302 int cfgparse(void);
303 END_EXTERN_C()
304 
305 #define php_error zend_error
306 #define error_handling_t zend_error_handling_t
307 
BEGIN_EXTERN_C()308 BEGIN_EXTERN_C()
309 static inline ZEND_ATTRIBUTE_DEPRECATED void php_set_error_handling(error_handling_t error_handling, zend_class_entry *exception_class)
310 {
311 	zend_replace_error_handling(error_handling, exception_class, NULL);
312 }
php_std_error_handling()313 static inline ZEND_ATTRIBUTE_DEPRECATED void php_std_error_handling() {}
314 
315 PHPAPI ZEND_COLD void php_verror(const char *docref, const char *params, int type, const char *format, va_list args) PHP_ATTRIBUTE_FORMAT(printf, 4, 0);
316 
317 /* PHPAPI void php_error(int type, const char *format, ...); */
318 PHPAPI ZEND_COLD void php_error_docref0(const char *docref, int type, const char *format, ...)
319 	PHP_ATTRIBUTE_FORMAT(printf, 3, 4);
320 PHPAPI ZEND_COLD void php_error_docref1(const char *docref, const char *param1, int type, const char *format, ...)
321 	PHP_ATTRIBUTE_FORMAT(printf, 4, 5);
322 PHPAPI ZEND_COLD void php_error_docref2(const char *docref, const char *param1, const char *param2, int type, const char *format, ...)
323 	PHP_ATTRIBUTE_FORMAT(printf, 5, 6);
324 #ifdef PHP_WIN32
325 PHPAPI ZEND_COLD void php_win32_docref2_from_error(DWORD error, const char *param1, const char *param2);
326 #endif
327 END_EXTERN_C()
328 
329 #define php_error_docref php_error_docref0
330 
331 #define zenderror phperror
332 #define zendlex phplex
333 
334 #define phpparse zendparse
335 #define phprestart zendrestart
336 #define phpin zendin
337 
338 #define php_memnstr zend_memnstr
339 
340 /* functions */
341 BEGIN_EXTERN_C()
342 PHPAPI extern int (*php_register_internal_extensions_func)(void);
343 PHPAPI int php_register_internal_extensions(void);
344 PHPAPI int php_mergesort(void *base, size_t nmemb, size_t size, int (*cmp)(const void *, const void *));
345 PHPAPI void php_register_pre_request_shutdown(void (*func)(void *), void *userdata);
346 PHPAPI void php_com_initialize(void);
347 PHPAPI char *php_get_current_user(void);
348 END_EXTERN_C()
349 
350 /* PHP-named Zend macro wrappers */
351 #define PHP_FN					ZEND_FN
352 #define PHP_MN					ZEND_MN
353 #define PHP_NAMED_FUNCTION		ZEND_NAMED_FUNCTION
354 #define PHP_FUNCTION			ZEND_FUNCTION
355 #define PHP_METHOD  			ZEND_METHOD
356 
357 #define PHP_RAW_NAMED_FE ZEND_RAW_NAMED_FE
358 #define PHP_NAMED_FE	ZEND_NAMED_FE
359 #define PHP_FE			ZEND_FE
360 #define PHP_DEP_FE      ZEND_DEP_FE
361 #define PHP_FALIAS		ZEND_FALIAS
362 #define PHP_DEP_FALIAS	ZEND_DEP_FALIAS
363 #define PHP_ME          ZEND_ME
364 #define PHP_MALIAS      ZEND_MALIAS
365 #define PHP_ABSTRACT_ME ZEND_ABSTRACT_ME
366 #define PHP_ME_MAPPING  ZEND_ME_MAPPING
367 #define PHP_FE_END      ZEND_FE_END
368 
369 #define PHP_MODULE_STARTUP_N	ZEND_MODULE_STARTUP_N
370 #define PHP_MODULE_SHUTDOWN_N	ZEND_MODULE_SHUTDOWN_N
371 #define PHP_MODULE_ACTIVATE_N	ZEND_MODULE_ACTIVATE_N
372 #define PHP_MODULE_DEACTIVATE_N	ZEND_MODULE_DEACTIVATE_N
373 #define PHP_MODULE_INFO_N		ZEND_MODULE_INFO_N
374 
375 #define PHP_MODULE_STARTUP_D	ZEND_MODULE_STARTUP_D
376 #define PHP_MODULE_SHUTDOWN_D	ZEND_MODULE_SHUTDOWN_D
377 #define PHP_MODULE_ACTIVATE_D	ZEND_MODULE_ACTIVATE_D
378 #define PHP_MODULE_DEACTIVATE_D	ZEND_MODULE_DEACTIVATE_D
379 #define PHP_MODULE_INFO_D		ZEND_MODULE_INFO_D
380 
381 /* Compatibility macros */
382 #define PHP_MINIT		ZEND_MODULE_STARTUP_N
383 #define PHP_MSHUTDOWN	ZEND_MODULE_SHUTDOWN_N
384 #define PHP_RINIT		ZEND_MODULE_ACTIVATE_N
385 #define PHP_RSHUTDOWN	ZEND_MODULE_DEACTIVATE_N
386 #define PHP_MINFO		ZEND_MODULE_INFO_N
387 #define PHP_GINIT		ZEND_GINIT
388 #define PHP_GSHUTDOWN	ZEND_GSHUTDOWN
389 
390 #define PHP_MINIT_FUNCTION		ZEND_MODULE_STARTUP_D
391 #define PHP_MSHUTDOWN_FUNCTION	ZEND_MODULE_SHUTDOWN_D
392 #define PHP_RINIT_FUNCTION		ZEND_MODULE_ACTIVATE_D
393 #define PHP_RSHUTDOWN_FUNCTION	ZEND_MODULE_DEACTIVATE_D
394 #define PHP_MINFO_FUNCTION		ZEND_MODULE_INFO_D
395 #define PHP_GINIT_FUNCTION		ZEND_GINIT_FUNCTION
396 #define PHP_GSHUTDOWN_FUNCTION	ZEND_GSHUTDOWN_FUNCTION
397 
398 #define PHP_MODULE_GLOBALS		ZEND_MODULE_GLOBALS
399 
400 
401 /* Output support */
402 #include "main/php_output.h"
403 
404 
405 #include "php_streams.h"
406 #include "php_memory_streams.h"
407 #include "fopen_wrappers.h"
408 
409 
410 /* Virtual current working directory support */
411 #include "zend_virtual_cwd.h"
412 
413 #include "zend_constants.h"
414 
415 /* connection status states */
416 #define PHP_CONNECTION_NORMAL  0
417 #define PHP_CONNECTION_ABORTED 1
418 #define PHP_CONNECTION_TIMEOUT 2
419 
420 #include "php_reentrancy.h"
421 
422 /* Finding offsets of elements within structures.
423  * Taken from the Apache code, which in turn, was taken from X code...
424  */
425 
426 #ifndef XtOffset
427 #if defined(CRAY) || (defined(__arm) && !(defined(LINUX) || defined(__riscos__)))
428 #ifdef __STDC__
429 #define XtOffset(p_type, field) _Offsetof(p_type, field)
430 #else
431 #ifdef CRAY2
432 #define XtOffset(p_type, field) \
433     (sizeof(int)*((unsigned int)&(((p_type)NULL)->field)))
434 
435 #else /* !CRAY2 */
436 
437 #define XtOffset(p_type, field) ((unsigned int)&(((p_type)NULL)->field))
438 
439 #endif /* !CRAY2 */
440 #endif /* __STDC__ */
441 #else /* ! (CRAY || __arm) */
442 
443 #define XtOffset(p_type, field) \
444     ((zend_long) (((char *) (&(((p_type)NULL)->field))) - ((char *) NULL)))
445 
446 #endif /* !CRAY */
447 #endif /* ! XtOffset */
448 
449 #ifndef XtOffsetOf
450 #ifdef offsetof
451 #define XtOffsetOf(s_type, field) offsetof(s_type, field)
452 #else
453 #define XtOffsetOf(s_type, field) XtOffset(s_type*, field)
454 #endif
455 #endif /* !XtOffsetOf */
456 
457 #endif
458 
459 /*
460  * Local variables:
461  * tab-width: 4
462  * c-basic-offset: 4
463  * End:
464  * vim600: sw=4 ts=4 fdm=marker
465  * vim<600: sw=4 ts=4
466  */
467