HTTP -- get HTTP headers
- Called with the name of an HTTP request header field, returns its value. Capitalization and the use of hyphens versus underscores are not significant.
- Request headers are sent by the browser to the server. It is not possible to access the Response headers returned to the browser.
- Only returns headers permitted by site configuration. Returns '' if the header is not allowed.
- When called without a parameter, nothing is returned. See VarHTTPS for other options.
The HTTP and HTTPS macros are deprecated as of Foswiki release 2.1. and will be removed in a future release.Parameters
| Name | Description |
|---|---|
"name" |
Name of the header to get |
Examples
| Write | Returns | Notes |
|---|---|---|
%HTTP% |
Always returns '' | |
%HTTP{"Accept-language"}% |
en | |
%HTTP{"User-Agent"}% |
Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36 | |
%HTTP{"Cookie"}% |
Not allowed by default. |
You can see the HTTP headers your browser sends to the server on a number of sites e.g. http://www.ericgiguere.com/tools/http-header-viewer.htmlRelated
HTTPS, REMOTE_ADDR, REMOTE_PORT, REMOTE_USERThis topic: System > Category > UserDocumentationCategory > Macros > VarHTTP
Topic revision: 12 Nov 2015, ProjectContributor
Topic revision: 12 Nov 2015, ProjectContributor
Copyright © by the contributing authors. All material on this site is the property of the contributing authors. Ideas, requests, problems regarding PDLWiki? Send feedback