/* Simple HelloWorld module * * The book presents lots of variants of this module to demonstrate * different points around writing a content-generator module and * working with the request_rec. This is an attempt at a 'canonical' * version, broadly equivalent to the familiar CGI printenv. */ #include #include #include static int printitem(void* rec, const char* key, const char* value) { /* rec is a userdata pointer. We'll pass the request_rec in it */ request_rec* r = rec ; ap_rprintf(r, "%s%s\n", ap_escape_html(r->pool, key), ap_escape_html(r->pool, value)) ; /* Zero would stop iterating; any other return value continues */ return 1 ; } static void printtable(request_rec* r, apr_table_t* t, const char* caption, const char* keyhead, const char* valhead) { /* print a table header */ ap_rprintf(r, "" "", caption, keyhead, valhead) ; /* Print the data: apr_table_do iterates over entries with our callback */ apr_table_do(printitem, r, t, NULL) ; /* and finish the table */ ap_rputs("

%s
%s	%s" "

\n", r) ; } static int helloworld_handler(request_rec* r) { if ( !r->handler || strcmp(r->handler, "helloworld") ) { return DECLINED ; /* none of our business */ } if ( r->method_number != M_GET ) { return HTTP_METHOD_NOT_ALLOWED ; /* Reject other methods */ } ap_set_content_type(r, "text/html;charset=ascii") ; ap_rputs( "\n", r) ; ap_rputs( "Apache HelloWorld Module", r) ; ap_rputs("

Hello World!

", r) ; ap_rputs("

This is the Apache HelloWorld module!

", r) ; /* Print the headers and env */ /* Note that the response headers and environment may be empty at * this point. The CGI environment is an overhead we dispense * with in a module, unless another module that requires it * (e.g. mod_rewrite) has set it up. */ printtable(r, r->headers_in, "Request Headers", "Header", "Value") ; printtable(r, r->headers_out, "Response Headers", "Header", "Value") ; printtable(r, r->subprocess_env, "Environment", "Variable", "Value") ; ap_rputs("", r) ; return OK ; } /* Hook our handler into Apache at startup */ static void helloworld_hooks(apr_pool_t* pool) { ap_hook_handler(helloworld_handler, NULL, NULL, APR_HOOK_MIDDLE) ; } module AP_MODULE_DECLARE_DATA helloworld_module = { STANDARD20_MODULE_STUFF, NULL, NULL, NULL, NULL, NULL, helloworld_hooks } ;