- add note about SSL connect errors on windows due to LIB/DLL mismatches
[m6w6/ext-http] / php_http_request_api.h
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 #ifndef PHP_HTTP_REQUEST_API_H
19 #define PHP_HTTP_REQUEST_API_H
20 #ifdef HTTP_HAVE_CURL
21
22 #include "php_http_std_defs.h"
23 #include "php_http_request_method_api.h"
24
25 #include "phpstr/phpstr.h"
26
27 #ifdef PHP_WIN32
28 # include <winsock2.h>
29 #endif
30
31 #include <curl/curl.h>
32
33 #define http_request_global_init() _http_request_global_init(INIT_FUNC_ARGS_PASSTHRU)
34 extern STATUS _http_request_global_init(INIT_FUNC_ARGS);
35 #define http_request_global_cleanup() _http_request_global_cleanup(TSRMLS_C)
36 extern void _http_request_global_cleanup(TSRMLS_D);
37
38 #define HTTP_REQUEST_BODY_CSTRING 1
39 #define HTTP_REQUEST_BODY_CURLPOST 2
40 #define HTTP_REQUEST_BODY_UPLOADFILE 3
41 typedef struct {
42 int type;
43 void *data;
44 size_t size;
45 } http_request_body;
46
47 typedef struct {
48 void ***tsrm_ctx;
49 void *data;
50 } http_request_callback_ctx;
51
52 typedef struct {
53 phpstr *response;
54 phpstr *request;
55 curl_infotype last_info;
56 } http_request_conv;
57
58 #define HTTP_REQUEST_CALLBACK_DATA(from, type, var) \
59 http_request_callback_ctx *__CTX = (http_request_callback_ctx *) (from); \
60 TSRMLS_FETCH_FROM_CTX(__CTX->tsrm_ctx); \
61 type (var) = (type) (__CTX->data)
62
63 #define http_request_callback_data(data) _http_request_callback_data_ex((data), 1 TSRMLS_CC)
64 #define http_request_callback_data_ex(data, copy) _http_request_callback_data_ex((data), (copy) TSRMLS_CC)
65 extern http_request_callback_ctx *_http_request_callback_data_ex(void *data, zend_bool cpy TSRMLS_DC);
66
67
68 #define COPY_STRING 1
69 #define COPY_SLIST 2
70 #define COPY_CONTEXT 3
71 #define COPY_CONV 4
72 #define http_request_data_copy(type, data) _http_request_data_copy((type), (data) TSRMLS_CC)
73 extern void *_http_request_data_copy(int type, void *data TSRMLS_DC);
74 #define http_request_data_free_string _http_request_data_free_string
75 extern void _http_request_data_free_string(void *string);
76 #define http_request_data_free_slist _http_request_data_free_slist
77 extern void _http_request_data_free_slist(void *list);
78 #define http_request_data_free_context _http_request_data_free_context
79 extern void _http_request_data_free_context(void *context);
80 #define http_request_data_free_conv _http_request_data_free_conv
81 extern void _http_request_data_free_conv(void *conv);
82
83 #define http_request_conv(ch, rs, rq) _http_request_conv((ch), (rs), (rq) TSRMLS_CC)
84 extern void _http_request_conv(CURL *ch, phpstr* response, phpstr *request TSRMLS_DC);
85
86 #define http_request_body_new() _http_request_body_new(TSRMLS_C)
87 PHP_HTTP_API http_request_body *_http_request_body_new(TSRMLS_D);
88
89 #define http_request_body_fill(b, fields, files) _http_request_body_fill((b), (fields), (files) TSRMLS_CC)
90 PHP_HTTP_API STATUS _http_request_body_fill(http_request_body *body, HashTable *fields, HashTable *files TSRMLS_DC);
91
92 #define http_request_body_dtor(b) _http_request_body_dtor((b) TSRMLS_CC)
93 PHP_HTTP_API void _http_request_body_dtor(http_request_body *body TSRMLS_DC);
94
95 #define http_request_body_free(b) _http_request_body_free((b) TSRMLS_CC)
96 PHP_HTTP_API void _http_request_body_free(http_request_body *body TSRMLS_DC);
97
98 #define http_request_init(ch, meth, url, body, options) _http_request_init((ch), (meth), (url), (body), (options) TSRMLS_CC)
99 PHP_HTTP_API STATUS _http_request_init(CURL *ch, http_request_method meth, char *url, http_request_body *body, HashTable *options TSRMLS_DC);
100
101 #define http_request_exec(ch, i, response, request) _http_request_exec((ch), (i), (response), (request) TSRMLS_CC)
102 PHP_HTTP_API STATUS _http_request_exec(CURL *ch, HashTable *info, phpstr *response, phpstr *request TSRMLS_DC);
103
104 #define http_request_info(ch, i) _http_request_info((ch), (i) TSRMLS_CC)
105 PHP_HTTP_API void _http_request_info(CURL *ch, HashTable *info TSRMLS_DC);
106
107 #define http_request(meth, url, body, opt, info, resp) _http_request_ex(NULL, (meth), (url), (body), (opt), (info), (resp) TSRMLS_CC)
108 #define http_request_ex(ch, meth, url, body, opt, info, resp) _http_request_ex((ch), (meth), (url), (body), (opt), (info), (resp) TSRMLS_CC)
109 PHP_HTTP_API STATUS _http_request_ex(CURL *ch, http_request_method meth, char *URL, http_request_body *body, HashTable *options, HashTable *info, phpstr *response TSRMLS_DC);
110
111 #define http_get(u, o, i, r) _http_request_ex(NULL, HTTP_GET, (u), NULL, (o), (i), (r) TSRMLS_CC)
112 #define http_get_ex(c, u, o, i, r) _http_request_ex((c), HTTP_GET, (u), NULL, (o), (i), (r) TSRMLS_CC)
113
114 #define http_head(u, o, i, r) _http_request_ex(NULL, HTTP_HEAD, (u), NULL, (o), (i), (r) TSRMLS_CC)
115 #define http_head_ex(c, u, o, i, r) _http_request_ex((c), HTTP_HEAD, (u), NULL, (o), (i), (r) TSRMLS_CC)
116
117 #define http_post(u, b, o, i, r) _http_request_ex(NULL, HTTP_POST, (u), (b), (o), (i), (r) TSRMLS_CC)
118 #define http_post_ex(c, u, b, o, i, r) _http_request_ex((c), HTTP_POST, (u), (b), (o), (i), (r) TSRMLS_CC)
119
120 #define http_put(u, b, o, i, r) _http_request_ex(NULL, HTTP_PUT, (u), (b), (o), (i), (r) TSRMLS_CC)
121 #define http_put_ex(c, u, b, o, i, r) _http_request_ex((c), HTTP_PUT, (u), (b), (o), (i), (r) TSRMLS_CC)
122
123 #endif
124 #endif
125
126 /*
127 * Local variables:
128 * tab-width: 4
129 * c-basic-offset: 4
130 * End:
131 * vim600: noet sw=4 ts=4 fdm=marker
132 * vim<600: noet sw=4 ts=4
133 */
134