Environment variables exported to scripts
Stunnix Advanced Web Server exports a set of environment variables for use in scripts and in Server Parsed documents. All environment variables supported by Apache web server are exported.
You can see what environment variables are exported and their values by running sample site shipped with Stunnix Advanced Web Server just by executing /sample-image/site/stunnixwebsr/startsite.pl and following link to simple CGI script.
Environment variables common to Apache and Stunnix Advanced Web Server
The following variables are exported, with their values for the sample run on Linux of CGI script with parameter 'foo' set to value 'Test' (Stunnix Advanced Web Server 'srvrun.pl' script was located in directory /home/test/stunnix-web-server/stunnixwebsrv/ and was executed using system perl interpreter):
| CGI_GATEWAY | CGI/1.1 |
| DOCUMENT_NAME | sample-xcgi.xcgi |
| DOCUMENT_ROOT | /home/test/stunnix-web-server/www/root/ |
| GATEWAY_INTERFACE | CGI/1.1 |
| HTTP_COOKIE | |
| HTTP_USER_AGENT | Lynx/2.8.4 |
| PATH_INFO | |
| QUERY_STRING | foo=Test |
| REMOTE_ADDR | 127.0.0.1 |
| REMOTE_HOST | 127.0.0.1 |
| REQUEST_METHOD | GET |
| REQUEST_URI | /sample-xcgi.xcgi?foo=Test |
| SCRIPT_DIR | /home/test/stunnix-web-server/www/root |
| SCRIPT_FILENAME | /home/test/stunnix-web-server/www/root/sample-xcgi.xcgi |
| SCRIPT_NAME | /sample-xcgi.xcgi |
| SERVER_NAME | 127.0.0.1 |
| SERVER_PORT | 9000 |
| SERVER_PROTOCOL | HTTP/1.1 |
Environment variables unique to Stunnix Advanced Web Server
Here are exported environment variables with their values for the same sample run of XCGI script on Linux, with descriptions of the meaning of each variable.
| Name | Value | Description |
|---|---|---|
| PERL_INTERP_NAME | /usr/bin/perl | Commandline to execute Perl interpreter. If site is packed into single executable with Perl interpretrer embedded, the value of this variable will be name of .exe file with special additional commandline options. Use the value of this variable instead of $^X for execution of Perl scripts. |
| RUNNING_VIA_XCGI | 1 | This variable is set to 1 for scripts that being run using XCGI calling convention |
| SERVER_ROOT | /home/test/stunnix-web-server/stunnixwebsrv/ | Directory where srvrun.pl script is located. Useful for computing path to other files used in (x)CGI scripts |
| STUNNIXWS_STATEDIR | /home/test | Provided as platform abstraction service by 'startsite.pl' script. This is a directory where to store global user-specific settings and documents (independant of version number of your browser-based appliation). |
| STUNNIXWS_TMPSTATEDIR | /home/test/.stunnixws//Perl-Obfus-2.0-Standard-0/ | Provided as platform abstraction service by 'startsite.pl' script. This is a directory where most files specific to the current user, site id and current version number of site can be stored. |
Other environment variables
It's possible to request SPWS to temporarily export additional environment variables when documents or scripts are served/executed on a per-location basis too using SetEnv directive in configuration file. It's very useful for passing various bits of configuration information like name of database to use or name of default CSS stylesheet.