ezini

Written by Balazs Halasy, 02/05/2004 Updated 05/04/2005 by Balazs Halasy

Summary

Provides read access to settings in the configuration files.

Usage

ezini( section, variable [, ini file] )

Parameters

Name	Type	Description	Required
section	string	Section to read value from.	Yes.
variable	string	The name of the directive that should be accessed.	Yes.
ini file	string	The target configuration file (default is "site.ini").	No.

Returns

A string containing the value of a configuration setting.

Description

This operator makes it possible to access the settings in the configuration ("*.ini") files.

Examples

Example 1

{if eq(ezini( 'SomeSettings', 'Test', 'example.ini' ), 'hello' )}
    [...display something...]
{else}
    [...display something else...]
{/if}

Conditional branching based on an configuration setting.

Contributors

Balazs Halasy Author 02/05/2004 Updated 05/04/2005
VaL Commenter 01/15/2007
Vincent Lepot @ Smile.fr Commenter 08/23/2006

Comments (3 historical)

Written by readers of the earlier documentation sites, kept as they were.

in 3.9

VaL · 01/15/2007 08:37 am

Now, you can use ezini_hasvariable() like
For example:

ezini_hasvariable( 'URL', 'URL', 'my.site' )
=
ezini( 'URL', 'URL', 'my.ini',,,'hasVariable' )

ezini( &lt;BlockName>, &lt;SettingName>, &lt;FileName>,
       &lt;IniPath>, &lt;Should we put implementation to cache file?: 'inCache' or true()>,
       &lt;Should we check for existence: 'hasVariable' or true()> )

When compilation of tpl is enabled:

ezini( 'URL', 'URL', 'my.ini',, 'inCache')
=
ezini( 'URL', 'URL', 'my.ini',, true())

=> if ini variable doesn't exist warnings will not be shown
http://ez.no/bugs/view/7449

4th parameter

Vincent Lepot @ Smile.fr · 08/23/2006 02:29 pm

You should add in this document the fourth parameter which is not documented but implemented !
ezini( section, variable [, ini file [, dynamic] ] )
If dynamic = true, the value will be dynamically retrieved from ini file. Else, it will be retrieved during template compilation and will be hard coded in the compiled template.
1. Re: 4th parameter
  
  Vincent Lepot @ Smile.fr · 11/02/2006 06:18 pm
  
  Sorry, I'm mistaken :
  ezini( section, variable [, ini file [, ini path [, dynamic] ] ] )
  If you don't need 'ini path' to be set, you can specify false()

Comments

Add a comment