ibexa

Caution: This documentation is for eZ Publish legacy, from version 3.x to 5.x.

ezhttp

Summary

Returns GET, POST and session variables.

Usage

ezhttp( name [, type [, check_existence ] ] )

Parameters

NameTypeDescriptionRequired
name string The HTTP variable that should be fetched. Yes.
type string Source of variable. Default is is HTTP POST. No.
check_existence mixed If the specified directive should be checked for existence. No.

Returns

Variable value

Description

This operator makes it possible to inspect the contents of HTTP variables (POST, GET or session variables). The "type" parameter can be used to specify which type of variable that should be extracted. The following options are available:

  • post (POST variable)
  • get (GET variable)
  • session (session variable)

The "check_existence" parameter can be set to TRUE or the string "hasVariable" in order to check if a directive is actually set. In this case, the operator will return either TRUE or FALSE. Note that using the "ezhttp_hasvariable" operator is a better option.

Examples

Example 1

{ezhttp( 'search' )}

Returns the "search" POST variable.

Example 2

{ezhttp( 'image', 'get' )}

Returns the "image" GET variable.

Example 3

{ezhttp( 'user_id', 'session' )}

Returns the "user_id" session variable.

Balazs Halasy (05/02/2004 10:33 am)

Balazs Halasy (01/04/2007 4:44 pm)

Comments

  • Warnings

    Monday 14 November 2005 10:26:13 am

    Bertrand Dunogier

    It's a little too bad there's no way to avoid a warning when the variable we're fetching is not set ...

    • Re: Warnings

      Tuesday 28 March 2006 11:27:01 pm

      James Robertson

      You only recieve a warning? I get see an error. Most annoying!

      • Re: Re: Warnings

        Friday 07 April 2006 5:33:09 pm

        Patrick Kaiser

        using 3.7.4 and getting an error as well. even testing for the existence fo a get/post var throws an error:
        {if ezhttp( 'myvar', 'get' ) } => returns false, but throws error
        the same with {if is_set( ezhttp( 'myvar', 'get' ) )}
        its a bug in my opinion..

    • Re: Warnings

      Thursday 27 July 2006 9:02:59 am

      VaL

      you can use in 3.9 (trunk) like:
      ezhttp_hasvariable( 'getVar','get' )
      or
      ezhttp( 'getVar','get','hasVariable' )

  • Why not ?

    Tuesday 13 December 2005 6:04:31 pm

    Alimi Nabil

    It would be nice if the ezhttp operator could return all vars in the array specified. ezhttp(GET) would return all $_GET vars for example.

  • ezhttp is not working if caching is turned on.

    Friday 14 July 2006 12:44:53 pm

    vytis

    i put
    {set-block scope=root variable=cache_ttl}0{/set-block}
    to all templates, because in other way ezhttp will return the same value...

    • Re: ezhttp is not working if caching is turned on.

      Thursday 18 October 2007 10:34:25 am

      André R.

      Or YOU should rethink your code instead of disable all cache, and recommend others to do so as well..

      If you use view parameters ('my.domain.com/my/url/(parameter)/value') instead of GET parameters, then the cache system will store different cached pages depending on the parameters. So that would be:
      * Better performance (cache is still on)
      * Nicer looking URL
      * Better indexable URL

      • Re: Re: ezhttp is not working if caching is turned on.

        Friday 02 November 2007 9:36:19 am

        Tobias V.

        Actually, the cache system unfortunately does not store different cached pages, but returns the first requested version after cache cleaning for each parameter combination. Maybe this has something to do with the overall broken cache system in 3.10, but it does not work as expected and documented here.

  • or null

    Friday 18 August 2006 6:20:26 pm

    Pike

    Returns:
    Variable value or null

    test for non-existence using
    {if not(ezhttp('test'))}
    or
    {if ezhttp('test')|null()}


  • How to get php $_SERVER['HTTP_REFERER'] in a template ?

    Tuesday 29 April 2008 9:21:34 am

    HL

    it would be nice if there was something like:
    ezhttp('referer', 'server')

    I tried
    {def $referer=ezhttp('LastAccessesURI','session')}
    as well, but it returns the URL of the active page, not the refering...

    What to do?