2 +--------------------------------------------------------------------+
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-2014, Michael Wallner <mike@php.net> |
10 +--------------------------------------------------------------------+
13 #ifndef PHP_HTTP_URL_H
14 #define PHP_HTTP_URL_H
16 #include <ext/standard/url.h>
18 #define PHP_HTTP_URL_REPLACE 0x000
19 #define PHP_HTTP_URL_JOIN_PATH 0x001
20 #define PHP_HTTP_URL_JOIN_QUERY 0x002
21 #define PHP_HTTP_URL_STRIP_USER 0x004
22 #define PHP_HTTP_URL_STRIP_PASS 0x008
23 #define PHP_HTTP_URL_STRIP_AUTH (PHP_HTTP_URL_STRIP_USER|PHP_HTTP_URL_STRIP_PASS)
24 #define PHP_HTTP_URL_STRIP_PORT 0x020
25 #define PHP_HTTP_URL_STRIP_PATH 0x040
26 #define PHP_HTTP_URL_STRIP_QUERY 0x080
27 #define PHP_HTTP_URL_STRIP_FRAGMENT 0x100
28 #define PHP_HTTP_URL_STRIP_ALL ( \
29 PHP_HTTP_URL_STRIP_AUTH | \
30 PHP_HTTP_URL_STRIP_PORT | \
31 PHP_HTTP_URL_STRIP_PATH | \
32 PHP_HTTP_URL_STRIP_QUERY | \
33 PHP_HTTP_URL_STRIP_FRAGMENT \
35 #define PHP_HTTP_URL_FROM_ENV 0x1000
36 #define PHP_HTTP_URL_SANITIZE_PATH 0x2000
38 typedef struct php_http_url_part
{
41 } php_http_url_part_t
;
43 #define PHP_HTTP_URL_PARSE_MBLOC 0x001
44 #define PHP_HTTP_URL_PARSE_MBUTF8 0x002
45 #define PHP_HTTP_URL_PARSE_IDN 0x010
47 typedef struct php_http_url
{
48 php_http_url_part_t scheme
;
51 php_http_url_part_t username
;
52 php_http_url_part_t password
;
54 php_http_url_part_t host
;
57 php_http_url_part_t path
;
58 php_http_url_part_t query
;
59 php_http_url_part_t fragment
;
66 PHP_HTTP_API php_http_url_t
*php_http_url_init(php_http_url_t
*url
, const char *str
, size_t len
, unsigned flags TSRMLS_DC
);
67 PHP_HTTP_API
void php_http_url_dtor(php_http_url_t
*url
);
68 PHP_HTTP_API
void php_http_url_free(php_http_url_t
**url
);
70 PHP_HTTP_API
void php_http_url(int flags
, const php_url
*old_url
, const php_url
*new_url
, php_url
**url_ptr
, char **url_str
, size_t *url_len TSRMLS_DC
);
72 PHP_HTTP_API STATUS
php_http_url_encode_hash(HashTable
*hash
, const char *pre_encoded_str
, size_t pre_encoded_len
, char **encoded_str
, size_t *encoded_len TSRMLS_DC
);
73 PHP_HTTP_API STATUS
php_http_url_encode_hash_ex(HashTable
*hash
, php_http_buffer_t
*qstr
, const char *arg_sep_str
, size_t arg_sep_len
, const char *val_sep_str
, size_t val_sep_len
, const char *pre_encoded_str
, size_t pre_encoded_len TSRMLS_DC
);
75 static inline void php_http_url_argsep(const char **str
, size_t *len TSRMLS_DC
)
77 if (SUCCESS
!= php_http_ini_entry(ZEND_STRL("arg_separator.output"), str
, len
, 0 TSRMLS_CC
) || !*len
) {
78 *str
= PHP_HTTP_URL_ARGSEP
;
79 *len
= lenof(PHP_HTTP_URL_ARGSEP
);
83 static inline void php_http_url_to_string(php_url
*url
, char **url_str
, size_t *url_len TSRMLS_DC
)
85 php_http_buffer_t buf
;
87 php_http_buffer_init(&buf
);
89 if (url
->scheme
&& *url
->scheme
) {
90 php_http_buffer_appendl(&buf
, url
->scheme
);
91 php_http_buffer_appends(&buf
, "://");
93 php_http_buffer_appends(&buf
, "//");
96 if (url
->user
&& *url
->user
) {
97 php_http_buffer_appendl(&buf
, url
->user
);
98 if (url
->pass
&& *url
->pass
) {
99 php_http_buffer_appends(&buf
, ":");
100 php_http_buffer_appendl(&buf
, url
->pass
);
102 php_http_buffer_appends(&buf
, "@");
105 if (url
->host
&& *url
->host
) {
106 php_http_buffer_appendl(&buf
, url
->host
);
108 php_http_buffer_appends(&buf
, "localhost");
112 php_http_buffer_appendf(&buf
, ":%hu", url
->port
);
115 if (url
->path
&& *url
->path
) {
116 php_http_buffer_appendl(&buf
, url
->path
);
119 if (url
->query
&& *url
->query
) {
120 php_http_buffer_appends(&buf
, "?");
121 php_http_buffer_appendl(&buf
, url
->query
);
124 if (url
->fragment
&& *url
->fragment
) {
125 php_http_buffer_appends(&buf
, "#");
126 php_http_buffer_appendl(&buf
, url
->fragment
);
129 php_http_buffer_shrink(&buf
);
130 php_http_buffer_fix(&buf
);
139 php_http_buffer_dtor(&buf
);
143 static inline php_url
*php_http_url_from_struct(php_url
*url
, HashTable
*ht TSRMLS_DC
)
148 url
= emalloc(sizeof(*url
));
150 memset(url
, 0, sizeof(*url
));
152 if (SUCCESS
== zend_hash_find(ht
, "scheme", sizeof("scheme"), (void *) &e
)) {
153 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
154 url
->scheme
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
157 if (SUCCESS
== zend_hash_find(ht
, "user", sizeof("user"), (void *) &e
)) {
158 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
159 url
->user
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
162 if (SUCCESS
== zend_hash_find(ht
, "pass", sizeof("pass"), (void *) &e
)) {
163 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
164 url
->pass
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
167 if (SUCCESS
== zend_hash_find(ht
, "host", sizeof("host"), (void *) &e
)) {
168 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
169 url
->host
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
172 if (SUCCESS
== zend_hash_find(ht
, "path", sizeof("path"), (void *) &e
)) {
173 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
174 url
->path
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
177 if (SUCCESS
== zend_hash_find(ht
, "query", sizeof("query"), (void *) &e
)) {
178 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
179 url
->query
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
182 if (SUCCESS
== zend_hash_find(ht
, "fragment", sizeof("fragment"), (void *) &e
)) {
183 zval
*cpy
= php_http_ztyp(IS_STRING
, *e
);
184 url
->fragment
= estrndup(Z_STRVAL_P(cpy
), Z_STRLEN_P(cpy
));
187 if (SUCCESS
== zend_hash_find(ht
, "port", sizeof("port"), (void *) &e
)) {
188 zval
*cpy
= php_http_ztyp(IS_LONG
, *e
);
189 url
->port
= (unsigned short) Z_LVAL_P(cpy
);
196 static inline HashTable
*php_http_url_to_struct(php_url
*url
, zval
*strct TSRMLS_DC
)
201 switch (Z_TYPE_P(strct
)) {
208 INIT_PZVAL_ARRAY((&arr
), HASH_OF(strct
));
218 add_assoc_string(&arr
, "scheme", url
->scheme
, 1);
221 add_assoc_string(&arr
, "user", url
->user
, 1);
224 add_assoc_string(&arr
, "pass", url
->pass
, 1);
227 add_assoc_string(&arr
, "host", url
->host
, 1);
230 add_assoc_long(&arr
, "port", (long) url
->port
);
233 add_assoc_string(&arr
, "path", url
->path
, 1);
236 add_assoc_string(&arr
, "query", url
->query
, 1);
239 add_assoc_string(&arr
, "fragment", url
->fragment
, 1);
243 return Z_ARRVAL(arr
);
246 PHP_HTTP_API zend_class_entry
*php_http_url_class_entry
;
247 PHP_MINIT_FUNCTION(http_url
);
249 #define php_http_url_object_new php_http_object_new
250 #define php_http_url_object_new_ex php_http_object_new_ex
259 * vim600: noet sw=4 ts=4 fdm=marker
260 * vim<600: noet sw=4 ts=4