Showing results for 
Search instead for 
Did you mean: 

HowTo: Inspect HTTP request parameters

An HTTP request contains a number of different parameters:


GET /search?hl=en&q=Stingray&btnG=Google+Search HTTP/1.1


User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.7.5) Gecko/20041107 Firefox/1.0

Accept-Language: en-us,en;q=0.5

Accept-Encoding: gzip,deflate

Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7

Keep-Alive: 300

Connection: keep-alive


Cookie: PREF=4; recall=true; AdSenseLocale=en_US


There are a number of TrafficScript functions that make it easy to read and modify each of these parameters when Stingray is processing a request:


Inspecting the first line


$method   = http.getMethod();       # returns 'GET'  
$rawurl   = http.getRawURL();       # returns '/search?hl=en&q=ZXTM&btnG=Google+Search'  
$path     = http.getPath();         # returns '/search'  
$querystr = http.getQueryString();  # returns 'hl=en&q=ZXTM&btnG=Google+Search'  
$version  = http.getVersion();      # returns '1.1'  


Inspecting headers


    $host     = http.getHeader( "Host" );    # returns ''  
    $cookie   = http.getHeader( "Cookie" );  # returns 'PREF=4; recall=true; AdSenseLocale=en_US'  
    $adlocale = http.getCookie( "AdSenseLocale" );  # returns 'en_US'


Other functions


# An HTTP request may contain an additional POST body  
$body = http.getBody();  
# Iterate through a multipart POST body  
$count = 0;  
while( $data = http.getMultipartAttachment( $count ) ) {  
   $count = $count + 1;  
# Get a form parameter - this function inspects both the query string   
# and the POST body to look up the form parameter  
$searchterm = http.getFormParam( "q" );  


Most of these functions have counterparts to set the value, delete it or to test if it exists. For example:


http.setHeader( "Host", "" );  # set the host header  
http.removeHeader( "Accept-Encoding" );    # delete the 'Accept-Encoding' header  
http.setPath( "/secure/index.html" );      # set the URL in the request  
if( http.headerExists( "Cookie" ) ) ....   # did the client provide a Cookie header?  


Read more


Version history
Revision #:
2 of 2
Last update:
‎01-11-2021 03:22:PM
Updated by:
Labels (1)