2005-02-20 14:27:00 +00:00
|
|
|
#ifndef _MOD_SSI_H_
|
|
|
|
#define _MOD_SSI_H_
|
2016-03-19 15:14:35 +00:00
|
|
|
#include "first.h"
|
2005-02-20 14:27:00 +00:00
|
|
|
|
2018-03-25 07:45:05 +00:00
|
|
|
#include "base_decls.h"
|
2005-02-20 14:27:00 +00:00
|
|
|
#include "buffer.h"
|
|
|
|
#include "array.h"
|
|
|
|
|
|
|
|
#include "plugin.h"
|
|
|
|
|
|
|
|
typedef struct {
|
2019-10-27 02:34:08 +00:00
|
|
|
const array *ssi_extension;
|
|
|
|
const buffer *content_type;
|
[mod_ssi] config ssi.conditional-requests
Summary:
A new SSI directive, "ssi.conditional-requests", allows to inform
lighttpd which SSI pages should be considered as cacheable and which
should not. In particular, the "ETag" & "Last-Modified" headers will
only be sent for those SSI pages for which the directive is enabled.
Long description:
"ETag" and "Last-Modified" headers were being sent for all SSI pages,
regardless of whether they were cacheable or not. And yet, there was
no cache validation at all for any SSI page.
This commit fixes these two minor issues by adding a new directive,
"ssi.conditional-requests", which allows to specify which SSI pages
are cacheable and which are not, and by adding cache validation to
those SSI pages which are cacheable. And since sending ETags for
non-cacheable documents is not appropriate, they are no longuer
computed nor sent for those SSI pages which are not cacheable.
Regarding the "Last-Modified" header for non-cacheable documents,
the standards allow to either send the current date and time for
that header or to simply skip it. The approach chosen is to not send
it for non-cacheable SSI pages. "ETag" and "Last-Modified" headers
are therefore only sent for an SSI page if ssi.conditional-requests
is enabled for that page.
The ssi.conditional-requests directive can be enabled or disabled
globally and/or in any context. It is disabled by default.
An index.shtml which only includes deterministic SSI commands such as:
<!--#echo var="LAST_MODIFIED"-->
is a trivial example of a dynamic SSI page that is cacheable.
2016-04-13 12:27:47 +00:00
|
|
|
unsigned short conditional_requests;
|
2016-04-13 23:50:31 +00:00
|
|
|
unsigned short ssi_exec;
|
2016-12-11 06:49:11 +00:00
|
|
|
unsigned short ssi_recursion_max;
|
2005-02-20 14:27:00 +00:00
|
|
|
} plugin_config;
|
|
|
|
|
|
|
|
typedef struct {
|
|
|
|
PLUGIN_DATA;
|
2019-10-27 02:34:08 +00:00
|
|
|
plugin_config defaults;
|
|
|
|
plugin_config conf;
|
2006-10-04 13:26:23 +00:00
|
|
|
|
2005-02-20 14:27:00 +00:00
|
|
|
buffer *timefmt;
|
2006-10-04 13:26:23 +00:00
|
|
|
|
2005-02-20 14:27:00 +00:00
|
|
|
buffer *stat_fn;
|
2006-10-04 13:26:23 +00:00
|
|
|
|
2005-02-20 14:27:00 +00:00
|
|
|
array *ssi_vars;
|
|
|
|
array *ssi_cgi_env;
|
|
|
|
} plugin_data;
|
|
|
|
|
2016-12-06 05:25:56 +00:00
|
|
|
typedef struct {
|
|
|
|
buffer *timefmt;
|
|
|
|
int sizefmt;
|
|
|
|
|
|
|
|
buffer *stat_fn;
|
|
|
|
|
|
|
|
array *ssi_vars;
|
|
|
|
array *ssi_cgi_env;
|
|
|
|
|
|
|
|
int if_level, if_is_false_level, if_is_false, if_is_false_endif;
|
2016-12-11 06:49:11 +00:00
|
|
|
unsigned short ssi_recursion_depth;
|
2016-12-06 05:25:56 +00:00
|
|
|
|
2019-11-25 06:54:08 +00:00
|
|
|
log_error_st *errh;
|
2016-12-06 05:25:56 +00:00
|
|
|
plugin_config conf;
|
|
|
|
} handler_ctx;
|
|
|
|
|
2019-11-25 06:54:08 +00:00
|
|
|
int ssi_eval_expr(handler_ctx *p, const char *expr);
|
2005-02-20 14:27:00 +00:00
|
|
|
|
|
|
|
#endif
|