/** @file
Parser: apache 1.3/2.X module, part, compiled by parser3project.
Copyright (c) 2001-2026 Art. Lebedev Studio (https://www.artlebedev.com)
Authors: Konstantin Morshnev <moko@design.ru>, Alexandr Petrosian <paf@design.ru>
*/
volatile const char * IDENT_MOD_PARSER3_CORE_C="$Id: mod_parser3_core.C,v 1.44 2026/04/25 13:38:46 moko Exp $";
#include "pa_config_includes.h"
#include "pa_globals.h"
#include "pa_httpd.h"
#include "pa_common.h"
#include "pa_sapi.h"
#include "classes.h"
#include "pa_request.h"
#if defined(_MSC_VER) && !defined(_DEBUG)
# include <windows.h>
# define PA_SUPPRESS_SYSTEM_EXCEPTION
#endif
// generals
static bool globals_inited=false;
const char* parser3_mode="apache"; // $status:mode
const char *parser3_log_filespec(){ return ""; } // $status:log-filename
void pa_setup_module_cells() {
if(globals_inited)
return;
globals_inited=true;
/// no trying to __try here [yet]
try {
// init libraries
pa_globals_init();
} catch(const Exception& e) { // global problem
SAPI::die("setup_module_cells failed: %s", e.comment());
}
}
void pa_destroy_module_cells() {
if(!globals_inited)
return;
pa_globals_done();
}
//@{
/// SAPI func decl
class SAPI_Info {
public:
pa_request_rec* r;
};
void SAPI::log(SAPI_Info& SAPI_info, const char* fmt, ...) {
va_list args;
va_start(args,fmt);
char buf[MAX_LOG_STRING];
size_t size=vsnprintf(buf, MAX_LOG_STRING, fmt, args);
size=remove_crlf(buf, buf+size);
pa_ap_log_rerror(0, 0, PA_APLOG_ERR | PA_APLOG_NOERRNO, SAPI_info.r, "%s", buf);
va_end(args);
}
void SAPI::die(const char* fmt, ...) {
va_list args;
va_start(args, fmt);
char buf[MAX_LOG_STRING];
size_t size=vsnprintf(buf, MAX_LOG_STRING, fmt, args);
size=remove_crlf(buf, buf+size);
pa_ap_log_error(PA_APLOG_MARK, PA_APLOG_EMERG, 0, "%s", buf);
exit(1);
// va_end(args);
}
void SAPI::send_error(SAPI_Info& SAPI_info, const char *exception_cstr, const char *status){
// capitalized headers passed for preventing malloc during capitalization
add_header_attribute(SAPI_info, HTTP_STATUS_CAPITALIZED, status);
add_header_attribute(SAPI_info, HTTP_CONTENT_TYPE_CAPITALIZED, "text/plain");
send_headers(SAPI_info);
send_body(SAPI_info, exception_cstr, strlen(exception_cstr));
}
char* SAPI::Env::get(SAPI_Info& SAPI_info, const char* name) {
const char* dont_return_me=pa_ap_table_get(SAPI_info.r->subprocess_env, name);
return dont_return_me?pa_strdup(dont_return_me):0;
}
bool SAPI::Env::set(SAPI_Info&, const char*, const char*) {
return false;
}
#ifndef DOXYGEN
struct SAPI_environment_append_info {
const char** cur;
};
#endif
static int SAPI_environment_append(void *d, const char* k, const char* val) {
if(k && val) {
SAPI_environment_append_info& info=*static_cast<SAPI_environment_append_info *>(d);
*info.cur++=pa_strcat(k, "=", val);
}
return 1/*true*/;
}
const char* const* SAPI::Env::get(SAPI_Info& SAPI_info) {
const pa_table *t=SAPI_info.r->subprocess_env;
const char** result=new(PointerGC) const char*[pa_ap_table_size(t)+1/*0*/];
SAPI_environment_append_info info={result};
pa_ap_table_do(SAPI_environment_append, &info, t, 0); *info.cur=0; // mark EOE
return result;
}
size_t SAPI::read_post(SAPI_Info& SAPI_info, char *buf, size_t max_bytes) {
// pa_ap_log_error(PA_APLOG_MARK, PA_APLOG_DEBUG, SAPI_info.r->server, "mod_parser3: SAPI::read_post(max=%u)", max_bytes);
int retval;
if((retval = pa_ap_setup_client_block(SAPI_info.r, PA_REQUEST_CHUNKED_ERROR)))
return 0;
if(!pa_ap_should_client_block(SAPI_info.r))
return 0;
uint total_read_bytes=0;
void (*handler)(int)=pa_signal(PA_SIGPIPE, PA_SIG_IGN);
while (total_read_bytes<max_bytes) {
pa_ap_hard_timeout("Read POST information", SAPI_info.r); /* start timeout timer */
uint read_bytes=
pa_ap_get_client_block(SAPI_info.r, buf+total_read_bytes, max_bytes-total_read_bytes);
pa_ap_reset_timeout(SAPI_info.r);
if (read_bytes<=0)
break;
total_read_bytes+=read_bytes;
}
pa_signal(PA_SIGPIPE, handler);
return total_read_bytes;
}
/// @test location provide with protocol. think about internal redirects
void SAPI::add_header_attribute(SAPI_Info& SAPI_info, const char* dont_store_key, const char* dont_store_value) {
if(strcasecmp(dont_store_key, "location")==0)
*SAPI_info.r->status=302;
if(strcasecmp(dont_store_key, HTTP_CONTENT_TYPE)==0) {
/* r->content_type, *not* r->headers_out("Content-type"). If you don't
* set it, it will be filled in with the server's default type (typically
* "text/plain"). You *must* also ensure that r->content_type is lower
* case.
*/
*SAPI_info.r->content_type = pa_ap_pstrdup(SAPI_info.r->pool, dont_store_value);
} else if(strcasecmp(dont_store_key, HTTP_STATUS)==0)
*SAPI_info.r->status=atoi(dont_store_value);
else
pa_ap_table_addn(SAPI_info.r->headers_out,
pa_ap_pstrdup(SAPI_info.r->pool, capitalize(dont_store_key)),
pa_ap_pstrdup(SAPI_info.r->pool, dont_store_value));
}
void SAPI::send_headers(SAPI_Info& SAPI_info) {
pa_ap_hard_timeout("Send header", SAPI_info.r);
pa_ap_send_http_header(SAPI_info.r);
pa_ap_kill_timeout(SAPI_info.r);
}
void SAPI::clear_headers(SAPI_Info&) {
}
size_t SAPI::send_body(SAPI_Info& SAPI_info, const void *buf, size_t size) {
pa_ap_hard_timeout("Send body", SAPI_info.r);
size = (size_t)pa_ap_rwrite(buf, size, SAPI_info.r);
pa_ap_kill_timeout(SAPI_info.r);
return size;
}
//@}
/**
main workhorse
@todo intelligent cache-control
*/
static void real_parser_handler(SAPI_Info& SAPI_info, Parser_module_config *dcfg) {
// collect garbage from prev request
pa_gc_collect();
// populate env
pa_ap_add_common_vars(SAPI_info.r);
pa_ap_add_cgi_vars(SAPI_info.r);
// Request info
Request_info request_info; memset(&request_info, 0, sizeof(request_info));
request_info.document_root=SAPI::Env::get(SAPI_info, "DOCUMENT_ROOT");
request_info.path_translated=SAPI_info.r->filename;
request_info.method=SAPI_info.r->method;
request_info.query_string=SAPI_info.r->args;
request_info.uri=request_info.strip_absolute_uri(SAPI::Env::get(SAPI_info, "REQUEST_URI"));
request_info.content_type=SAPI::Env::get(SAPI_info, "CONTENT_TYPE");
request_info.content_length=pa_atoul(SAPI::Env::get(SAPI_info, "CONTENT_LENGTH"));
request_info.cookie=SAPI::Env::get(SAPI_info, "HTTP_COOKIE");
request_info.mail_received=false;
// prepare to process request
Request request(SAPI_info, request_info, String::Language(String::L_HTML|String::L_OPTIMIZE_BIT));
// process the request
const char *config=dcfg->parser_config_filespec;
#ifdef SYSTEM_CONFIG_FILE
if(!config && entry_exists(SYSTEM_CONFIG_FILE)){
config=SYSTEM_CONFIG_FILE;
}
#endif
request.core(config, SAPI_info.r->header_only!=0);
}
#ifdef PA_SUPPRESS_SYSTEM_EXCEPTION
static const Exception call_real_parser_handler__do_PEH_return_it(SAPI_Info& SAPI_info, Parser_module_config *dcfg) {
try {
real_parser_handler(SAPI_info, dcfg);
} catch(const Exception& e) {
return e;
}
return Exception();
}
static void call_real_parser_handler__supress_system_exception(SAPI_Info& SAPI_info, Parser_module_config *dcfg) {
Exception parser_exception;
LPEXCEPTION_POINTERS system_exception=0;
__try {
parser_exception=call_real_parser_handler__do_PEH_return_it(SAPI_info, dcfg);
} __except ( (system_exception=GetExceptionInformation()), EXCEPTION_EXECUTE_HANDLER) {
if(system_exception)
if(_EXCEPTION_RECORD *er=system_exception->ExceptionRecord)
throw Exception("system", 0, "0x%08X at 0x%08X", er->ExceptionCode, er->ExceptionAddress);
else
throw Exception("system", 0, "<no exception record>");
else
throw Exception("system", 0, "<no exception information>");
}
if(parser_exception)
throw Exception(parser_exception);
}
#endif
/// @test r->finfo.st_mode check seems to work only on win32
int pa_parser_handler(pa_request_rec *r, Parser_module_config *dcfg) {
// SAPI info
SAPI_Info SAPI_info; SAPI_info.r=r;
if(r->file_not_found)
return PA_HTTP_NOT_FOUND;
try { // global try
#ifdef PA_SUPPRESS_SYSTEM_EXCEPTION
call_real_parser_handler__supress_system_exception(
#else
real_parser_handler(
#endif
SAPI_info, dcfg);
// successful finish
} catch(const Exception& e) { // just in case
// log it
SAPI::log(SAPI_info, "%s", e.comment());
SAPI::send_error(SAPI_info, e.comment());
}
/*
* We did what we wanted to do, so tell the rest of the server we
* succeeded.
*/
return PA_OK;
}
E-mail: