2 +----------------------------------------------------------------------+
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 +----------------------------------------------------------------------+
25 # include <winsock2.h>
27 # include <curl/curl.h>
33 #include "ext/standard/info.h"
34 #include "ext/session/php_session.h"
35 #include "ext/standard/php_string.h"
36 #include "ext/standard/php_smart_str.h"
41 #include "php_http_api.h"
42 #include "php_http_curl_api.h"
43 #include "php_http_std_defs.h"
46 # include "ext/standard/php_http.h"
51 # ifdef ZEND_BEGIN_ARG_INFO
52 ZEND_BEGIN_ARG_INFO(http_request_info_ref_3
, 0)
58 ZEND_BEGIN_ARG_INFO(http_request_info_ref_4
, 0)
65 static unsigned char http_request_info_ref_3
[] = {3, BYREF_NONE
, BYREF_NONE
, BYREF_FORCE
};
66 static unsigned char http_request_info_ref_4
[] = {4, BYREF_NONE
, BYREF_NONE
, BYREF_NONE
, BYREF_FORCE
};
70 #endif /* HTTP_HAVE_CURL */
72 ZEND_DECLARE_MODULE_GLOBALS(http
)
74 #ifdef COMPILE_DL_HTTP
78 /* {{{ http_functions[] */
79 function_entry http_functions
[] = {
80 PHP_FE(http_date
, NULL
)
81 PHP_FE(http_absolute_uri
, NULL
)
82 PHP_FE(http_negotiate_language
, NULL
)
83 PHP_FE(http_negotiate_charset
, NULL
)
84 PHP_FE(http_redirect
, NULL
)
85 PHP_FE(http_send_status
, NULL
)
86 PHP_FE(http_send_last_modified
, NULL
)
87 PHP_FE(http_send_content_type
, NULL
)
88 PHP_FE(http_send_content_disposition
, NULL
)
89 PHP_FE(http_match_modified
, NULL
)
90 PHP_FE(http_match_etag
, NULL
)
91 PHP_FE(http_cache_last_modified
, NULL
)
92 PHP_FE(http_cache_etag
, NULL
)
93 PHP_FE(http_send_data
, NULL
)
94 PHP_FE(http_send_file
, NULL
)
95 PHP_FE(http_send_stream
, NULL
)
96 PHP_FE(http_chunked_decode
, NULL
)
97 PHP_FE(http_split_response
, NULL
)
98 PHP_FE(http_parse_headers
, NULL
)
99 PHP_FE(http_get_request_headers
, NULL
)
100 #ifdef HTTP_HAVE_CURL
101 PHP_FE(http_get
, http_request_info_ref_3
)
102 PHP_FE(http_head
, http_request_info_ref_3
)
103 PHP_FE(http_post_data
, http_request_info_ref_4
)
104 PHP_FE(http_post_array
, http_request_info_ref_4
)
106 PHP_FE(http_auth_basic
, NULL
)
107 PHP_FE(http_auth_basic_cb
, NULL
)
108 #ifndef ZEND_ENGINE_2
109 PHP_FE(http_build_query
, NULL
)
111 PHP_FE(ob_httpetaghandler
, NULL
)
121 zend_class_entry
*httpi_ce
;
123 #define HTTPi_ME(me, al, ai) ZEND_FENTRY(me, ZEND_FN(al), ai, ZEND_ACC_PUBLIC | ZEND_ACC_STATIC)
125 zend_function_entry httpi_class_methods
[] = {
126 HTTPi_ME(date
, http_date
, NULL
)
127 HTTPi_ME(absoluteURI
, http_absolute_uri
, NULL
)
128 HTTPi_ME(negotiateLanguage
, http_negotiate_language
, NULL
)
129 HTTPi_ME(negotiateCharset
, http_negotiate_charset
, NULL
)
130 HTTPi_ME(redirect
, http_redirect
, NULL
)
131 HTTPi_ME(sendStatus
, http_send_status
, NULL
)
132 HTTPi_ME(sendLastModified
, http_send_last_modified
, NULL
)
133 HTTPi_ME(sendContentType
, http_send_content_type
, NULL
)
134 HTTPi_ME(sendContentDisposition
, http_send_content_disposition
, NULL
)
135 HTTPi_ME(matchModified
, http_match_modified
, NULL
)
136 HTTPi_ME(matchEtag
, http_match_etag
, NULL
)
137 HTTPi_ME(cacheLastModified
, http_cache_last_modified
, NULL
)
138 HTTPi_ME(cacheEtag
, http_cache_etag
, NULL
)
139 HTTPi_ME(chunkedDecode
, http_chunked_decode
, NULL
)
140 HTTPi_ME(splitResponse
, http_split_response
, NULL
)
141 HTTPi_ME(parseHeaders
, http_parse_headers
, NULL
)
142 HTTPi_ME(getRequestHeaders
, http_get_request_headers
, NULL
)
143 #ifdef HTTP_HAVE_CURL
144 HTTPi_ME(get
, http_get
, http_request_info_ref_3
)
145 HTTPi_ME(head
, http_head
, http_request_info_ref_3
)
146 HTTPi_ME(postData
, http_post_data
, http_request_info_ref_4
)
147 HTTPi_ME(postArray
, http_post_array
, http_request_info_ref_4
)
149 HTTPi_ME(authBasic
, http_auth_basic
, NULL
)
150 HTTPi_ME(authBasicCallback
, http_auth_basic_cb
, NULL
)
155 /* {{{ HTTPi_Response */
157 zend_class_entry
*httpi_response_ce
;
158 static zend_object_handlers httpi_response_object_handlers
;
160 #define httpi_response_declare_default_properties(ce) _httpi_response_declare_default_properties(ce TSRMLS_CC)
161 static inline void _httpi_response_declare_default_properties(zend_class_entry
*ce TSRMLS_DC
)
163 DCL_PROP(PROTECTED
, string
, contentType
, "application/x-octetstream");
164 DCL_PROP(PROTECTED
, string
, eTag
, "");
165 DCL_PROP(PROTECTED
, string
, dispoFile
, "");
166 DCL_PROP(PROTECTED
, string
, cacheControl
, "public");
167 DCL_PROP(PROTECTED
, string
, data
, "");
168 DCL_PROP(PROTECTED
, string
, file
, "");
169 DCL_PROP(PROTECTED
, long, stream
, 0);
170 DCL_PROP(PROTECTED
, long, lastModified
, 0);
171 DCL_PROP(PROTECTED
, long, dispoInline
, 0);
172 DCL_PROP(PROTECTED
, long, cache
, 0);
173 DCL_PROP(PROTECTED
, long, gzip
, 0);
175 DCL_PROP(PRIVATE
, long, raw_cache_header
, 0);
176 DCL_PROP(PRIVATE
, long, send_mode
, -1);
179 #define httpi_response_destroy_object _httpi_response_destroy_object
180 void _httpi_response_destroy_object(void *object
, zend_object_handle handle TSRMLS_DC
)
182 httpi_response_object
*o
= object
;
184 zend_hash_destroy(OBJ_PROP(o
));
185 FREE_HASHTABLE(OBJ_PROP(o
));
190 #define httpi_response_new_object _httpi_response_new_object
191 zend_object_value
_httpi_response_new_object(zend_class_entry
*ce TSRMLS_DC
)
193 zend_object_value ov
;
194 httpi_response_object
*o
;
196 o
= ecalloc(1, sizeof(httpi_response_object
));
199 ALLOC_HASHTABLE(OBJ_PROP(o
));
200 zend_hash_init(OBJ_PROP(o
), 0, NULL
, ZVAL_PTR_DTOR
, 0);
201 zend_hash_copy(OBJ_PROP(o
), &ce
->default_properties
, (copy_ctor_func_t
) zval_add_ref
, NULL
, sizeof(zval
*));
203 ov
.handle
= zend_objects_store_put(o
, httpi_response_destroy_object
, NULL
, NULL TSRMLS_CC
);
204 ov
.handlers
= &httpi_response_object_handlers
;
209 zend_function_entry httpi_response_class_methods
[] = {
210 PHP_ME(HTTPi_Response
, __construct
, NULL
, ZEND_ACC_PUBLIC
|ZEND_ACC_CTOR
)
211 /* PHP_ME(HTTPi_Response, __destruct, NULL, ZEND_ACC_PUBLIC|ZEND_ACC_DTOR)
213 PHP_ME(HTTPi_Response
, setETag
, NULL
, ZEND_ACC_PUBLIC
)
214 PHP_ME(HTTPi_Response
, getETag
, NULL
, ZEND_ACC_PUBLIC
)
216 PHP_ME(HTTPi_Response
, setContentDisposition
, NULL
, ZEND_ACC_PUBLIC
)
217 PHP_ME(HTTPi_Response
, getContentDisposition
, NULL
, ZEND_ACC_PUBLIC
)
219 PHP_ME(HTTPi_Response
, setContentType
, NULL
, ZEND_ACC_PUBLIC
)
220 PHP_ME(HTTPi_Response
, getContentType
, NULL
, ZEND_ACC_PUBLIC
)
222 PHP_ME(HTTPi_Response
, setCache
, NULL
, ZEND_ACC_PUBLIC
)
223 PHP_ME(HTTPi_Response
, getCache
, NULL
, ZEND_ACC_PUBLIC
)
225 PHP_ME(HTTPi_Response
, setCacheControl
, NULL
, ZEND_ACC_PUBLIC
)
226 PHP_ME(HTTPi_Response
, getCacheControl
, NULL
, ZEND_ACC_PUBLIC
)
228 PHP_ME(HTTPi_Response
, setGzip
, NULL
, ZEND_ACC_PUBLIC
)
229 PHP_ME(HTTPi_Response
, getGzip
, NULL
, ZEND_ACC_PUBLIC
)
231 PHP_ME(HTTPi_Response
, setData
, NULL
, ZEND_ACC_PUBLIC
)
232 PHP_ME(HTTPi_Response
, getData
, NULL
, ZEND_ACC_PUBLIC
)
234 PHP_ME(HTTPi_Response
, setFile
, NULL
, ZEND_ACC_PUBLIC
)
235 PHP_ME(HTTPi_Response
, getFile
, NULL
, ZEND_ACC_PUBLIC
)
237 PHP_ME(HTTPi_Response
, setStream
, NULL
, ZEND_ACC_PUBLIC
)
238 PHP_ME(HTTPi_Response
, getStream
, NULL
, ZEND_ACC_PUBLIC
)
240 PHP_ME(HTTPi_Response
, send
, NULL
, ZEND_ACC_PUBLIC
)
246 /* {{{ HTTPi_Request */
247 #ifdef HTTP_HAVE_CURL
249 zend_class_entry
*httpi_request_ce
;
250 static zend_object_handlers httpi_request_object_handlers
;
252 #define httpi_request_declare_default_properties(ce) _httpi_request_declare_default_properties(ce TSRMLS_CC)
253 static inline void _httpi_request_declare_default_properties(zend_class_entry
*ce TSRMLS_DC
)
255 DCL_PROP_N(PROTECTED
, options
);
256 DCL_PROP_N(PROTECTED
, responseInfo
);
257 DCL_PROP_N(PROTECTED
, responseData
);
258 DCL_PROP_N(PROTECTED
, postData
);
259 DCL_PROP_N(PROTECTED
, postFiles
);
261 DCL_PROP(PROTECTED
, long, method
, HTTP_GET
);
263 DCL_PROP(PROTECTED
, string
, url
, "");
264 DCL_PROP(PROTECTED
, string
, contentType
, "");
265 DCL_PROP(PROTECTED
, string
, queryData
, "");
266 DCL_PROP(PROTECTED
, string
, postData
, "");
269 #define httpi_request_free_object _httpi_request_free_object
270 void _httpi_request_free_object(zend_object
/* void */ *object TSRMLS_DC
)
272 httpi_request_object
*o
= (httpi_request_object
*) object
;
275 zend_hash_destroy(OBJ_PROP(o
));
276 FREE_HASHTABLE(OBJ_PROP(o
));
279 curl_easy_cleanup(o
->ch
);
285 #define httpi_request_new_object _httpi_request_new_object
286 zend_object_value
_httpi_request_new_object(zend_class_entry
*ce TSRMLS_DC
)
288 zend_object_value ov
;
289 httpi_request_object
*o
;
291 o
= ecalloc(1, sizeof(httpi_request_object
));
293 o
->ch
= curl_easy_init();
295 ALLOC_HASHTABLE(OBJ_PROP(o
));
296 zend_hash_init(OBJ_PROP(o
), 0, NULL
, ZVAL_PTR_DTOR
, 0);
297 zend_hash_copy(OBJ_PROP(o
), &ce
->default_properties
, (copy_ctor_func_t
) zval_add_ref
, NULL
, sizeof(zval
*));
299 ov
.handle
= zend_objects_store_put(o
, (zend_objects_store_dtor_t
) zend_objects_destroy_object
, httpi_request_free_object
, NULL TSRMLS_CC
);
300 ov
.handlers
= &httpi_request_object_handlers
;
305 zend_function_entry httpi_request_class_methods
[] = {
306 PHP_ME(HTTPi_Request
, __construct
, NULL
, ZEND_ACC_PUBLIC
|ZEND_ACC_CTOR
)
307 PHP_ME(HTTPi_Request
, __destruct
, NULL
, ZEND_ACC_PUBLIC
|ZEND_ACC_DTOR
)
309 PHP_ME(HTTPi_Request
, setOptions
, NULL
, ZEND_ACC_PUBLIC
)
310 PHP_ME(HTTPi_Request
, getOptions
, NULL
, ZEND_ACC_PUBLIC
)
311 PHP_ME(HTTPi_Request
, unsetOptions
, NULL
, ZEND_ACC_PUBLIC
)
313 PHP_ME(HTTPi_Request
, addHeader
, NULL
, ZEND_ACC_PUBLIC
)
314 PHP_ME(HTTPi_Request
, addCookie
, NULL
, ZEND_ACC_PUBLIC
)
316 PHP_ME(HTTPi_Request
, setMethod
, NULL
, ZEND_ACC_PUBLIC
)
317 PHP_ME(HTTPi_Request
, getMethod
, NULL
, ZEND_ACC_PUBLIC
)
319 PHP_ME(HTTPi_Request
, setURL
, NULL
, ZEND_ACC_PUBLIC
)
320 PHP_ME(HTTPi_Request
, getURL
, NULL
, ZEND_ACC_PUBLIC
)
322 PHP_ME(HTTPi_Request
, setContentType
, NULL
, ZEND_ACC_PUBLIC
)
323 PHP_ME(HTTPi_Request
, getContentType
, NULL
, ZEND_ACC_PUBLIC
)
325 PHP_ME(HTTPi_Request
, setQueryData
, NULL
, ZEND_ACC_PUBLIC
)
326 PHP_ME(HTTPi_Request
, getQueryData
, NULL
, ZEND_ACC_PUBLIC
)
327 PHP_ME(HTTPi_Request
, addQueryData
, NULL
, ZEND_ACC_PUBLIC
)
328 PHP_ME(HTTPi_Request
, unsetQueryData
, NULL
, ZEND_ACC_PUBLIC
)
330 PHP_ME(HTTPi_Request
, setPostData
, NULL
, ZEND_ACC_PUBLIC
)
331 PHP_ME(HTTPi_Request
, getPostData
, NULL
, ZEND_ACC_PUBLIC
)
332 PHP_ME(HTTPi_Request
, addPostData
, NULL
, ZEND_ACC_PUBLIC
)
333 PHP_ME(HTTPi_Request
, unsetPostData
, NULL
, ZEND_ACC_PUBLIC
)
335 PHP_ME(HTTPi_Request
, addPostFile
, NULL
, ZEND_ACC_PUBLIC
)
336 PHP_ME(HTTPi_Request
, getPostFiles
, NULL
, ZEND_ACC_PUBLIC
)
337 PHP_ME(HTTPi_Request
, unsetPostFiles
, NULL
, ZEND_ACC_PUBLIC
)
339 PHP_ME(HTTPi_Request
, send
, NULL
, ZEND_ACC_PUBLIC
)
341 PHP_ME(HTTPi_Request
, getResponseData
, NULL
, ZEND_ACC_PUBLIC
)
342 PHP_ME(HTTPi_Request
, getResponseHeader
, NULL
, ZEND_ACC_PUBLIC
)
343 PHP_ME(HTTPi_Request
, getResponseCode
, NULL
, ZEND_ACC_PUBLIC
)
344 PHP_ME(HTTPi_Request
, getResponseBody
, NULL
, ZEND_ACC_PUBLIC
)
345 PHP_ME(HTTPi_Request
, getResponseInfo
, NULL
, ZEND_ACC_PUBLIC
)
350 #endif /* HTTP_HAVE_CURL */
353 #endif /* ZEND_ENGINE_2 */
355 /* {{{ http_module_entry */
356 zend_module_entry http_module_entry
= {
357 #if ZEND_MODULE_API_NO >= 20010901
358 STANDARD_MODULE_HEADER
,
367 #if ZEND_MODULE_API_NO >= 20010901
368 PHP_EXT_HTTP_VERSION
,
370 STANDARD_MODULE_PROPERTIES
375 static void free_to_free(void *s
)
380 /* {{{ php_http_init_globals(zend_http_globals *) */
381 static void php_http_init_globals(zend_http_globals
*http_globals
)
383 http_globals
->etag_started
= 0;
384 http_globals
->ctype
= NULL
;
385 http_globals
->etag
= NULL
;
386 http_globals
->lmod
= 0;
387 #ifdef HTTP_HAVE_CURL
388 http_globals
->curlbuf
.data
= NULL
;
389 http_globals
->curlbuf
.used
= 0;
390 http_globals
->curlbuf
.free
= 0;
391 http_globals
->curlbuf
.size
= 0;
392 zend_llist_init(&http_globals
->to_free
, sizeof(char *), free_to_free
, 0);
394 http_globals
->allowed_methods
= NULL
;
398 /* {{{ static inline STATUS http_check_allowed_methods(char *, int) */
399 #define http_check_allowed_methods(m, l) _http_check_allowed_methods((m), (l) TSRMLS_CC)
400 static inline void _http_check_allowed_methods(char *methods
, int length TSRMLS_DC
)
402 if (length
&& SG(request_info
).request_method
&& (!strstr(methods
, SG(request_info
).request_method
))) {
403 char *allow_header
= emalloc(length
+ sizeof("Allow: "));
404 sprintf(allow_header
, "Allow: %s", methods
);
405 http_send_header(allow_header
);
407 http_send_status(405);
414 PHP_INI_MH(update_allowed_methods
)
416 http_check_allowed_methods(new_value
, new_value_length
);
417 return OnUpdateString(entry
, new_value
, new_value_length
, mh_arg1
, mh_arg2
, mh_arg3
, stage TSRMLS_CC
);
421 STD_PHP_INI_ENTRY("http.allowed_methods",
423 "GET, HEAD, POST, PUT, DELETE, OPTIONS, TRACE, CONNECT, "
424 /* WebDAV - RFC 2518 * /
425 "PROPFIND, PROPPATCH, MKCOL, COPY, MOVE, LOCK, UNLOCK, "
426 /* WebDAV Versioning - RFC 3253 * /
427 "VERSION-CONTROL, REPORT, CHECKOUT, CHECKIN, UNCHECKOUT, "
428 "MKWORKSPACE, UPDATE, LABEL, MERGE, BASELINE-CONTROL, MKACTIVITY, "
429 /* WebDAV Access Control - RFC 3744 * /
433 PHP_INI_ALL
, update_allowed_methods
, allowed_methods
, zend_http_globals
, http_globals
)
437 /* {{{ PHP_MINIT_FUNCTION */
438 PHP_MINIT_FUNCTION(http
)
440 ZEND_INIT_MODULE_GLOBALS(http
, php_http_init_globals
, NULL
);
441 REGISTER_INI_ENTRIES();
443 #if defined(HTTP_HAVE_CURL) && (LIBCURL_VERSION_NUM >= 0x070a05)
444 REGISTER_LONG_CONSTANT("HTTP_AUTH_BASIC", CURLAUTH_BASIC
, CONST_CS
| CONST_PERSISTENT
);
445 REGISTER_LONG_CONSTANT("HTTP_AUTH_DIGEST", CURLAUTH_DIGEST
, CONST_CS
| CONST_PERSISTENT
);
446 REGISTER_LONG_CONSTANT("HTTP_AUTH_NTLM", CURLAUTH_NTLM
, CONST_CS
| CONST_PERSISTENT
);
450 HTTP_REGISTER_CLASS(HTTPi
, httpi
, NULL
, ZEND_ACC_FINAL_CLASS
);
451 HTTP_REGISTER_CLASS_EX(HTTPi_Response
, httpi_response
, NULL
, 0);
452 # ifdef HTTP_HAVE_CURL
453 HTTP_REGISTER_CLASS_EX(HTTPi_Request
, httpi_request
, NULL
, 0);
454 REGISTER_LONG_CONSTANT("HTTP_GET", HTTP_GET
, CONST_CS
| CONST_PERSISTENT
);
455 REGISTER_LONG_CONSTANT("HTTP_HEAD", HTTP_HEAD
, CONST_CS
| CONST_PERSISTENT
);
456 REGISTER_LONG_CONSTANT("HTTP_POST", HTTP_POST
, CONST_CS
| CONST_PERSISTENT
);
457 # endif /* HTTP_HAVE_CURL */
458 #endif /* ZEND_ENGINE_2 */
463 /* {{{ PHP_MSHUTDOWN_FUNCTION */
464 PHP_MSHUTDOWN_FUNCTION(http
)
466 UNREGISTER_INI_ENTRIES();
471 /* {{{ PHP_RINIT_FUNCTION */
472 PHP_RINIT_FUNCTION(http
)
474 char *allowed_methods
= INI_STR("http.allowed_methods");
475 http_check_allowed_methods(allowed_methods
, strlen(allowed_methods
));
480 /* {{{ PHP_RSHUTDOWN_FUNCTION */
481 PHP_RSHUTDOWN_FUNCTION(http
)
483 HTTP_G(etag_started
) = 0;
492 efree(HTTP_G(ctype
));
493 HTTP_G(ctype
) = NULL
;
496 #ifdef HTTP_HAVE_CURL
497 if (HTTP_G(curlbuf
).data
) {
498 efree(HTTP_G(curlbuf
).data
);
499 HTTP_G(curlbuf
).data
= NULL
;
500 HTTP_G(curlbuf
).used
= 0;
501 HTTP_G(curlbuf
).free
= 0;
509 /* {{{ PHP_MINFO_FUNCTION */
510 PHP_MINFO_FUNCTION(http
)
513 # define HTTP_FUNC_AVAIL(CLASS) "procedural, object oriented (class " CLASS ")"
515 # define HTTP_FUNC_AVAIL(CLASS) "procedural"
518 #ifdef HTTP_HAVE_CURL
519 # define HTTP_CURL_VERSION curl_version()
520 # ifdef ZEND_ENGINE_2
521 # define HTTP_CURL_AVAIL(CLASS) "procedural, object oriented (class " CLASS ")"
523 # define HTTP_CURL_AVAIL(CLASS) "procedural"
526 # define HTTP_CURL_VERSION "libcurl not available"
527 # define HTTP_CURL_AVAIL(CLASS) "libcurl not available"
530 char full_version_string
[1024] = {0};
531 snprintf(full_version_string
, 1023, "%s (%s)", PHP_EXT_HTTP_VERSION
, HTTP_CURL_VERSION
);
533 php_info_print_table_start();
534 php_info_print_table_row(2, "Extended HTTP support", "enabled");
535 php_info_print_table_row(2, "Extension Version:", full_version_string
);
536 php_info_print_table_end();
538 php_info_print_table_start();
539 php_info_print_table_header(2, "Functionality", "Availability");
540 php_info_print_table_row(2, "Miscellaneous Utilities:", HTTP_FUNC_AVAIL("HTTPi"));
541 php_info_print_table_row(2, "Extended HTTP Responses:", HTTP_FUNC_AVAIL("HTTPi_Response"));
542 php_info_print_table_row(2, "Extended HTTP Requests:", HTTP_CURL_AVAIL("HTTPi_Request"));
543 php_info_print_table_end();
545 DISPLAY_INI_ENTRIES();
554 * vim600: noet sw=4 ts=4 fdm=marker
555 * vim<600: noet sw=4 ts=4