- use exceptions in constructors and HttpRequest::send()
[m6w6/ext-http] / http.c
1 /*
2 +----------------------------------------------------------------------+
3 | PECL :: http |
4 +----------------------------------------------------------------------+
5 | This source file is subject to version 3.0 of the PHP license, that |
6 | is bundled with this package in the file LICENSE, and is available |
7 | through the world-wide-web at http://www.php.net/license/3_0.txt. |
8 | If you did not receive a copy of the PHP license and are unable to |
9 | obtain it through the world-wide-web, please send a note to |
10 | license@php.net so we can mail you a copy immediately. |
11 +----------------------------------------------------------------------+
12 | Copyright (c) 2004-2005 Michael Wallner <mike@php.net> |
13 +----------------------------------------------------------------------+
14 */
15
16 /* $Id$ */
17
18
19 #ifdef HAVE_CONFIG_H
20 # include "config.h"
21 #endif
22
23 #ifdef HTTP_HAVE_CURL
24 # ifdef PHP_WIN32
25 # include <winsock2.h>
26 # endif
27 # include <curl/curl.h>
28 #endif
29
30 #include "php.h"
31 #include "php_ini.h"
32 #include "ext/standard/info.h"
33
34 #include "SAPI.h"
35
36 #include "php_http.h"
37 #include "php_http_std_defs.h"
38 #include "php_http_send_api.h"
39
40 #ifdef ZEND_ENGINE_2
41 # include "php_http_util_object.h"
42 # include "php_http_message_object.h"
43 # include "php_http_response_object.h"
44 # ifdef HTTP_HAVE_CURL
45 # include "php_http_request_object.h"
46 # endif
47 # include "php_http_exception_object.h"
48 #endif
49
50 #include "phpstr/phpstr.h"
51
52 #ifdef HTTP_HAVE_CURL
53 #ifdef ZEND_ENGINE_2
54 static
55 ZEND_BEGIN_ARG_INFO(http_request_info_ref_3, 0)
56 ZEND_ARG_PASS_INFO(0)
57 ZEND_ARG_PASS_INFO(0)
58 ZEND_ARG_PASS_INFO(1)
59 ZEND_END_ARG_INFO();
60
61 static
62 ZEND_BEGIN_ARG_INFO(http_request_info_ref_4, 0)
63 ZEND_ARG_PASS_INFO(0)
64 ZEND_ARG_PASS_INFO(0)
65 ZEND_ARG_PASS_INFO(0)
66 ZEND_ARG_PASS_INFO(1)
67 ZEND_END_ARG_INFO();
68 #else
69 static unsigned char http_request_info_ref_3[] = {3, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
70 static unsigned char http_request_info_ref_4[] = {4, BYREF_NONE, BYREF_NONE, BYREF_NONE, BYREF_FORCE};
71 #endif /* ZEND_ENGINE_2 */
72 #endif /* HTTP_HAVE_CURL */
73
74 ZEND_DECLARE_MODULE_GLOBALS(http)
75
76 #ifdef COMPILE_DL_HTTP
77 ZEND_GET_MODULE(http)
78 #endif
79
80 /* {{{ http_functions[] */
81 function_entry http_functions[] = {
82 PHP_FE(http_test, NULL)
83 PHP_FE(http_date, NULL)
84 PHP_FE(http_absolute_uri, NULL)
85 PHP_FE(http_negotiate_language, NULL)
86 PHP_FE(http_negotiate_charset, NULL)
87 PHP_FE(http_redirect, NULL)
88 PHP_FE(http_send_status, NULL)
89 PHP_FE(http_send_last_modified, NULL)
90 PHP_FE(http_send_content_type, NULL)
91 PHP_FE(http_send_content_disposition, NULL)
92 PHP_FE(http_match_modified, NULL)
93 PHP_FE(http_match_etag, NULL)
94 PHP_FE(http_cache_last_modified, NULL)
95 PHP_FE(http_cache_etag, NULL)
96 PHP_FE(http_send_data, NULL)
97 PHP_FE(http_send_file, NULL)
98 PHP_FE(http_send_stream, NULL)
99 PHP_FE(http_chunked_decode, NULL)
100 PHP_FE(http_split_response, NULL)
101 PHP_FE(http_parse_headers, NULL)
102 PHP_FE(http_get_request_headers, NULL)
103 #ifdef HTTP_HAVE_CURL
104 PHP_FE(http_get, http_request_info_ref_3)
105 PHP_FE(http_head, http_request_info_ref_3)
106 PHP_FE(http_post_data, http_request_info_ref_4)
107 PHP_FE(http_post_array, http_request_info_ref_4)
108 #endif
109 PHP_FE(http_auth_basic, NULL)
110 PHP_FE(http_auth_basic_cb, NULL)
111 #ifndef ZEND_ENGINE_2
112 PHP_FE(http_build_query, NULL)
113 #endif
114 PHP_FE(ob_httpetaghandler, NULL)
115 {NULL, NULL, NULL}
116 };
117 /* }}} */
118
119 /* {{{ http_module_entry */
120 zend_module_entry http_module_entry = {
121 #if ZEND_MODULE_API_NO >= 20010901
122 STANDARD_MODULE_HEADER,
123 #endif
124 "http",
125 http_functions,
126 PHP_MINIT(http),
127 PHP_MSHUTDOWN(http),
128 PHP_RINIT(http),
129 PHP_RSHUTDOWN(http),
130 PHP_MINFO(http),
131 #if ZEND_MODULE_API_NO >= 20010901
132 HTTP_PEXT_VERSION,
133 #endif
134 STANDARD_MODULE_PROPERTIES
135 };
136 /* }}} */
137
138
139 static void free_to_free(void *s)
140 {
141 efree(*(char **)s);
142 }
143
144 /* {{{ php_http_init_globals(zend_http_globals *) */
145 static void php_http_init_globals(zend_http_globals *http_globals)
146 {
147 http_globals->etag_started = 0;
148 http_globals->ctype = NULL;
149 http_globals->etag = NULL;
150 http_globals->lmod = 0;
151 #ifdef HTTP_HAVE_CURL
152 phpstr_init_ex(&http_globals->curlbuf, HTTP_CURLBUF_SIZE, 0);
153 # if LIBCURL_VERSION_NUM < 0x070c00
154 memset(&http_globals->curlerr, 0, sizeof(http_globals->curlerr));
155 # endif
156 zend_llist_init(&http_globals->to_free, sizeof(char *), free_to_free, 0);
157 #endif
158 http_globals->allowed_methods = NULL;
159 }
160 /* }}} */
161
162 /* {{{ static inline STATUS http_check_allowed_methods(char *, int) */
163 #define http_check_allowed_methods(m, l) _http_check_allowed_methods((m), (l) TSRMLS_CC)
164 static inline void _http_check_allowed_methods(char *methods, int length TSRMLS_DC)
165 {
166 if (length && SG(request_info).request_method && (!strstr(methods, SG(request_info).request_method))) {
167 char *allow_header = emalloc(length + sizeof("Allow: "));
168 sprintf(allow_header, "Allow: %s", methods);
169 http_send_header(allow_header);
170 efree(allow_header);
171 http_send_status(405);
172 zend_bailout();
173 }
174 }
175 /* }}} */
176
177 /* {{{ PHP_INI */
178 PHP_INI_MH(update_allowed_methods)
179 {
180 http_check_allowed_methods(new_value, new_value_length);
181 return OnUpdateString(entry, new_value, new_value_length, mh_arg1, mh_arg2, mh_arg3, stage TSRMLS_CC);
182 }
183
184 PHP_INI_BEGIN()
185 STD_PHP_INI_ENTRY("http.allowed_methods",
186 /* HTTP 1.1 */
187 "GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, CONNECT, "
188 /* WebDAV - RFC 2518 * /
189 "PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, "
190 /* WebDAV Versioning - RFC 3253 * /
191 "VERSION-CONTROL, REPORT, CHECKOUT, CHECKIN, UNCHECKOUT, "
192 "MKWORKSPACE, UPDATE, LABEL, MERGE, BASELINE-CONTROL, MKACTIVITY, "
193 /* WebDAV Access Control - RFC 3744 * /
194 "ACL, "
195 /* END */
196 ,
197 PHP_INI_ALL, update_allowed_methods, allowed_methods, zend_http_globals, http_globals)
198 PHP_INI_END()
199 /* }}} */
200
201 /* {{{ HTTP_CURL_USE_ZEND_MM */
202 #if defined(HTTP_HAVE_CURL) && defined(HTTP_CURL_USE_ZEND_MM)
203 static void http_curl_free(void *p) { efree(p); }
204 static char *http_curl_strdup(const char *p) { return estrdup(p); }
205 static void *http_curl_malloc(size_t s) { return emalloc(s); }
206 static void *http_curl_realloc(void *p, size_t s) { return erealloc(p, s); }
207 static void *http_curl_calloc(size_t n, size_t s) { return ecalloc(n, s); }
208 #endif /* HTTP_HAVE_CURL && HTTP_CURL_USE_ZEND_MM */
209 /* }}} */
210
211 /* {{{ PHP_MINIT_FUNCTION */
212 PHP_MINIT_FUNCTION(http)
213 {
214 ZEND_INIT_MODULE_GLOBALS(http, php_http_init_globals, NULL);
215 REGISTER_INI_ENTRIES();
216
217 #ifdef HTTP_HAVE_CURL
218 # ifdef HTTP_CURL_USE_ZEND_MM
219 if (CURLE_OK != curl_global_init_mem(CURL_GLOBAL_ALL,
220 http_curl_malloc,
221 http_curl_free,
222 http_curl_realloc,
223 http_curl_strdup,
224 http_curl_calloc)) {
225 return FAILURE;
226 }
227 # endif /* HTTP_CURL_USE_ZEND_MM */
228 #endif /* HTTP_HAVE_CURL */
229
230 #ifdef ZEND_ENGINE_2
231 http_util_object_init(INIT_FUNC_ARGS_PASSTHRU);
232 http_message_object_init(INIT_FUNC_ARGS_PASSTHRU);
233 http_response_object_init(INIT_FUNC_ARGS_PASSTHRU);
234 # ifdef HTTP_HAVE_CURL
235 http_request_object_init(INIT_FUNC_ARGS_PASSTHRU);
236 # endif /* HTTP_HAVE_CURL */
237 http_exception_object_init(INIT_FUNC_ARGS_PASSTHRU);
238 #endif /* ZEND_ENGINE_2 */
239
240 return SUCCESS;
241 }
242 /* }}} */
243
244 /* {{{ PHP_MSHUTDOWN_FUNCTION */
245 PHP_MSHUTDOWN_FUNCTION(http)
246 {
247 UNREGISTER_INI_ENTRIES();
248 #ifdef HTTP_HAVE_CURL
249 phpstr_dtor(&HTTP_G(curlbuf));
250 curl_global_cleanup();
251 #endif
252 return SUCCESS;
253 }
254 /* }}} */
255
256 /* {{{ PHP_RINIT_FUNCTION */
257 PHP_RINIT_FUNCTION(http)
258 {
259 char *allowed_methods = INI_STR("http.allowed_methods");
260 http_check_allowed_methods(allowed_methods, strlen(allowed_methods));
261 return SUCCESS;
262 }
263 /* }}} */
264
265 /* {{{ PHP_RSHUTDOWN_FUNCTION */
266 PHP_RSHUTDOWN_FUNCTION(http)
267 {
268 HTTP_G(etag_started) = 0;
269 HTTP_G(lmod) = 0;
270
271 if (HTTP_G(etag)) {
272 efree(HTTP_G(etag));
273 HTTP_G(etag) = NULL;
274 }
275
276 if (HTTP_G(ctype)) {
277 efree(HTTP_G(ctype));
278 HTTP_G(ctype) = NULL;
279 }
280
281 #ifdef HTTP_HAVE_CURL
282 # if LIBCURL_VERSION_NUM < 0x070c00
283 memset(&HTTP_G(curlerr), 0, sizeof(HTTP_G(curlerr)));
284 # endif
285 phpstr_dtor(&HTTP_G(curlbuf));
286 #endif
287
288 return SUCCESS;
289 }
290 /* }}} */
291
292 /* {{{ PHP_MINFO_FUNCTION */
293 PHP_MINFO_FUNCTION(http)
294 {
295 #ifdef ZEND_ENGINE_2
296 # define HTTP_FUNC_AVAIL(CLASS) "procedural, object oriented (class " CLASS ")"
297 #else
298 # define HTTP_FUNC_AVAIL(CLASS) "procedural"
299 #endif
300
301 #ifdef HTTP_HAVE_CURL
302 # define HTTP_CURL_VERSION curl_version()
303 # ifdef ZEND_ENGINE_2
304 # define HTTP_CURL_AVAIL(CLASS) "procedural, object oriented (class " CLASS ")"
305 # else
306 # define HTTP_CURL_AVAIL(CLASS) "procedural"
307 # endif
308 #else
309 # define HTTP_CURL_VERSION "libcurl not available"
310 # define HTTP_CURL_AVAIL(CLASS) "libcurl not available"
311 #endif
312
313 char full_version_string[1024] = {0};
314 snprintf(full_version_string, 1023, "%s (%s)", HTTP_PEXT_VERSION, HTTP_CURL_VERSION);
315
316 php_info_print_table_start();
317 php_info_print_table_row(2, "Extended HTTP support", "enabled");
318 php_info_print_table_row(2, "Extension Version:", full_version_string);
319 php_info_print_table_end();
320
321 php_info_print_table_start();
322 php_info_print_table_header(2, "Functionality", "Availability");
323 php_info_print_table_row(2, "Miscellaneous Utilities:", HTTP_FUNC_AVAIL("HttpUtil"));
324 php_info_print_table_row(2, "Extended HTTP Responses:", HTTP_FUNC_AVAIL("HttpResponse"));
325 php_info_print_table_row(2, "Extended HTTP Requests:", HTTP_CURL_AVAIL("HttpRequest"));
326 php_info_print_table_end();
327
328 DISPLAY_INI_ENTRIES();
329 }
330 /* }}} */
331
332 /*
333 * Local variables:
334 * tab-width: 4
335 * c-basic-offset: 4
336 * End:
337 * vim600: noet sw=4 ts=4 fdm=marker
338 * vim<600: noet sw=4 ts=4
339 */
340