samcrosoft/constantaccess

This library makes it possible to create and read (access) constants using an array-like object or a typical class object to make it possible to use constants in strings without the need of concatenation of strings

dev-master 2015-11-28 15:55 UTC

This package is not auto-updated.

Last update: 2024-11-13 19:15:57 UTC


README

Build Status

constantaccess

This library makes it possible to create and read (access) constants using an array-like object or a typical class object to make it possible to use constants in strings without the need of concatenation of strings


Example

Create an object of the constant access library and then start creating or reading constants

$oConst = new Samcrosoft\ConstantAccess\ConstantAccess();


Instantiating The Constant Class With An Array

you can supply an array key=>pair values for constants to create, NOTE: this array should be a 1 dimensional array

e.g

	$aData = array(
					'const1'  => 2,
					'const2'  => 22,
					'_const3' => 'another constant'
				   );

 // then create it now as

 $oConst = new Samcrosoft\ConstantAccess\ConstantAccess($aData);

Creating Constants Using Object Method or Array Access

$oConst->CONST1 = 23;               This creates a constant called CONST1
$oConst['CONST2'] = "constant 2";   This creates another constant called CONST2

Throwing Exceptions

To create a valid php constant, the following conditions must be met

  • A constant key can only be a valid php variable name
  • A Constant value can only be a value of scalar type,

Before creating a constant, the above tests are conducted, hence there are possibilities of exceptions been thrown if any of the above listed conditions are not adhered to or met

The ConstantAccess dies silently i.e it does not throw any exception by default but for good programming practice, you should handle all possibilites of exceptions


Enabling Exceptions

You can enable the exceptions in two(2) ways,

  • At the creation of the class object
  • By using the setThrowException method

e.g

 1 - $oConst = new Samcrosoft\ConstantAccess\ConstantAccess(array(), true);
 2 - $oConst->setThrowException(false);
 

Default Return Value

If a constant is not defined, you can configure a default return value that is returned in that case instead of breaking ur application

 e.g To set the default return value to null, you do the following

 $oConst->setValueReturnIfNotDefined(null);

 hence, $oConst->UNDEFINED; would return null

Reading / Accessing Constants

print "this is a trial message with {$oConst->CONST1} or another {$oConst->CONST2}";

Tests

just run Phpunit in the folder where you have placed the library


### Examples

examples are located in the /examples folder