PHP Classes

PHP Configuration Trait: Load and save class configuration using a trait

Recommend this page to a friend!
     
  Info   Example   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
StarStarStarStarStar 82%Total: 435 All time: 6,285 This week: 28Up
Version License PHP version Categories
configuration-trait 2.9MIT/X Consortium ...5.3PHP 5, Language, Configuration, Traits
Description 

Author

Asher Wolfstein

This package can load and save class configuration using a trait.

It defines a trait that can load and save configuration values into a variable from files in different formats.

Currently it supports the configuration file formats using Zend framework configuration classes: INI, XML, PHP array, JSON and YAML.

Innovation Award
PHP Programming Innovation award nominee
September 2015
Number 5

Prize: One downloadable e-book of choice by O'Reilly		 Many classes have behaviors that can be configured using external configuration files loaded at run-time.

This package provides a common PHP trait that can easily add load and save configuration capabilities to any class using files in many formats: INI, XML, PHP Array, JSON and YAML.

Manuel Lemos
Picture of Asher Wolfstein
  Performance   Level  

Level 4 StarStarStarStar

 Innovation award
Innovation award
Nominee: 5x

 

Example

<?php

require_once('../../Features/Configuration.php');

use Falcraft\Features;

class ConfiguredClass {
    use Features\Configuration;
   
    public function __construct($configure)
    {
        $this->configure($configure);
    }
   
    public function getChildNode1()
    {
        return $this->conf->parentNode->childNode1;
    }
   
    public function getChildNode2()
    {
        return $this->conf->parentNode->childNode2;
    }
   
    public function getSingleNode()
    {
        return $this->conf->singleNode;
    }
   
    public function getTestHost($branch)
    {
        return $this->conf->$branch->database->params->host;
    }
   
    public function getTestDBName($branch)
    {
        return $this->conf->$branch->database->params->dbname;
    }
}

echo "Falcraft\\Features\\Configuration.php Test\n";
echo "----------------------------------------\n\n";

echo "Instantiating Configuration Class With No Args -> ";

$success = true;

try {
    $configuredObject = new ConfiguredClass(array());
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success!\n";
} else {
    echo "Failure...\n";
}

echo "Instantiating Configuration Class with Array -> ";

$success = true;

try {
    $configuredObject = new ConfiguredClass(array (
        'parentNode' => array(
            'childNode1' => 'data1',
            'childNode2' => 'data2',),
        'singleNode' => 'data3'));
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo "Success!\n";
} else {
    echo "Failure...\n";
}

echo " Checking Configuration Variables -> \n";

$success = true;

$childNode1 = $childNode2 = $singleNode = null;

try {
    $childNode1 = $configuredObject->getChildNode1();
    $childNode2 = $configuredObject->getChildNode2();
    $singleNode = $configuredObject->getSingleNode();
    if (!$childNode1 || !$childNode2 || !$singleNode) {
        $success = false;
    }
} catch (\Exception $e) {
    $success = false;
}

if ($success) {
    echo " childNode1: $childNode1\n";
    echo " childNode2: $childNode2\n";
    echo " singleNode: $singleNode -- Success!\n";
} else {
    echo " -- Failure!\n";
}

echo "Instantiating Configuration Class with Ini File -> \n";

$success = true;

$childNode1 = $childNode2 = $singleNode = null;

try {
    $configuredObject = new ConfiguredClass(array());
    $configuredObject->configure(__DIR__ . '/test.ini');
    $childNode1 = $configuredObject->getChildNode1();
    $childNode2 = $configuredObject->getChildNode2();
    $singleNode = $configuredObject->getSingleNode();
    if (!$childNode1 || !$childNode2 || !$singleNode) {
        $success = false;
    }
} catch (\Exception $e) {
    $success = false;
}

echo " Checking Configuration Variables -> \n";

if ($success) {
    echo " childNode1: $childNode1\n";
    echo " childNode2: $childNode2\n";
    echo " singleNode: $singleNode -- Success!\n";
} else {
    echo " -- Failure!\n";
}

echo "Instantiating Configuration Class with XML File -> \n";

$success = true;

$testHostStaging = $testDBNameStaging = null;
$testHostProduction = null;

try {
    $configuredObject = new ConfiguredClass(array());
    $configuredObject->configure(__DIR__ . '/test.xml');
    $testHostStaging = $configuredObject->getTestHost('staging');
    $testDBNameStaging = $configuredObject->getTestDBName('staging');
    $testHostProduction = $configuredObject->getTestHost('production');
} catch (\Exception $e) {
    $success = false;
}

echo " Checking Configuration Variables -> \n";

if ($success) {
    echo " testHostStaging: $testHostStaging\n";
    echo " testDBNameStaging: $testDBNameStaging\n";
    echo " testHostProduction: $testHostProduction -- Success!\n\n";
} else {
    echo " -- Failure!\n\n";
}

echo "-- NOTE! testDBNameStaging may be empty, Zend may not be 'extending' properly\n\n";

echo "Instantiating Configuration Class with JSON File -> \n";

$success = true;

$testHostStaging = $testDBNameStaging = null;
$testHostProduction = null;

//try {
    $configuredObject = new ConfiguredClass(array());
    $configuredObject->configure(__DIR__ . '/test.json');
   
    $testHostStaging = $configuredObject->getTestHost('staging');
    $testDBNameStaging = $configuredObject->getTestDBName('staging');
    $testHostProduction = $configuredObject->getTestHost('production');
//} catch (\Exception $e) {
// $success = false;
//}

echo " Checking Configuration Variables -> \n";

if ($success) {
    echo " testHostStaging: $testHostStaging\n";
    echo " testDBNameStaging: $testDBNameStaging\n";
    echo " testHostProduction: $testHostProduction -- Success!\n\n";
} else {
    echo " -- Failure!\n\n";
}

echo "-- NOTE! testDBNameStaging may be empty, Zend may not be 'extending' properly\n\n";

  Files folder image Files (21)  
File Role Description
Files folder imageFalcraft (2 files, 2 directories)
Files folder imagesrc (1 directory)
Files folder imagetests (1 directory)
Accessible without login Plain text file composer.json Conf. composer
Accessible without login Plain text file LICENSE.txt Lic. MIT License
Accessible without login Plain text file phpunit.xml Test unit test config

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
Downloadconfiguration-trait-2016-08-07.zip 21KB
Downloadconfiguration-trait-2016-08-07.tar.gz 12KB
Install with ComposerInstall with Composer
 Version Control Reuses Unique User Downloads Download Rankings  
 0%5
Total:435
This week:0
All time:6,285
This week:28Up
 User Ratings  
 
 All time
Utility:91%StarStarStarStarStar
Consistency:100%StarStarStarStarStarStar
Documentation:91%StarStarStarStarStar
Examples:91%StarStarStarStarStar
Tests:83%StarStarStarStarStar
Videos:-
Overall:82%StarStarStarStarStar
Rank:6
  

  Applications that use this package  
No pages of applications that use this class were specified.

Add link image If you know an application of this package, send a message to the author to add a link here.


  Other classes that need this package  
Class Why it is needed Dependency
Abstract Data Types Data Type Objects Use This For Configuration Required
Flexible AutoLoader Abstract Loader Uses For Configuration Required
JavaScript Like Prototypes Configuration of Class Required
PHP Builder Pattern Generator For configuring the object Required
Universal PHP Event System For configuring the objects Required