projects / m6w6 / ext-http / blob
? search:
summary | shortlog | log | commit | commitdiff | tree | github
history | raw | HEAD
- move some definitions around
[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 char **names;
813 int *counts;
814 int i, n;
815
816 NO_ARGS;
817
818 if ((n = http_persistent_handle_statall(&names, &counts))) {
819 object_init(return_value);
820 for (i = 0; i < n; ++i) {
821 add_property_long(return_value, names[i], counts[i]);
822 efree(names[i]);
823 }
824 efree(names);
825 efree(counts);
826 }
827 }
828 /* }}} */
829
830 /* {{{ proto void http_persistent_handles_clean([string name]) */
831 PHP_FUNCTION(http_persistent_handles_clean)
832 {
833 char *name_str = NULL;
834 int name_len = 0;
835
836 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|s", &name_str, &name_len)) {
837 http_persistent_handle_cleanup_ex(name_str, name_len);
838 }
839 }
840 /* }}} */
841
842 #endif /* HTTP_HAVE_PERSISTENT_HANDLES */
843
844 #define RETVAL_RESPONSE_OR_BODY(request) \
845 { \
846 zval **bodyonly; \
847 \
848 /* check if only the body should be returned */ \
849 if (options && (SUCCESS == zend_hash_find(Z_ARRVAL_P(options), "bodyonly", sizeof("bodyonly"), (void *) &bodyonly)) && zval_is_true(*bodyonly)) { \
850 http_message *msg = http_message_parse(PHPSTR_VAL(&request.conv.response), PHPSTR_LEN(&request.conv.response)); \
851 \
852 if (msg) { \
853 RETVAL_STRINGL(PHPSTR_VAL(&msg->body), PHPSTR_LEN(&msg->body), 1); \
854 http_message_free(&msg); \
855 } \
856 } else { \
857 RETVAL_STRINGL(request.conv.response.data, request.conv.response.used, 1); \
858 } \
859 }
860
861 /* {{{ proto string http_get(string url[, array options[, array &info]])
862 Performs an HTTP GET request on the supplied url. */
863 PHP_FUNCTION(http_get)
864 {
865 zval *options = NULL, *info = NULL;
866 char *URL;
867 int URL_len;
868 http_request request;
869
870 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|a/!z", &URL, &URL_len, &options, &info) != SUCCESS) {
871 RETURN_FALSE;
872 }
873
874 if (info) {
875 zval_dtor(info);
876 array_init(info);
877 }
878
879 RETVAL_FALSE;
880
881 http_request_init_ex(&request, NULL, HTTP_GET, URL);
882 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
883 http_request_exec(&request);
884 if (info) {
885 http_request_info(&request, Z_ARRVAL_P(info));
886 }
887 RETVAL_RESPONSE_OR_BODY(request);
888 }
889 http_request_dtor(&request);
890 }
891 /* }}} */
892
893 /* {{{ proto string http_head(string url[, array options[, array &info]])
894 Performs an HTTP HEAD request on the supplied url. */
895 PHP_FUNCTION(http_head)
896 {
897 zval *options = NULL, *info = NULL;
898 char *URL;
899 int URL_len;
900 http_request request;
901
902 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|a/!z", &URL, &URL_len, &options, &info) != SUCCESS) {
903 RETURN_FALSE;
904 }
905
906 if (info) {
907 zval_dtor(info);
908 array_init(info);
909 }
910
911 RETVAL_FALSE;
912
913 http_request_init_ex(&request, NULL, HTTP_HEAD, URL);
914 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
915 http_request_exec(&request);
916 if (info) {
917 http_request_info(&request, Z_ARRVAL_P(info));
918 }
919 RETVAL_RESPONSE_OR_BODY(request);
920 }
921 http_request_dtor(&request);
922 }
923 /* }}} */
924
925 /* {{{ proto string http_post_data(string url, string data[, array options[, array &info]])
926 Performs an HTTP POST request on the supplied url. */
927 PHP_FUNCTION(http_post_data)
928 {
929 zval *options = NULL, *info = NULL;
930 char *URL, *postdata;
931 int postdata_len, URL_len;
932 http_request_body body;
933 http_request request;
934
935 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &postdata, &postdata_len, &options, &info) != SUCCESS) {
936 RETURN_FALSE;
937 }
938
939 if (info) {
940 zval_dtor(info);
941 array_init(info);
942 }
943
944 RETVAL_FALSE;
945
946 http_request_init_ex(&request, NULL, HTTP_POST, URL);
947 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, postdata, postdata_len, 0);
948 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
949 http_request_exec(&request);
950 if (info) {
951 http_request_info(&request, Z_ARRVAL_P(info));
952 }
953 RETVAL_RESPONSE_OR_BODY(request);
954 }
955 http_request_dtor(&request);
956 }
957 /* }}} */
958
959 /* {{{ proto string http_post_fields(string url, array data[, array files[, array options[, array &info]]])
960 Performs an HTTP POST request on the supplied url. */
961 PHP_FUNCTION(http_post_fields)
962 {
963 zval *options = NULL, *info = NULL, *fields = NULL, *files = NULL;
964 char *URL;
965 int URL_len;
966 http_request_body body;
967 http_request request;
968
969 if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sa!|a!a/!z", &URL, &URL_len, &fields, &files, &options, &info) != SUCCESS) {
970 RETURN_FALSE;
971 }
972
973 if (!http_request_body_fill(&body, fields ? Z_ARRVAL_P(fields) : NULL, files ? Z_ARRVAL_P(files) : NULL)) {
974 RETURN_FALSE;
975 }
976
977 if (info) {
978 zval_dtor(info);
979 array_init(info);
980 }
981
982 RETVAL_FALSE;
983
984 http_request_init_ex(&request, NULL, HTTP_POST, URL);
985 request.body = &body;
986 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
987 http_request_exec(&request);
988 if (info) {
989 http_request_info(&request, Z_ARRVAL_P(info));
990 }
991 RETVAL_RESPONSE_OR_BODY(request);
992 }
993 http_request_dtor(&request);
994 }
995 /* }}} */
996
997 /* {{{ proto string http_put_file(string url, string file[, array options[, array &info]])
998 Performs an HTTP PUT request on the supplied url. */
999 PHP_FUNCTION(http_put_file)
1000 {
1001 char *URL, *file;
1002 int URL_len, f_len;
1003 zval *options = NULL, *info = NULL;
1004 php_stream *stream;
1005 php_stream_statbuf ssb;
1006 http_request_body body;
1007 http_request request;
1008
1009 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &file, &f_len, &options, &info)) {
1010 RETURN_FALSE;
1011 }
1012
1013 if (!(stream = php_stream_open_wrapper_ex(file, "rb", REPORT_ERRORS|ENFORCE_SAFE_MODE, NULL, HTTP_DEFAULT_STREAM_CONTEXT))) {
1014 RETURN_FALSE;
1015 }
1016 if (php_stream_stat(stream, &ssb)) {
1017 php_stream_close(stream);
1018 RETURN_FALSE;
1019 }
1020
1021 if (info) {
1022 zval_dtor(info);
1023 array_init(info);
1024 }
1025
1026 RETVAL_FALSE;
1027
1028 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1029 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_UPLOADFILE, stream, ssb.sb.st_size, 1);
1030 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1031 http_request_exec(&request);
1032 if (info) {
1033 http_request_info(&request, Z_ARRVAL_P(info));
1034 }
1035 RETVAL_RESPONSE_OR_BODY(request);
1036 }
1037 http_request_dtor(&request);
1038 }
1039 /* }}} */
1040
1041 /* {{{ proto string http_put_stream(string url, resource stream[, array options[, array &info]])
1042 Performs an HTTP PUT request on the supplied url. */
1043 PHP_FUNCTION(http_put_stream)
1044 {
1045 zval *resource, *options = NULL, *info = NULL;
1046 char *URL;
1047 int URL_len;
1048 php_stream *stream;
1049 php_stream_statbuf ssb;
1050 http_request_body body;
1051 http_request request;
1052
1053 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sr|a/!z", &URL, &URL_len, &resource, &options, &info)) {
1054 RETURN_FALSE;
1055 }
1056
1057 php_stream_from_zval(stream, &resource);
1058 if (php_stream_stat(stream, &ssb)) {
1059 RETURN_FALSE;
1060 }
1061
1062 if (info) {
1063 zval_dtor(info);
1064 array_init(info);
1065 }
1066
1067 RETVAL_FALSE;
1068
1069 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1070 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_UPLOADFILE, stream, ssb.sb.st_size, 0);
1071 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1072 http_request_exec(&request);
1073 if (info) {
1074 http_request_info(&request, Z_ARRVAL_P(info));
1075 }
1076 RETVAL_RESPONSE_OR_BODY(request);
1077 }
1078 http_request_dtor(&request);
1079 }
1080 /* }}} */
1081
1082 /* {{{ proto string http_put_data(string url, string data[, array options[, array &info]])
1083 Performs an HTTP PUT request on the supplied url. */
1084 PHP_FUNCTION(http_put_data)
1085 {
1086 char *URL, *data;
1087 int URL_len, data_len;
1088 zval *options = NULL, *info = NULL;
1089 http_request_body body;
1090 http_request request;
1091
1092 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|a/!z", &URL, &URL_len, &data, &data_len, &options, &info)) {
1093 RETURN_FALSE;
1094 }
1095
1096 if (info) {
1097 zval_dtor(info);
1098 array_init(info);
1099 }
1100
1101 RETVAL_FALSE;
1102
1103 http_request_init_ex(&request, NULL, HTTP_PUT, URL);
1104 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, data, data_len, 0);
1105 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1106 http_request_exec(&request);
1107 if (info) {
1108 http_request_info(&request, Z_ARRVAL_P(info));
1109 }
1110 RETVAL_RESPONSE_OR_BODY(request);
1111 }
1112 http_request_dtor(&request);
1113 }
1114 /* }}} */
1115
1116 /* {{{ proto string http_request(int method, string url[, string body[, array options[, array &info]]])
1117 Performs a custom HTTP request on the supplied url. */
1118 PHP_FUNCTION(http_request)
1119 {
1120 long meth;
1121 char *URL, *data = NULL;
1122 int URL_len, data_len = 0;
1123 zval *options = NULL, *info = NULL;
1124 http_request_body body;
1125 http_request request;
1126
1127 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ls|sa/!z", &meth, &URL, &URL_len, &data, &data_len, &options, &info)) {
1128 RETURN_FALSE;
1129 }
1130
1131 if (info) {
1132 zval_dtor(info);
1133 array_init(info);
1134 }
1135
1136 RETVAL_FALSE;
1137
1138 http_request_init_ex(&request, NULL, meth, URL);
1139 request.body = http_request_body_init_ex(&body, HTTP_REQUEST_BODY_CSTRING, data, data_len, 0);
1140 if (SUCCESS == http_request_prepare(&request, options?Z_ARRVAL_P(options):NULL)) {
1141 http_request_exec(&request);
1142 if (info) {
1143 http_request_info(&request, Z_ARRVAL_P(info));
1144 }
1145 RETVAL_RESPONSE_OR_BODY(request);
1146 }
1147 http_request_dtor(&request);
1148 }
1149 /* }}} */
1150
1151 /* {{{ proto string http_request_body_encode(array fields, array files)
1152 Generate x-www-form-urlencoded resp. form-data encoded request body. */
1153 PHP_FUNCTION(http_request_body_encode)
1154 {
1155 zval *fields = NULL, *files = NULL;
1156 HashTable *fields_ht, *files_ht;
1157 http_request_body body;
1158 char *buf;
1159 size_t len;
1160
1161 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "a!a!", &fields, &files)) {
1162 RETURN_FALSE;
1163 }
1164
1165 fields_ht = (fields && Z_TYPE_P(fields) == IS_ARRAY) ? Z_ARRVAL_P(fields) : NULL;
1166 files_ht = (files && Z_TYPE_P(files) == IS_ARRAY) ? Z_ARRVAL_P(files) : NULL;
1167 if (http_request_body_fill(&body, fields_ht, files_ht) && (SUCCESS == http_request_body_encode(&body, &buf, &len))) {
1168 RETVAL_STRINGL(buf, len, 0);
1169 } else {
1170 http_error(HE_WARNING, HTTP_E_RUNTIME, "Could not encode request body");
1171 RETVAL_FALSE;
1172 }
1173 http_request_body_dtor(&body);
1174 }
1175 #endif /* HTTP_HAVE_CURL */
1176 /* }}} HAVE_CURL */
1177
1178 /* {{{ proto int http_request_method_register(string method)
1179 Register a custom request method. */
1180 PHP_FUNCTION(http_request_method_register)
1181 {
1182 char *method;
1183 int method_len;
1184 ulong existing;
1185
1186 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &method, &method_len)) {
1187 RETURN_FALSE;
1188 }
1189 if ((existing = http_request_method_exists(1, 0, method))) {
1190 RETURN_LONG((long) existing);
1191 }
1192
1193 RETVAL_LONG((long) http_request_method_register(method, method_len));
1194 }
1195 /* }}} */
1196
1197 /* {{{ proto bool http_request_method_unregister(mixed method)
1198 Unregister a previously registered custom request method. */
1199 PHP_FUNCTION(http_request_method_unregister)
1200 {
1201 zval *method;
1202
1203 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/", &method)) {
1204 RETURN_FALSE;
1205 }
1206
1207 switch (Z_TYPE_P(method)) {
1208 case IS_OBJECT:
1209 convert_to_string(method);
1210 case IS_STRING:
1211 if (is_numeric_string(Z_STRVAL_P(method), Z_STRLEN_P(method), NULL, NULL, 1)) {
1212 convert_to_long(method);
1213 } else {
1214 int mn;
1215 if (!(mn = http_request_method_exists(1, 0, Z_STRVAL_P(method)))) {
1216 RETURN_FALSE;
1217 }
1218 zval_dtor(method);
1219 ZVAL_LONG(method, (long)mn);
1220 }
1221 case IS_LONG:
1222 RETURN_SUCCESS(http_request_method_unregister(Z_LVAL_P(method)));
1223 default:
1224 RETURN_FALSE;
1225 }
1226 }
1227 /* }}} */
1228
1229 /* {{{ proto int http_request_method_exists(mixed method)
1230 Check if a request method is registered (or available by default). */
1231 PHP_FUNCTION(http_request_method_exists)
1232 {
1233 if (return_value_used) {
1234 zval *method;
1235
1236 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z/", &method)) {
1237 RETURN_FALSE;
1238 }
1239
1240 switch (Z_TYPE_P(method)) {
1241 case IS_OBJECT:
1242 convert_to_string(method);
1243 case IS_STRING:
1244 if (is_numeric_string(Z_STRVAL_P(method), Z_STRLEN_P(method), NULL, NULL, 1)) {
1245 convert_to_long(method);
1246 } else {
1247 RETURN_LONG((long) http_request_method_exists(1, 0, Z_STRVAL_P(method)));
1248 }
1249 case IS_LONG:
1250 RETURN_LONG((long) http_request_method_exists(0, (int) Z_LVAL_P(method), NULL));
1251 default:
1252 RETURN_FALSE;
1253 }
1254 }
1255 }
1256 /* }}} */
1257
1258 /* {{{ proto string http_request_method_name(int method)
1259 Get the literal string representation of a standard or registered request method. */
1260 PHP_FUNCTION(http_request_method_name)
1261 {
1262 if (return_value_used) {
1263 long method;
1264
1265 if ((SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "l", &method)) || (method < 0)) {
1266 RETURN_FALSE;
1267 }
1268
1269 RETURN_STRING(estrdup(http_request_method_name((int) method)), 0);
1270 }
1271 }
1272 /* }}} */
1273
1274 /* {{{ */
1275 #ifdef HTTP_HAVE_ZLIB
1276
1277 /* {{{ proto string http_deflate(string data[, int flags = 0])
1278 Compress data with gzip, zlib AKA deflate or raw deflate encoding. */
1279 PHP_FUNCTION(http_deflate)
1280 {
1281 char *data;
1282 int data_len;
1283 long flags = 0;
1284
1285 RETVAL_NULL();
1286
1287 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|l", &data, &data_len, &flags)) {
1288 char *encoded;
1289 size_t encoded_len;
1290
1291 if (SUCCESS == http_encoding_deflate(flags, data, data_len, &encoded, &encoded_len)) {
1292 RETURN_STRINGL(encoded, (int) encoded_len, 0);
1293 }
1294 }
1295 }
1296 /* }}} */
1297
1298 /* {{{ proto string http_inflate(string data)
1299 Decompress data compressed with either gzip, deflate AKA zlib or raw deflate encoding. */
1300 PHP_FUNCTION(http_inflate)
1301 {
1302 char *data;
1303 int data_len;
1304
1305 RETVAL_NULL();
1306
1307 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &data, &data_len)) {
1308 char *decoded;
1309 size_t decoded_len;
1310
1311 if (SUCCESS == http_encoding_inflate(data, data_len, &decoded, &decoded_len)) {
1312 RETURN_STRINGL(decoded, (int) decoded_len, 0);
1313 }
1314 }
1315 }
1316 /* }}} */
1317
1318 /* {{{ proto string ob_deflatehandler(string data, int mode)
1319 For use with ob_start(). The deflate output buffer handler can only be used once. */
1320 PHP_FUNCTION(ob_deflatehandler)
1321 {
1322 char *data;
1323 int data_len;
1324 long mode;
1325
1326 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl", &data, &data_len, &mode)) {
1327 RETURN_FALSE;
1328 }
1329
1330 http_ob_deflatehandler(data, data_len, &Z_STRVAL_P(return_value), (uint *) &Z_STRLEN_P(return_value), mode);
1331 Z_TYPE_P(return_value) = Z_STRVAL_P(return_value) ? IS_STRING : IS_NULL;
1332 }
1333 /* }}} */
1334
1335 /* {{{ proto string ob_inflatehandler(string data, int mode)
1336 For use with ob_start(). Same restrictions as with ob_deflatehandler apply. */
1337 PHP_FUNCTION(ob_inflatehandler)
1338 {
1339 char *data;
1340 int data_len;
1341 long mode;
1342
1343 if (SUCCESS != zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sl", &data, &data_len, &mode)) {
1344 RETURN_FALSE;
1345 }
1346
1347 http_ob_inflatehandler(data, data_len, &Z_STRVAL_P(return_value), (uint *) &Z_STRLEN_P(return_value), mode);
1348 Z_TYPE_P(return_value) = Z_STRVAL_P(return_value) ? IS_STRING : IS_NULL;
1349 }
1350 /* }}} */
1351
1352 #endif /* HTTP_HAVE_ZLIB */
1353 /* }}} */
1354
1355 /* {{{ proto int http_support([int feature = 0])
1356 Check for feature that require external libraries. */
1357 PHP_FUNCTION(http_support)
1358 {
1359 long feature = 0;
1360
1361 RETVAL_LONG(0L);
1362
1363 if (SUCCESS == zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|l", &feature)) {
1364 RETVAL_LONG(http_support(feature));
1365 }
1366 }
1367 /* }}} */
1368
1369 /*
1370 * Local variables:
1371 * tab-width: 4
1372 * c-basic-offset: 4
1373 * End:
1374 * vim600: noet sw=4 ts=4 fdm=marker
1375 * vim<600: noet sw=4 ts=4
1376 */
1377
Extended HTTP Support