83764e9a57f58c287c3168391a92e4037ac54000
[m6w6/ext-http] / http_functions.c
1 /*
2 +--------------------------------------------------------------------+
3 | PECL :: http |
4 +--------------------------------------------------------------------+
5 | Redistribution and use in source and binary forms, with or without |
6 | modification, are permitted provided that the conditions mentioned |
7 | in the accompanying LICENSE file are met. |
8 +--------------------------------------------------------------------+
9 | Copyright (c) 2004-2006, Michael Wallner <mike@php.net> |
10 +--------------------------------------------------------------------+
11 */
12
13 /* $Id$ */
14
15 #define HTTP_WANT_SAPI
16 #define HTTP_WANT_CURL
17 #define HTTP_WANT_ZLIB
18 #include "php_http.h"
19
20 #include "php_ini.h"
21 #include "ext/standard/php_string.h"
22 #include "zend_operators.h"
23
24 #ifdef HTTP_HAVE_SESSION
25 # include "ext/session/php_session.h"
26 #endif
27
28 #include "php_http_api.h"
29 #include "php_http_cache_api.h"
30 #include "php_http_cookie_api.h"
31 #include "php_http_date_api.h"
32 #include "php_http_encoding_api.h"
33 #include "php_http_headers_api.h"
34 #include "php_http_message_api.h"
35 #include "php_http_request_api.h"
36 #include "php_http_request_method_api.h"
37 #include "php_http_persistent_handle_api.h"
38 #include "php_http_send_api.h"
39 #include "php_http_url_api.h"
40
41 /* {{{ proto string http_date([int timestamp])
42 Compose a valid HTTP date regarding RFC 1123 looking like: "Wed, 22 Dec 2004 11:34:47 GMT" */
43 PHP_FUNCTION(http_date)
44 {
45 long t = -1;
46
47 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &t) != SUCCESS) {
48 RETURN_FALSE;
49 }
50
51 if (t == -1) {
52 t = HTTP_G->request.time;
53 }
54
55 RETURN_STRING(http_date(t), 0);
56 }
57 /* }}} */
58
59 /* {{{ proto string http_build_url([mixed url[, mixed parts[, int flags = HTTP_URL_REPLACE[, array &new_url]]]])
60 Build an URL. */
61 PHP_FUNCTION(http_build_url)
62 {
63 char *url_str = NULL;
64 size_t url_len = 0;
65 long flags = HTTP_URL_REPLACE;
66 zval *z_old_url = NULL, *z_new_url = NULL, *z_composed_url = NULL;
67 php_url *old_url = NULL, *new_url = NULL, *composed_url = NULL;
68
69 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|z!/z!/lz", &z_old_url, &z_new_url, &flags, &z_composed_url) != SUCCESS) {
70 RETURN_FALSE;
71 }
72
73 if (z_new_url) {
74 if (Z_TYPE_P(z_new_url) == IS_ARRAY || Z_TYPE_P(z_new_url) == IS_OBJECT) {
75 new_url = http_url_from_struct(NULL, HASH_OF(z_new_url));
76 } else {
77 convert_to_string(z_new_url);
78 if (!(new_url = php_url_parse_ex(Z_STRVAL_P(z_new_url), Z_STRLEN_P(z_new_url)))) {
79 http_error_ex(HE_WARNING, HTTP_E_URL, "Could not parse URL (%s)", Z_STRVAL_P(z_new_url));
80 RETURN_FALSE;
81 }
82 }
83 }
84
85 if (z_old_url) {
86 if (Z_TYPE_P(z_old_url) == IS_ARRAY || Z_TYPE_P(z_old_url) == IS_OBJECT) {
87 old_url = http_url_from_struct(NULL, HASH_OF(z_old_url));
88 } else {
89 convert_to_string(z_old_url);
90 if (!(old_url = php_url_parse_ex(Z_STRVAL_P(z_old_url), Z_STRLEN_P(z_old_url)))) {
91 if (new_url) {
92 php_url_free(new_url);
93 }
94 http_error_ex(HE_WARNING, HTTP_E_URL, "Could not parse URL (%s)", Z_STRVAL_P(z_old_url));
95 RETURN_FALSE;
96 }
97 }
98 }
99
100 if (z_composed_url) {
101 http_build_url(flags, old_url, new_url, &composed_url, &url_str, &url_len);
102 http_url_tostruct(composed_url, z_composed_url);
103 php_url_free(composed_url);
104 } else {
105 http_build_url(flags, old_url, new_url, NULL, &url_str, &url_len);
106 }
107
108 if (new_url) {
109 php_url_free(new_url);
110 }
111 if (old_url) {
112 php_url_free(old_url);
113 }
114
115 RETURN_STRINGL(url_str, url_len, 0);
116 }
117 /* }}} */
118
119 /* {{{ proto string http_build_str(array query [, string prefix[, string arg_separator]])
120 Opponent to parse_str(). */
121 PHP_FUNCTION(http_build_str)
122 {
123 zval *formdata;
124 char *prefix = NULL, *arg_sep = INI_STR("arg_separator.output");
125 int prefix_len = 0, arg_sep_len = strlen(arg_sep);
126 phpstr formstr;
127
128 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a|ss", &formdata, &prefix, &prefix_len, &arg_sep, &arg_sep_len) != SUCCESS) {
129 RETURN_FALSE;
130 }
131
132 if (!arg_sep_len) {
133 arg_sep = HTTP_URL_ARGSEP;
134 arg_sep_len = lenof(HTTP_URL_ARGSEP);
135 }
136
137 phpstr_init(&formstr);
138 if (SUCCESS != http_urlencode_hash_recursive(HASH_OF(formdata), &formstr, arg_sep, arg_sep_len, prefix, prefix_len)) {
139 RETURN_FALSE;
140 }
141
142 if (!formstr.used) {
143 phpstr_dtor(&formstr);
144 RETURN_NULL();
145 }
146
147 RETURN_PHPSTR_VAL(&formstr);
148 }
149 /* }}} */
150
151 #define HTTP_DO_NEGOTIATE(type, supported, rs_array) \
152 { \
153 HashTable *result; \
154 if ((result = http_negotiate_ ##type(supported))) { \
155 char *key; \
156 uint key_len; \
157 ulong idx; \
158 \
159 if (HASH_KEY_IS_STRING == zend_hash_get_current_key_ex(result, &key, &key_len, &idx, 1, NULL)) { \
160 RETVAL_STRINGL(key, key_len-1, 0); \
161 } else { \
162 RETVAL_NULL(); \
163 } \
164 \
165 if (rs_array) { \
166 zend_hash_copy(Z_ARRVAL_P(rs_array), result, (copy_ctor_func_t) zval_add_ref, NULL, sizeof(zval *)); \
167 } \
168 \
169 zend_hash_destroy(result); \
170 FREE_HASHTABLE(result); \
171 \
172 } else { \
173 zval **value; \
174 \
175 zend_hash_internal_pointer_reset(Z_ARRVAL_P(supported)); \
176 if (SUCCESS == zend_hash_get_current_data(Z_ARRVAL_P(supported), (void *) &value)) { \
177 RETVAL_ZVAL(*value, 1, 0); \
178 } else { \
179 RETVAL_NULL(); \
180 } \
181 \
182 if (rs_array) { \
183 HashPosition pos; \
184 zval **value; \
185 \
186 FOREACH_VAL(pos, supported, value) { \
187 convert_to_string_ex(value); \
188 add_assoc_double(rs_array, Z_STRVAL_PP(value), 1.0); \
189 } \
190 } \
191 } \
192 }
193
194 /* {{{ proto string http_negotiate_language(array supported[, array &result])
195 Negotiate the clients preferred language. */
196 PHP_FUNCTION(http_negotiate_language)
197 {
198 zval *supported, *rs_array = NULL;
199
200 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a|z", &supported, &rs_array) != SUCCESS) {
201 RETURN_FALSE;
202 }
203
204 if (rs_array) {
205 zval_dtor(rs_array);
206 array_init(rs_array);
207 }
208
209 HTTP_DO_NEGOTIATE(language, supported, rs_array);
210 }
211 /* }}} */
212
213 /* {{{ proto string http_negotiate_charset(array supported[, array &result])
214 Negotiate the clients preferred charset. */
215 PHP_FUNCTION(http_negotiate_charset)
216 {
217 zval *supported, *rs_array = NULL;
218
219 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a|z", &supported, &rs_array) != SUCCESS) {
220 RETURN_FALSE;
221 }
222
223 if (rs_array) {
224 zval_dtor(rs_array);
225 array_init(rs_array);
226 }
227
228 HTTP_DO_NEGOTIATE(charset, supported, rs_array);
229 }
230 /* }}} */
231
232 /* {{{ proto string http_negotiate_ctype(array supported[, array &result])
233 Negotiate the clients preferred content type. */
234 PHP_FUNCTION(http_negotiate_content_type)
235 {
236 zval *supported, *rs_array = NULL;
237
238 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a|z", &supported, &rs_array)) {
239 RETURN_FALSE;
240 }
241
242 if (rs_array) {
243 zval_dtor(rs_array);
244 array_init(rs_array);
245 }
246
247 HTTP_DO_NEGOTIATE(content_type, supported, rs_array);
248 }
249 /* }}} */
250
251 /* {{{ proto bool http_send_status(int status)
252 Send HTTP status code. */
253 PHP_FUNCTION(http_send_status)
254 {
255 int status = 0;
256
257 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &status) != SUCCESS) {
258 RETURN_FALSE;
259 }
260 if (status < 100 || status > 510) {
261 http_error_ex(HE_WARNING, HTTP_E_HEADER, "Invalid HTTP status code (100-510): %d", status);
262 RETURN_FALSE;
263 }
264
265 RETURN_SUCCESS(http_send_status(status));
266 }
267 /* }}} */
268
269 /* {{{ proto bool http_send_last_modified([int timestamp])
270 Send a "Last-Modified" header with a valid HTTP date. */
271 PHP_FUNCTION(http_send_last_modified)
272 {
273 long t = -1;
274
275 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &t) != SUCCESS) {
276 RETURN_FALSE;
277 }
278
279 if (t == -1) {
280 t = HTTP_G->request.time;
281 }
282
283 RETURN_SUCCESS(http_send_last_modified(t));
284 }
285 /* }}} */
286
287 /* {{{ proto bool http_send_content_type([string content_type = 'application/x-octetstream'])
288 Send the Content-Type of the sent entity. This is particularly important if you use the http_send() API. */
289 PHP_FUNCTION(http_send_content_type)
290 {
291 char *ct = "application/x-octetstream";
292 int ct_len = lenof("application/x-octetstream");
293
294 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &ct, &ct_len) != SUCCESS) {
295 RETURN_FALSE;
296 }
297
298 RETURN_SUCCESS(http_send_content_type(ct, ct_len));
299 }
300 /* }}} */
301
302 /* {{{ proto bool http_send_content_disposition(string filename[, bool inline = false])
303 Send the Content-Disposition. */
304 PHP_FUNCTION(http_send_content_disposition)
305 {
306 char *filename;
307 int f_len;
308 zend_bool send_inline = 0;
309
310 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &filename, &f_len, &send_inline) != SUCCESS) {
311 RETURN_FALSE;
312 }
313 RETURN_SUCCESS(http_send_content_disposition(filename, f_len, send_inline));
314 }
315 /* }}} */
316
317 /* {{{ proto bool http_match_modified([int timestamp[, bool for_range = false]])
318 Matches the given unix timestamp against the clients "If-Modified-Since" resp. "If-Unmodified-Since" HTTP headers. */
319 PHP_FUNCTION(http_match_modified)
320 {
321 long t = -1;
322 zend_bool for_range = 0;
323
324 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|lb", &t, &for_range) != SUCCESS) {
325 RETURN_FALSE;
326 }
327
328 // current time if not supplied (senseless though)
329 if (t == -1) {
330 t = HTTP_G->request.time;
331 }
332
333 if (for_range) {
334 RETURN_BOOL(http_match_last_modified("HTTP_IF_UNMODIFIED_SINCE", t));
335 }
336 RETURN_BOOL(http_match_last_modified("HTTP_IF_MODIFIED_SINCE", t));
337 }
338 /* }}} */
339
340 /* {{{ proto bool http_match_etag(string etag[, bool for_range = false])
341 Matches the given ETag against the clients "If-Match" resp. "If-None-Match" HTTP headers. */
342 PHP_FUNCTION(http_match_etag)
343 {
344 int etag_len;
345 char *etag;
346 zend_bool for_range = 0;
347
348 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &etag, &etag_len, &for_range) != SUCCESS) {
349 RETURN_FALSE;
350 }
351
352 if (for_range) {
353 RETURN_BOOL(http_match_etag("HTTP_IF_MATCH", etag));
354 }
355 RETURN_BOOL(http_match_etag("HTTP_IF_NONE_MATCH", etag));
356 }
357 /* }}} */
358
359 /* {{{ proto bool http_cache_last_modified([int timestamp_or_expires]])
360 Attempts to cache the sent entity by its last modification date. */
361 PHP_FUNCTION(http_cache_last_modified)
362 {
363 long last_modified = 0, send_modified = 0, t;
364 zval *zlm;
365
366 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &last_modified) != SUCCESS) {
367 RETURN_FALSE;
368 }
369
370 HTTP_CHECK_HEADERS_SENT(RETURN_FALSE);
371
372 t = HTTP_G->request.time;
373
374 /* 0 or omitted */
375 if (!last_modified) {
376 /* does the client have? (att: caching "forever") */
377 if ((zlm = http_get_server_var("HTTP_IF_MODIFIED_SINCE", 1))) {
378 last_modified = send_modified = http_parse_date(Z_STRVAL_P(zlm));
379 /* send current time */
380 } else {
381 send_modified = t;
382 }
383 /* negative value is supposed to be expiration time */
384 } else if (last_modified < 0) {
385 last_modified += t;
386 send_modified = t;
387 /* send supplied time explicitly */
388 } else {
389 send_modified = last_modified;
390 }
391
392 RETURN_SUCCESS(http_cache_last_modified(last_modified, send_modified, HTTP_DEFAULT_CACHECONTROL, lenof(HTTP_DEFAULT_CACHECONTROL)));
393 }
394 /* }}} */
395
396 /* {{{ proto bool http_cache_etag([string etag])
397 Attempts to cache the sent entity by its ETag, either supplied or generated by the hash algorithm specified by the INI setting "http.etag.mode". */
398 PHP_FUNCTION(http_cache_etag)
399 {
400 char *etag = NULL;
401 int etag_len = 0;
402
403 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &etag, &etag_len) != SUCCESS) {
404 RETURN_FALSE;
405 }
406
407 HTTP_CHECK_HEADERS_SENT(RETURN_FALSE);
408
409 RETURN_SUCCESS(http_cache_etag(etag, etag_len, HTTP_DEFAULT_CACHECONTROL, lenof(HTTP_DEFAULT_CACHECONTROL)));
410 }
411 /* }}} */
412
413 /* {{{ proto string ob_etaghandler(string data, int mode)
414 For use with ob_start(). Output buffer handler generating an ETag with the hash algorithm specified with the INI setting "http.etag.mode". */
415 PHP_FUNCTION(ob_etaghandler)
416 {
417 char *data;
418 int data_len;
419 long mode;
420
421 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl", &data, &data_len, &mode)) {
422 RETURN_FALSE;
423 }
424
425 Z_TYPE_P(return_value) = IS_STRING;
426 http_ob_etaghandler(data, data_len, &Z_STRVAL_P(return_value), (uint *) &Z_STRLEN_P(return_value), mode);
427 }
428 /* }}} */
429
430 /* {{{ proto void http_throttle(double sec[, int bytes = 40960])
431 Sets the throttle delay and send buffer size for use with http_send() API. */
432 PHP_FUNCTION(http_throttle)
433 {
434 long chunk_size = HTTP_SENDBUF_SIZE;
435 double interval;
436
437 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "d|l", &interval, &chunk_size)) {
438 return;
439 }
440
441 HTTP_G->send.throttle_delay = interval;
442 HTTP_G->send.buffer_size = chunk_size;
443 }
444 /* }}} */
445
446 /* {{{ proto void http_redirect([string url[, array params[, bool session = false[, int status = 302]]]])
447 Redirect to the given url. */
448 PHP_FUNCTION(http_redirect)
449 {
450 int url_len = 0;
451 size_t query_len = 0;
452 zend_bool session = 0, free_params = 0;
453 zval *params = NULL;
454 long status = HTTP_REDIRECT;
455 char *query = NULL, *url = NULL, *URI, *LOC, *RED = NULL;
456
457 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|sa!/bl", &url, &url_len, &params, &session, &status) != SUCCESS) {
458 RETURN_FALSE;
459 }
460
461 #ifdef HTTP_HAVE_SESSION
462 /* append session info */
463 if (session) {
464 if (!params) {
465 free_params = 1;
466 MAKE_STD_ZVAL(params);
467 array_init(params);
468 }
469 if (PS(session_status) == php_session_active) {
470 if (add_assoc_string(params, PS(session_name), PS(id), 1) != SUCCESS) {
471 http_error(HE_WARNING, HTTP_E_RUNTIME, "Could not append session information");
472 }
473 }
474 }
475 #endif
476
477 /* treat params array with http_build_query() */
478 if (params) {
479 if (SUCCESS != http_urlencode_hash_ex(Z_ARRVAL_P(params), 0, NULL, 0, &query, &query_len)) {
480 if (free_params) {
481 zval_dtor(params);
482 FREE_ZVAL(params);
483 }
484 if (query) {
485 efree(query);
486 }
487 RETURN_FALSE;
488 }
489 }
490
491 URI = http_absolute_url(url);
492
493 if (query_len) {
494 spprintf(&LOC, 0, "Location: %s?%s", URI, query);
495 if (status != 300) {
496 spprintf(&RED, 0, "Redirecting to <a href=\"%s?%s\">%s?%s</a>.\n", URI, query, URI, query);
497 }
498 } else {
499 spprintf(&LOC, 0, "Location: %s", URI);
500 if (status != 300) {
501 spprintf(&RED, 0, "Redirecting to <a href=\"%s\">%s</a>.\n", URI, URI);
502 }
503 }
504
505 efree(URI);
506 if (query) {
507 efree(query);
508 }
509 if (free_params) {
510 zval_dtor(params);
511 FREE_ZVAL(params);
512 }
513
514 switch (status) {
515 case 300:
516 RETVAL_SUCCESS(http_send_status_header(status, LOC));
517 efree(LOC);
518 return;
519
520 case HTTP_REDIRECT_PERM:
521 case HTTP_REDIRECT_FOUND:
522 case HTTP_REDIRECT_POST:
523 case HTTP_REDIRECT_PROXY:
524 case HTTP_REDIRECT_TEMP:
525 break;
526
527 case 306:
528 default:
529 http_error_ex(HE_NOTICE, HTTP_E_RUNTIME, "Unsupported redirection status code: %ld", status);
530 case HTTP_REDIRECT:
531 if ( SG(request_info).request_method &&
532 strcasecmp(SG(request_info).request_method, "HEAD") &&
533 strcasecmp(SG(request_info).request_method, "GET")) {
534 status = HTTP_REDIRECT_POST;
535 } else {
536 status = HTTP_REDIRECT_FOUND;
537 }
538 break;
539 }
540
541 RETURN_SUCCESS(http_exit_ex(status, LOC, RED, 1));
542 }
543 /* }}} */
544
545 /* {{{ proto bool http_send_data(string data)
546 Sends raw data with support for (multiple) range requests. */
547 PHP_FUNCTION(http_send_data)
548 {
549 int data_len;
550 char *data_buf;
551
552 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &data_buf, &data_len) != SUCCESS) {
553 RETURN_FALSE;
554 }
555
556 RETURN_SUCCESS(http_send_data(data_buf, data_len));
557 }
558 /* }}} */
559
560 /* {{{ proto bool http_send_file(string file)
561 Sends a file with support for (multiple) range requests. */
562 PHP_FUNCTION(http_send_file)
563 {
564 char *file;
565 int flen = 0;
566
567 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &file, &flen) != SUCCESS) {
568 RETURN_FALSE;
569 }
570 if (!flen) {
571 RETURN_FALSE;
572 }
573
574 RETURN_SUCCESS(http_send_file(file));
575 }
576 /* }}} */
577
578 /* {{{ proto bool http_send_stream(resource stream)
579 Sends an already opened stream with support for (multiple) range requests. */
580 PHP_FUNCTION(http_send_stream)
581 {
582 zval *zstream;
583 php_stream *file;
584
585 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "r", &zstream) != SUCCESS) {
586 RETURN_FALSE;
587 }
588
589 php_stream_from_zval(file, &zstream);
590 RETURN_SUCCESS(http_send_stream(file));
591 }
592 /* }}} */
593
594 /* {{{ proto string http_chunked_decode(string encoded)
595 Decodes a string that was HTTP-chunked encoded. */
596 PHP_FUNCTION(http_chunked_decode)
597 {
598 char *encoded = NULL, *decoded = NULL;
599 size_t decoded_len = 0;
600 int encoded_len = 0;
601
602 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &encoded, &encoded_len) != SUCCESS) {
603 RETURN_FALSE;
604 }
605
606 if (NULL != http_encoding_dechunk(encoded, encoded_len, &decoded, &decoded_len)) {
607 RETURN_STRINGL(decoded, (int) decoded_len, 0);
608 } else {
609 RETURN_FALSE;
610 }
611 }
612 /* }}} */
613
614 /* {{{ proto object http_parse_message(string message)
615 Parses (a) http_message(s) into a simple recursive object structure. */
616 PHP_FUNCTION(http_parse_message)
617 {
618 char *message;
619 int message_len;
620 http_message *msg = NULL;
621
622 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &message, &message_len)) {
623 RETURN_NULL();
624 }
625
626 if ((msg = http_message_parse(message, message_len))) {
627 object_init(return_value);
628 http_message_tostruct_recursive(msg, return_value);
629 http_message_free(&msg);
630 } else {
631 RETURN_NULL();
632 }
633 }
634 /* }}} */
635
636 /* {{{ proto array http_parse_headers(string header)
637 Parses HTTP headers into an associative array. */
638 PHP_FUNCTION(http_parse_headers)
639 {
640 char *header;
641 int header_len;
642
643 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &header, &header_len)) {
644 RETURN_FALSE;
645 }
646
647 array_init(return_value);
648 if (SUCCESS != http_parse_headers(header, return_value)) {
649 zval_dtor(return_value);
650 http_error(HE_WARNING, HTTP_E_MALFORMED_HEADERS, "Failed to parse headers");
651 RETURN_FALSE;
652 }
653 }
654 /* }}}*/
655
656 /* {{{ proto object http_parse_cookie(string cookie[, int flags[, array allowed_extras]])
657 Parses HTTP cookies like sent in a response into a struct. */
658 PHP_FUNCTION(http_parse_cookie)
659 {
660 char *cookie, **allowed_extras = NULL;
661 int i = 0, cookie_len;
662 long flags = 0;
663 zval *allowed_extras_array = NULL, **entry = NULL;
664 HashPosition pos;
665 http_cookie_list list;
666
667 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|la!", &cookie, &cookie_len, &flags, &allowed_extras_array)) {
668 RETURN_FALSE;
669 }
670
671 if (allowed_extras_array) {
672 allowed_extras = ecalloc(zend_hash_num_elements(Z_ARRVAL_P(allowed_extras_array)) + 1, sizeof(char *));
673 FOREACH_VAL(pos, allowed_extras_array, entry) {
674 ZVAL_ADDREF(*entry);
675 convert_to_string_ex(entry);
676 allowed_extras[i++] = estrndup(Z_STRVAL_PP(entry), Z_STRLEN_PP(entry));
677 zval_ptr_dtor(entry);
678 }
679 }
680
681 if (http_parse_cookie_ex(&list, cookie, flags, allowed_extras)) {
682 object_init(return_value);
683 http_cookie_list_tostruct(&list, return_value);
684 http_cookie_list_dtor(&list);
685 } else {
686 RETVAL_FALSE;
687 }
688
689 if (allowed_extras) {
690 for (i = 0; allowed_extras[i]; ++i) {
691 efree(allowed_extras[i]);
692 }
693 efree(allowed_extras);
694 }
695 }
696 /* }}} */
697
698 /* {{{ proto string http_build_cookie(array cookie)
699 Build a cookie string from an array/object like returned by http_parse_cookie(). */
700 PHP_FUNCTION(http_build_cookie)
701 {
702 char *str = NULL;
703 size_t len = 0;
704 zval *strct;
705 http_cookie_list list;
706
707 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a", &strct)) {
708 RETURN_FALSE;
709 }
710
711 http_cookie_list_fromstruct(&list, strct);
712 http_cookie_list_tostring(&list, &str, &len);
713 http_cookie_list_dtor(&list);
714
715 RETURN_STRINGL(str, len, 0);
716 }
717 /* }}} */
718
719 /* {{{ proto object http_parse_params(string param[, int flags = HTTP_PARAMS_DEFAULT])
720 Parse parameter list. */
721 PHP_FUNCTION(http_parse_params)
722 {
723 char *param;
724 int param_len;
725 zval *params;
726 long flags = HTTP_PARAMS_DEFAULT;
727
728 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &param, &param_len, &flags)) {
729 RETURN_FALSE;
730 }
731
732 params = ecalloc(1, sizeof(zval));
733 array_init(params);
734 if (SUCCESS != http_parse_params(param, flags, Z_ARRVAL_P(params))) {
735 zval_dtor(params);
736 FREE_ZVAL(params);
737 RETURN_FALSE;
738 }
739 object_init(return_value);
740 add_property_zval(return_value, "params", params);
741 }
742 /* }}} */
743
744 /* {{{ proto array http_get_request_headers(void)
745 Get a list of incoming HTTP headers. */
746 PHP_FUNCTION(http_get_request_headers)
747 {
748 NO_ARGS;
749
750 array_init(return_value);
751 http_get_request_headers(Z_ARRVAL_P(return_value));
752 }
753 /* }}} */
754
755 /* {{{ proto string http_get_request_body(void)
756 Get the raw request body (e.g. POST or PUT data). */
757 PHP_FUNCTION(http_get_request_body)
758 {
759 char *body;
760 size_t length;
761
762 NO_ARGS;
763
764 if (SUCCESS == http_get_request_body(&body, &length)) {
765 RETURN_STRINGL(body, (int) length, 0);
766 } else {
767 RETURN_NULL();
768 }
769 }
770 /* }}} */
771
772 /* {{{ proto resource http_get_request_body_stream(void)
773 Create a stream to read the raw request body (e.g. POST or PUT data). This function can only be used once if the request method was another than POST. */
774 PHP_FUNCTION(http_get_request_body_stream)
775 {
776 php_stream *s;
777
778 NO_ARGS;
779
780 if ((s = http_get_request_body_stream())) {
781 php_stream_to_zval(s, return_value);
782 } else {
783 http_error(HE_WARNING, HTTP_E_RUNTIME, "Failed to create request body stream");
784 RETURN_NULL();
785 }
786 }
787 /* }}} */
788
789 /* {{{ proto bool http_match_request_header(string header, string value[, bool match_case = false])
790 Match an incoming HTTP header. */
791 PHP_FUNCTION(http_match_request_header)
792 {
793 char *header, *value;
794 int header_len, value_len;
795 zend_bool match_case = 0;
796
797 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|b", &header, &header_len, &value, &value_len, &match_case)) {
798 RETURN_FALSE;
799 }
800
801 RETURN_BOOL(http_match_request_header_ex(header, value, match_case));
802 }
803 /* }}} */
804
805 /* {{{ HAVE_CURL */
806 #ifdef HTTP_HAVE_CURL
807 #ifdef HTTP_HAVE_PERSISTENT_HANDLES
808
809 /* {{{ proto object http_persistent_handles_count() */
810 PHP_FUNCTION(http_persistent_handles_count)
811 {
812 NO_ARGS;
813 object_init(return_value);
814 if (!http_persistent_handle_statall_ex(HASH_OF(return_value))) {
815 zval_dtor(return_value);
816 RETURN_NULL();
817 }
818 }
819 /* }}} */
820
821 /* {{{ proto void http_persistent_handles_clean([string name]) */
822 PHP_FUNCTION(http_persistent_handles_clean)
823 {
824 char *name_str = NULL;
825 int name_len = 0;
826
827 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &name_str, &name_len)) {
828 http_persistent_handle_cleanup_ex(name_str, name_len, 1);
829 }
830 }
831 /* }}} */
832
833 /* {{{ proto string http_persistent_handles_ident(string ident) */
834 PHP_FUNCTION(http_persistent_handles_ident)
835 {
836 char *ident_str = "";
837 int ident_len = 0;
838
839 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &ident_str, &ident_len)) {
840 RETVAL_STRING(zend_ini_string(ZEND_STRS("http.persistent.handles.ident"), 0), 1);
841 zend_alter_ini_entry(ZEND_STRS("http.persistent.handles.ident"), ident_str, ident_len, ZEND_INI_USER, PHP_INI_STAGE_RUNTIME);
842 }
843 }
844 /* }}} */
845
846 #endif /* HTTP_HAVE_PERSISTENT_HANDLES */
847
848 #define RETVAL_RESPONSE_OR_BODY(request) \
849 { \
850 zval **bodyonly; \
851 \
852 /* check if only the body should be returned */ \
853 if (options && (SUCCESS == zend_hash_find(Z_ARRVAL_P(options), "bodyonly", sizeof("bodyonly"), (void *) &bodyonly)) && zval_is_true(*bodyonly)) { \
854 http_message *msg = http_message_parse(PHPSTR_VAL(&request.conv.response), PHPSTR_LEN(&request.conv.response)); \
855 \
856 if (msg) { \
857 RETVAL_STRINGL(PHPSTR_VAL(&msg->body), PHPSTR_LEN(&msg->body), 1); \
858 http_message_free(&msg); \
859 } \
860 } else { \
861 RETVAL_STRINGL(request.conv.response.data, request.conv.response.used, 1); \
862 } \
863 }
864
865 /* {{{ proto string http_get(string url[, array options[, array &info]])
866 Performs an HTTP GET request on the supplied url. */
867 PHP_FUNCTION(http_get)
868 {
869 zval *options = NULL, *info = NULL;
870 char *URL;
871 int URL_len;
872 http_request request;
873
874 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|a/!z", &URL, &URL_len, &options, &info) != SUCCESS) {
875 RETURN_FALSE;
876 }
877
878 if (info) {
879 zval_dtor(info);
880 array_init(info);
881 }
882
883 RETVAL_FALSE;
884
885 http_request_init_ex(&request, NULL, HTTP_GET, URL);
886 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
887 http_request_exec(&request);
888 if (info) {
889 http_request_info(&request, Z_ARRVAL_P(info));
890 }
891 RETVAL_RESPONSE_OR_BODY(request);
892 }
893 http_request_dtor(&request);
894 }
895 /* }}} */
896
897 /* {{{ proto string http_head(string url[, array options[, array &info]])
898 Performs an HTTP HEAD request on the supplied url. */
899 PHP_FUNCTION(http_head)
900 {
901 zval *options = NULL, *info = NULL;
902 char *URL;
903 int URL_len;
904 http_request request;
905
906 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|a/!z", &URL, &URL_len, &options, &info) != SUCCESS) {
907 RETURN_FALSE;
908 }
909
910 if (info) {
911 zval_dtor(info);
912 array_init(info);
913 }
914
915 RETVAL_FALSE;
916
917 http_request_init_ex(&request, NULL, HTTP_HEAD, URL);
918 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
919 http_request_exec(&request);
920 if (info) {
921 http_request_info(&request, Z_ARRVAL_P(info));
922 }
923 RETVAL_RESPONSE_OR_BODY(request);
924 }
925 http_request_dtor(&request);
926 }
927 /* }}} */
928
929 /* {{{ proto string http_post_data(string url, string data[, array options[, array &info]])
930 Performs an HTTP POST request on the supplied url. */
931 PHP_FUNCTION(http_post_data)
932 {
933 zval *options = NULL, *info = NULL;
934 char *URL, *postdata;
935 int postdata_len, URL_len;
936 http_request_body body;
937 http_request request;
938
939 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &postdata, &postdata_len, &options, &info) != SUCCESS) {
940 RETURN_FALSE;
941 }
942
943 if (info) {
944 zval_dtor(info);
945 array_init(info);
946 }
947
948 RETVAL_FALSE;
949
950 http_request_init_ex(&request, NULL, HTTP_POST, URL);
951 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, postdata, postdata_len, 0);
952 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
953 http_request_exec(&request);
954 if (info) {
955 http_request_info(&request, Z_ARRVAL_P(info));
956 }
957 RETVAL_RESPONSE_OR_BODY(request);
958 }
959 http_request_dtor(&request);
960 }
961 /* }}} */
962
963 /* {{{ proto string http_post_fields(string url, array data[, array files[, array options[, array &info]]])
964 Performs an HTTP POST request on the supplied url. */
965 PHP_FUNCTION(http_post_fields)
966 {
967 zval *options = NULL, *info = NULL, *fields = NULL, *files = NULL;
968 char *URL;
969 int URL_len;
970 http_request_body body;
971 http_request request;
972
973 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sa!|a!a/!z", &URL, &URL_len, &fields, &files, &options, &info) != SUCCESS) {
974 RETURN_FALSE;
975 }
976
977 if (!http_request_body_fill(&body, fields ? Z_ARRVAL_P(fields) : NULL, files ? Z_ARRVAL_P(files) : NULL)) {
978 RETURN_FALSE;
979 }
980
981 if (info) {
982 zval_dtor(info);
983 array_init(info);
984 }
985
986 RETVAL_FALSE;
987
988 http_request_init_ex(&request, NULL, HTTP_POST, URL);
989 request.body = &body;
990 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
991 http_request_exec(&request);
992 if (info) {
993 http_request_info(&request, Z_ARRVAL_P(info));
994 }
995 RETVAL_RESPONSE_OR_BODY(request);
996 }
997 http_request_dtor(&request);
998 }
999 /* }}} */
1000
1001 /* {{{ proto string http_put_file(string url, string file[, array options[, array &info]])
1002 Performs an HTTP PUT request on the supplied url. */
1003 PHP_FUNCTION(http_put_file)
1004 {
1005 char *URL, *file;
1006 int URL_len, f_len;
1007 zval *options = NULL, *info = NULL;
1008 php_stream *stream;
1009 php_stream_statbuf ssb;
1010 http_request_body body;
1011 http_request request;
1012
1013 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &file, &f_len, &options, &info)) {
1014 RETURN_FALSE;
1015 }
1016
1017 if (!(stream = php_stream_open_wrapper_ex(file, "rb", REPORT_ERRORS|ENFORCE_SAFE_MODE, NULL, HTTP_DEFAULT_STREAM_CONTEXT))) {
1018 RETURN_FALSE;
1019 }
1020 if (php_stream_stat(stream, &ssb)) {
1021 php_stream_close(stream);
1022 RETURN_FALSE;
1023 }
1024
1025 if (info) {
1026 zval_dtor(info);
1027 array_init(info);
1028 }
1029
1030 RETVAL_FALSE;
1031
1032 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1033 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_UPLOADFILE, stream, ssb.sb.st_size, 1);
1034 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1035 http_request_exec(&request);
1036 if (info) {
1037 http_request_info(&request, Z_ARRVAL_P(info));
1038 }
1039 RETVAL_RESPONSE_OR_BODY(request);
1040 }
1041 http_request_dtor(&request);
1042 }
1043 /* }}} */
1044
1045 /* {{{ proto string http_put_stream(string url, resource stream[, array options[, array &info]])
1046 Performs an HTTP PUT request on the supplied url. */
1047 PHP_FUNCTION(http_put_stream)
1048 {
1049 zval *resource, *options = NULL, *info = NULL;
1050 char *URL;
1051 int URL_len;
1052 php_stream *stream;
1053 php_stream_statbuf ssb;
1054 http_request_body body;
1055 http_request request;
1056
1057 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sr|a/!z", &URL, &URL_len, &resource, &options, &info)) {
1058 RETURN_FALSE;
1059 }
1060
1061 php_stream_from_zval(stream, &resource);
1062 if (php_stream_stat(stream, &ssb)) {
1063 RETURN_FALSE;
1064 }
1065
1066 if (info) {
1067 zval_dtor(info);
1068 array_init(info);
1069 }
1070
1071 RETVAL_FALSE;
1072
1073 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1074 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_UPLOADFILE, stream, ssb.sb.st_size, 0);
1075 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1076 http_request_exec(&request);
1077 if (info) {
1078 http_request_info(&request, Z_ARRVAL_P(info));
1079 }
1080 RETVAL_RESPONSE_OR_BODY(request);
1081 }
1082 http_request_dtor(&request);
1083 }
1084 /* }}} */
1085
1086 /* {{{ proto string http_put_data(string url, string data[, array options[, array &info]])
1087 Performs an HTTP PUT request on the supplied url. */
1088 PHP_FUNCTION(http_put_data)
1089 {
1090 char *URL, *data;
1091 int URL_len, data_len;
1092 zval *options = NULL, *info = NULL;
1093 http_request_body body;
1094 http_request request;
1095
1096 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &data, &data_len, &options, &info)) {
1097 RETURN_FALSE;
1098 }
1099
1100 if (info) {
1101 zval_dtor(info);
1102 array_init(info);
1103 }
1104
1105 RETVAL_FALSE;
1106
1107 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1108 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, data, data_len, 0);
1109 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1110 http_request_exec(&request);
1111 if (info) {
1112 http_request_info(&request, Z_ARRVAL_P(info));
1113 }
1114 RETVAL_RESPONSE_OR_BODY(request);
1115 }
1116 http_request_dtor(&request);
1117 }
1118 /* }}} */
1119
1120 /* {{{ proto string http_request(int method, string url[, string body[, array options[, array &info]]])
1121 Performs a custom HTTP request on the supplied url. */
1122 PHP_FUNCTION(http_request)
1123 {
1124 long meth;
1125 char *URL, *data = NULL;
1126 int URL_len, data_len = 0;
1127 zval *options = NULL, *info = NULL;
1128 http_request_body body;
1129 http_request request;
1130
1131 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ls|sa/!z", &meth, &URL, &URL_len, &data, &data_len, &options, &info)) {
1132 RETURN_FALSE;
1133 }
1134
1135 if (info) {
1136 zval_dtor(info);
1137 array_init(info);
1138 }
1139
1140 RETVAL_FALSE;
1141
1142 http_request_init_ex(&request, NULL, meth, URL);
1143 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, data, data_len, 0);
1144 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1145 http_request_exec(&request);
1146 if (info) {
1147 http_request_info(&request, Z_ARRVAL_P(info));
1148 }
1149 RETVAL_RESPONSE_OR_BODY(request);
1150 }
1151 http_request_dtor(&request);
1152 }
1153 /* }}} */
1154
1155 /* {{{ proto string http_request_body_encode(array fields, array files)
1156 Generate x-www-form-urlencoded resp. form-data encoded request body. */
1157 PHP_FUNCTION(http_request_body_encode)
1158 {
1159 zval *fields = NULL, *files = NULL;
1160 HashTable *fields_ht, *files_ht;
1161 http_request_body body;
1162 char *buf;
1163 size_t len;
1164
1165 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a!a!", &fields, &files)) {
1166 RETURN_FALSE;
1167 }
1168
1169 fields_ht = (fields && Z_TYPE_P(fields) == IS_ARRAY) ? Z_ARRVAL_P(fields) : NULL;
1170 files_ht = (files && Z_TYPE_P(files) == IS_ARRAY) ? Z_ARRVAL_P(files) : NULL;
1171 if (http_request_body_fill(&body, fields_ht, files_ht) && (SUCCESS == http_request_body_encode(&body, &buf, &len))) {
1172 RETVAL_STRINGL(buf, len, 0);
1173 } else {
1174 http_error(HE_WARNING, HTTP_E_RUNTIME, "Could not encode request body");
1175 RETVAL_FALSE;
1176 }
1177 http_request_body_dtor(&body);
1178 }
1179 #endif /* HTTP_HAVE_CURL */
1180 /* }}} HAVE_CURL */
1181
1182 /* {{{ proto int http_request_method_register(string method)
1183 Register a custom request method. */
1184 PHP_FUNCTION(http_request_method_register)
1185 {
1186 char *method;
1187 int method_len;
1188 ulong existing;
1189
1190 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &method, &method_len)) {
1191 RETURN_FALSE;
1192 }
1193 if ((existing = http_request_method_exists(1, 0, method))) {
1194 RETURN_LONG((long) existing);
1195 }
1196
1197 RETVAL_LONG((long) http_request_method_register(method, method_len));
1198 }
1199 /* }}} */
1200
1201 /* {{{ proto bool http_request_method_unregister(mixed method)
1202 Unregister a previously registered custom request method. */
1203 PHP_FUNCTION(http_request_method_unregister)
1204 {
1205 zval *method;
1206
1207 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/", &method)) {
1208 RETURN_FALSE;
1209 }
1210
1211 switch (Z_TYPE_P(method)) {
1212 case IS_OBJECT:
1213 convert_to_string(method);
1214 case IS_STRING:
1215 if (is_numeric_string(Z_STRVAL_P(method), Z_STRLEN_P(method), NULL, NULL, 1)) {
1216 convert_to_long(method);
1217 } else {
1218 int mn;
1219 if (!(mn = http_request_method_exists(1, 0, Z_STRVAL_P(method)))) {
1220 RETURN_FALSE;
1221 }
1222 zval_dtor(method);
1223 ZVAL_LONG(method, (long)mn);
1224 }
1225 case IS_LONG:
1226 RETURN_SUCCESS(http_request_method_unregister(Z_LVAL_P(method)));
1227 default:
1228 RETURN_FALSE;
1229 }
1230 }
1231 /* }}} */
1232
1233 /* {{{ proto int http_request_method_exists(mixed method)
1234 Check if a request method is registered (or available by default). */
1235 PHP_FUNCTION(http_request_method_exists)
1236 {
1237 if (return_value_used) {
1238 zval *method;
1239
1240 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/", &method)) {
1241 RETURN_FALSE;
1242 }
1243
1244 switch (Z_TYPE_P(method)) {
1245 case IS_OBJECT:
1246 convert_to_string(method);
1247 case IS_STRING:
1248 if (is_numeric_string(Z_STRVAL_P(method), Z_STRLEN_P(method), NULL, NULL, 1)) {
1249 convert_to_long(method);
1250 } else {
1251 RETURN_LONG((long) http_request_method_exists(1, 0, Z_STRVAL_P(method)));
1252 }
1253 case IS_LONG:
1254 RETURN_LONG((long) http_request_method_exists(0, (int) Z_LVAL_P(method), NULL));
1255 default:
1256 RETURN_FALSE;
1257 }
1258 }
1259 }
1260 /* }}} */
1261
1262 /* {{{ proto string http_request_method_name(int method)
1263 Get the literal string representation of a standard or registered request method. */
1264 PHP_FUNCTION(http_request_method_name)
1265 {
1266 if (return_value_used) {
1267 long method;
1268
1269 if ((SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &method)) || (method < 0)) {
1270 RETURN_FALSE;
1271 }
1272
1273 RETURN_STRING(estrdup(http_request_method_name((int) method)), 0);
1274 }
1275 }
1276 /* }}} */
1277
1278 /* {{{ */
1279 #ifdef HTTP_HAVE_ZLIB
1280
1281 /* {{{ proto string http_deflate(string data[, int flags = 0])
1282 Compress data with gzip, zlib AKA deflate or raw deflate encoding. */
1283 PHP_FUNCTION(http_deflate)
1284 {
1285 char *data;
1286 int data_len;
1287 long flags = 0;
1288
1289 RETVAL_NULL();
1290
1291 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &data, &data_len, &flags)) {
1292 char *encoded;
1293 size_t encoded_len;
1294
1295 if (SUCCESS == http_encoding_deflate(flags, data, data_len, &encoded, &encoded_len)) {
1296 RETURN_STRINGL(encoded, (int) encoded_len, 0);
1297 }
1298 }
1299 }
1300 /* }}} */
1301
1302 /* {{{ proto string http_inflate(string data)
1303 Decompress data compressed with either gzip, deflate AKA zlib or raw deflate encoding. */
1304 PHP_FUNCTION(http_inflate)
1305 {
1306 char *data;
1307 int data_len;
1308
1309 RETVAL_NULL();
1310
1311 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &data, &data_len)) {
1312 char *decoded;
1313 size_t decoded_len;
1314
1315 if (SUCCESS == http_encoding_inflate(data, data_len, &decoded, &decoded_len)) {
1316 RETURN_STRINGL(decoded, (int) decoded_len, 0);
1317 }
1318 }
1319 }
1320 /* }}} */
1321
1322 /* {{{ proto string ob_deflatehandler(string data, int mode)
1323 For use with ob_start(). The deflate output buffer handler can only be used once. */
1324 PHP_FUNCTION(ob_deflatehandler)
1325 {
1326 char *data;
1327 int data_len;
1328 long mode;
1329
1330 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl", &data, &data_len, &mode)) {
1331 RETURN_FALSE;
1332 }
1333
1334 http_ob_deflatehandler(data, data_len, &Z_STRVAL_P(return_value), (uint *) &Z_STRLEN_P(return_value), mode);
1335 Z_TYPE_P(return_value) = Z_STRVAL_P(return_value) ? IS_STRING : IS_NULL;
1336 }
1337 /* }}} */
1338
1339 /* {{{ proto string ob_inflatehandler(string data, int mode)
1340 For use with ob_start(). Same restrictions as with ob_deflatehandler apply. */
1341 PHP_FUNCTION(ob_inflatehandler)
1342 {
1343 char *data;
1344 int data_len;
1345 long mode;
1346
1347 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl", &data, &data_len, &mode)) {
1348 RETURN_FALSE;
1349 }
1350
1351 http_ob_inflatehandler(data, data_len, &Z_STRVAL_P(return_value), (uint *) &Z_STRLEN_P(return_value), mode);
1352 Z_TYPE_P(return_value) = Z_STRVAL_P(return_value) ? IS_STRING : IS_NULL;
1353 }
1354 /* }}} */
1355
1356 #endif /* HTTP_HAVE_ZLIB */
1357 /* }}} */
1358
1359 /* {{{ proto int http_support([int feature = 0])
1360 Check for feature that require external libraries. */
1361 PHP_FUNCTION(http_support)
1362 {
1363 long feature = 0;
1364
1365 RETVAL_LONG(0L);
1366
1367 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &feature)) {
1368 RETVAL_LONG(http_support(feature));
1369 }
1370 }
1371 /* }}} */
1372
1373 /*
1374 * Local variables:
1375 * tab-width: 4
1376 * c-basic-offset: 4
1377 * End:
1378 * vim600: noet sw=4 ts=4 fdm=marker
1379 * vim<600: noet sw=4 ts=4
1380 */
1381