Status
Introduction
Flow Config is a key value configuration platform built on top of doctrine. It provides an PHP API for setting configuration at the platform that can be set by an install, and then set for a user, or other entity. Defaults are set in a single location, rather than scattering them through the code.
Installation
composer require code-foundation/flow-config
Usage
Attach the EntityIdentifier interface to user classes
This allows EntityConfig classes to use the above
class User implements CodeFoundation\FlowConfig\Interfaces\EntityIdentifier
{
public function getEntityType(): string
{
return 'user';
}
public function getEntityId(): string
{
return $this->id;
}
}
Build configuration classes
// Build a read-only config
$baseConfig = new ReadonlyConfig([
'timezone' => 'UTC'
]);
// Build a system config
$systemConfig = new DoctrineConfig($this->getEntityManager());
// Build a entity based config
$entityConfig = new DoctrineEntityConfig($this->getEntityManager());
// Build the cascading configuration objects that tries each of the above in turn.
$cascadeConfig = new CascadeConfig($baseConfig, $systemConfig, $entityConfig);
If you don't want the Config services to automatically flush changes to the database, pass a false for $autoFlush
in
the constructor of the service.
$systemConfig = new DoctrineConfig($this->getEntityManager(), false);
$entityConfig = new DoctrineEntityConfig($this->getEntityManager(), false);
Control key access using the AccessControlInterface
In some cases, you may wish to control each specific attempt to get/set specific keys, and this is where implementing the AccessControlInterface is useful.
By default, the NullAccessControl
class is instantiated, which defaults to allowing all get
and set
attempts.
By implementing the interface, you have control over allowing or denying get and set access to keys based on the key itself, or optionally the entity associated with the key, or one of its method values.
class MyAccessControlClass implements AccessControlInterface
{
// Set our read-only keys.
private $readOnlyKeys = ['abc123'];
// Set our keys that are restricted and never returned.
private $restrictedKeys = ['xyz987'];
// Set entities that cannot be modified
private $readOnlyEntities = [MyEntityClass::class];
public function canGetKey(string $key, ?EntityIdentity $entity = null): bool
{
// Return whether the key is not in our read-only array.
return \in_array($key, $this->readOnlyKeys) === false;
}
public function getSetKey(string $key, ?EntityIdentity $entity = null): bool
{
// Check whether the key is in our restricted array.
if (\in_array($key, $this->restrictedKeys) === true) {
return false;
}
// Check whether the entity is read only
if ($entity !== null && in_array(\get_class($entity), $this->readOnlyEntities) === true) {
return false;
}
return true;
}
}
Examples
$user1 = new User()->setId(999);
$user1 = new User()->setId(1001);
echo $systemConfig->get('timezone'); // UTC
echo $entityConfig->get('timezone'); // UTC
echo $cascadeConfig->getEntityConfigItem('timezone', $user1); // UTC
echo $cascadeConfig->getEntityConfigItem('timezone', $user2); // UTC
// Update the setting for that platform.
$entityConfig->set('timezone', 'Australia/Melbourne');
echo $systemConfig->get('timezone'); // UTC
echo $entityConfig->get('timezone'); // 'Australia/Melbourne'
echo $cascadeConfig->getEntityConfigItem('timezone', $user1); // 'Australia/Melbourne'
echo $cascadeConfig->getEntityConfigItem('timezone', $user2); // 'Australia/Melbourne'
// Update a given users settings
$cascadeConfig->setByEntity($user1, 'timezone', 'Pacific/Auckland');
echo $systemConfig->get('timezone'); // UTC
echo $entityConfig->get('timezone'); // 'Australia/Melbourne'
echo $cascadeConfig->getEntityConfigItem('timezone', $user1); // 'Pacific/Auckland'
echo $cascadeConfig->getEntityConfigItem('timezone', $user2); // 'Australia/Melbourne'
Supported platforms
- PHP 7.3+
- Doctrine
- Symfony - https://github.com/code-foundation/flow-config-symfony
Future plans
- Validation
- Allowed values
- Factories
- Eloquent backend
Contact
Github: https://github.com/code-foundation/flow-config Email: contact@codefoundation.com.au
License
Flow Config is distributed under the MIT license.