bef8cc8b97d14cdf94548db85c82868e261e3ddb
[m6w6/ext-http] / php_http_cache_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_CACHE_API_H
19 #define PHP_HTTP_CACHE_API_H
20
21 #include "zend_ini.h"
22
23 #include "ext/standard/md5.h"
24 #include "ext/standard/sha1.h"
25
26 #include "php_http_std_defs.h"
27 #include "php_http.h"
28 #include "php_http_api.h"
29 #include "php_http_send_api.h"
30
31 #ifdef HAVE_LIBMHASH
32 # include <mhash.h>
33 #endif
34
35 ZEND_EXTERN_MODULE_GLOBALS(http);
36
37 typedef enum {
38 HTTP_ETAG_MD5 = -2,
39 HTTP_ETAG_SHA1 = -1,
40 HTTP_ETAG_MHASH = 0,
41 } http_etag_mode;
42
43 #ifdef HAVE_LIBMHASH
44 static void *http_etag_alloc_mhash_digest(size_t size)
45 {
46 return emalloc(size);
47 }
48 #endif
49
50 #define http_etag_digest(d, l) _http_etag_digest((d), (l) TSRMLS_CC)
51 static inline char *_http_etag_digest(const unsigned char *digest, int len TSRMLS_DC)
52 {
53 int i;
54 char *hex = emalloc(len * 2 + 1);
55 char *ptr = hex;
56
57 /* optimize this --
58 look at apache's make_etag */
59 for (i = 0; i < len; ++i) {
60 sprintf(ptr, "%02x", digest[i]);
61 ptr += 2;
62 }
63 *ptr = '\0';
64
65 return hex;
66 }
67
68 #define http_etag_init() _http_etag_init(TSRMLS_C)
69 static inline void *_http_etag_init(TSRMLS_D)
70 {
71 void *ctx;
72 long mode = INI_INT("http.etag_mode");
73
74 switch (mode)
75 {
76 case HTTP_ETAG_SHA1:
77 PHP_SHA1Init(ctx = emalloc(sizeof(PHP_SHA1_CTX)));
78 break;
79
80 case HTTP_ETAG_MD5:
81 invalid_flag:
82 PHP_MD5Init(ctx = emalloc(sizeof(PHP_MD5_CTX)));
83 break;
84
85 default:
86 {
87 #ifdef HAVE_LIBMHASH
88 if ((mode >= 0) && (mode <= mhash_count())) {
89 ctx = mhash_init(mode);
90 }
91 if ((!ctx) || (ctx == MHASH_FAILED))
92 #endif
93 {
94 HTTP_G(etag).mode = HTTP_ETAG_MD5;
95 goto invalid_flag;
96 }
97 }
98 break;
99 }
100
101 return ctx;
102 }
103
104 #define http_etag_finish(c) _http_etag_finish((c) TSRMLS_CC)
105 static inline char *_http_etag_finish(void *ctx TSRMLS_DC)
106 {
107 char *etag = NULL;
108 unsigned char digest[20];
109 long mode = INI_INT("http.etag_mode");
110
111 switch (mode)
112 {
113 case HTTP_ETAG_SHA1:
114 PHP_SHA1Final(digest, ctx);
115 etag = http_etag_digest(digest, 20);
116 efree(ctx);
117 break;
118
119 case HTTP_ETAG_MD5:
120 PHP_MD5Final(digest, ctx);
121 etag = http_etag_digest(digest, 16);
122 efree(ctx);
123 break;
124
125 default:
126 {
127 #ifdef HAVE_LIBMHASH
128 unsigned char *mhash_digest = mhash_end_m(ctx, http_etag_alloc_mhash_digest);
129 etag = http_etag_digest(mhash_digest, mhash_get_block_size(mode));
130 efree(mhash_digest);
131 #endif
132 }
133 break;
134 }
135
136 return etag;
137 }
138
139 #define http_etag_update(c, d, l) _http_etag_update((c), (d), (l) TSRMLS_CC)
140 static inline void _http_etag_update(void *ctx, const char *data_ptr, size_t data_len TSRMLS_DC)
141 {
142 switch (INI_INT("http.etag_mode"))
143 {
144 case HTTP_ETAG_SHA1:
145 PHP_SHA1Update(ctx, data_ptr, data_len);
146 break;
147
148 case HTTP_ETAG_MD5:
149 PHP_MD5Update(ctx, data_ptr, data_len);
150 break;
151
152 default:
153 #ifdef HAVE_LIBMHASH
154 mhash(ctx, data_ptr, data_len);
155 #endif
156 break;
157 }
158 }
159
160 #define http_etag(p, l, m) _http_etag((p), (l), (m) TSRMLS_CC)
161 PHP_HTTP_API char *_http_etag(const void *data_ptr, size_t data_len, http_send_mode data_mode TSRMLS_DC);
162
163 #define http_last_modified(p, m) _http_last_modified((p), (m) TSRMLS_CC)
164 PHP_HTTP_API time_t _http_last_modified(const void *data_ptr, http_send_mode data_mode TSRMLS_DC);
165
166 #define http_match_last_modified(entry, modified) _http_match_last_modified_ex((entry), (modified), 1 TSRMLS_CC)
167 #define http_match_last_modified_ex(entry, modified, ep) _http_match_last_modified_ex((entry), (modified), (ep) TSRMLS_CC)
168 PHP_HTTP_API zend_bool _http_match_last_modified_ex(const char *entry, time_t t, zend_bool enforce_presence TSRMLS_DC);
169
170 #define http_match_etag(entry, etag) _http_match_etag_ex((entry), (etag), 1 TSRMLS_CC)
171 #define http_match_etag_ex(entry, etag, ep) _http_match_etag_ex((entry), (etag), (ep) TSRMLS_CC)
172 PHP_HTTP_API zend_bool _http_match_etag_ex(const char *entry, const char *etag, zend_bool enforce_presence TSRMLS_DC);
173
174 #define http_cache_last_modified(l, s, cc, ccl) _http_cache_last_modified((l), (s), (cc), (ccl) TSRMLS_CC)
175 PHP_HTTP_API STATUS _http_cache_last_modified(time_t last_modified, time_t send_modified, const char *cache_control, size_t cc_len TSRMLS_DC);
176
177 #define http_cache_etag(e, el, cc, ccl) _http_cache_etag((e), (el), (cc), (ccl) TSRMLS_CC)
178 PHP_HTTP_API STATUS _http_cache_etag(const char *etag, size_t etag_len, const char *cache_control, size_t cc_len TSRMLS_DC);
179
180 #define http_ob_etaghandler(o, l, ho, hl, m) _http_ob_etaghandler((o), (l), (ho), (hl), (m) TSRMLS_CC)
181 PHP_HTTP_API void _http_ob_etaghandler(char *output, uint output_len, char **handled_output, uint *handled_output_len, int mode TSRMLS_DC);
182
183 #endif
184
185 /*
186 * Local variables:
187 * tab-width: 4
188 * c-basic-offset: 4
189 * End:
190 * vim600: noet sw=4 ts=4 fdm=marker
191 * vim<600: noet sw=4 ts=4
192 */
193