2017 © Pedro Peláez
 

library dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

image

drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  • Tuesday, February 13, 2018
  • by drupol
  • Repository
  • 3 Watchers
  • 4 Stars
  • 108 Installations
  • PHP
  • 2 Dependents
  • 0 Suggesters
  • 0 Forks
  • 0 Open issues
  • 14 Versions
  • 0 % Grown

The README.md

Build Status Scrutinizer Code Quality Code Coverage StyleCI Latest Stable Version Total Downloads License, (*1)

DynamicObjects

Description

Create and manage dynamic properties and methods on a PHP object., (*2)

Features

  • Allows you to add regular or static methods and properties to an existing object,
  • Can be used by extending the DynamicObject object or as a trait, on a real or anonymous class,
  • Can memoize methods results and/or properties if they are callable,
  • The caching object use CacheInterface and can be injected.

Requirements

  • PHP >= 5.6

Installation

composer require drupol/dynamicobjects, (*3)

Optional

To enable memoization you will need an extra package., (*4)

composer require drupol/memoize, (*5)

Usage

Using the object:, (*6)

<?php

include 'vendor/autoload.php';

// Anonymous classes creation is only available to PHP >= 7.
$myObject = new class extends \drupol\DynamicObjects\DynamicObject {};

$myObject::addDynamicProperty('name', 'DynamicObjects');
echo $myObject->name; // DynamicObjects

$myObject::addDynamicMethod('sayHelloWorld', function() {echo "Hello world!";});
$myObject->sayHelloWorld(); // Hello world!

Using the trait:, (*7)

<?php

include 'vendor/autoload.php';

use drupol\DynamicObjects\DynamicObjectsTrait;

// Anonymous classes creation is only available to PHP >= 7.
$myObject = new class {
    use DynamicObjectsTrait;
};

$myObject::addDynamicProperty('name', 'DynamicObjects');
echo $myObject->name; // DynamicObjects

$myObject::addDynamicMethod('sayHelloWorld', function() {echo "Hello world!";});
$myObject->sayHelloWorld(); // Hello world!

Memoization:, (*8)

<?php

include 'vendor/autoload.php';

use drupol\DynamicObjects\DynamicObjectsTrait;

// Anonymous classes creation is only available to PHP >= 7.
$myObject = new class {
    use DynamicObjectsTrait;
};

$myObject::addDynamicMethod('sleep', function($second = 5) {
  sleep($second);
  return true; // The function must return something to get the memoization working.
  }, true); // Set the last parameter to true to enable the memoization.

$myObject->sleep(); // The first execution will be executed and will last 5 seconds.
$myObject->sleep(); // The next executions, if arguments and method are the same will not be executed
$myObject->sleep(); // and only the result of the function will be returned.
$myObject->sleep();

API

DynamicObjects provides a PHP trait and an Object depending on it., (*9)

You can use it by extending the object or by using the trait directly, there is no difference., (*10)

It exposes the following static methods:, (*11)

/**
 * Add a dynamic property.
 *
 * @param string $name
 *   The property name.
 * @param mixed $value
 *   The property value.
 * @param bool $memoize
 *   Memoize parameter.
 */
DynamicObjectsTrait::addDynamicProperty($name, $value, $memoize = false);

```php /** * Add a dynamic method. * * @param $name * The method name. * @param \Closure $func * The method. * @param bool $memoize * Memoize parameter. * @param bool $static * Static flag parameter. */ DynamicObjectsTrait::addDynamicMethod($name, $func, $memoize = false, $static = false);, (*12)

```php
/**
 * Check if a dynamic property exists.
 *
 * @param string $name
 *   The property name.
 * @return bool
 *   True if the property exists, false otherwise.
 */
DynamicObjectsTrait::hasDynamicProperty($name);

```php /** * Check if a dynamic method exists. * * @param string $name * The property name. * @return bool * True if the property exists, false otherwise. */ DynamicObjectsTrait::hasDynamicMethod($name);, (*13)

```php
/**
 * Get a dynamic property.
 *
 * @param $name
 *   The property name.
 * @return mixed|null
 *   The property value if it exists, null otherwise.
 */
DynamicObjectsTrait::getDynamicProperty($name);

```php /** * Get a dynamic method. * * @param $name * The method name. * @return mixed|null * The method if it exists, null otherwise. */ DynamicObjectsTrait::getDynamicMethod($name);, (*14)

```php
/**
 * Remove a dynamic property.
 *
 * @param string $name
 *   The property name.
 */
DynamicObjectsTrait::removeDynamicProperty($name);

```php /** * Remove a dynamic method. * * @param string $name * The method name. */ DynamicObjectsTrait::removeDynamicMethod($name);, (*15)

```php
/**
 * Clear dynamic properties.
 */
DynamicObjectsTrait::clearDynamicProperties();

```php /** * Clear dynamic methods. */ DynamicObjectsTrait::clearDynamicMethods();, (*16)

```php
/**
 * Set the cache.
 *
 * @param \Psr\SimpleCache\CacheInterface $cache
 */
DynamicObjectsTrait::setDynamicObjectCacheProvider(CacheInterface $cache);

```php /** * Get the cache. * * @return \Psr\SimpleCache\CacheInterface */ DynamicObjectsTrait::getDynamicObjectCacheProvider();, (*17)

```php
/**
 * Clear the cache.
 */
DynamicObjectsTrait::clearDynamicObjectCache()

Contributing

Feel free to contribute to this library by sending Github pull requests. I'm quite reactive :-), (*18)

Sponsors

The Versions

13/02 2018

dev-master

9999999-dev https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

MIT GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

28/09 2017

1.2.9

1.2.9.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

25/09 2017

1.2.8

1.2.8.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

20/09 2017

1.2.7

1.2.7.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

20/09 2017

dev-analysis-8Lx15l

dev-analysis-8Lx15l https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

20/09 2017

1.2.6

1.2.6.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

20/09 2017

1.2.5

1.2.5.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

19/09 2017

1.2.4

1.2.4.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

19/09 2017

1.2.3

1.2.3.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

  • php >=5.3.0

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

19/09 2017

1.2.2

1.2.2.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

  • php >=5.3.0

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

19/09 2017

1.2.1

1.2.1.0 https://github.com/drupol/dynamicobjects

Create and manage dynamic properties and methods on a PHP object.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

dynamic methods dynamic properties

18/09 2017

1.2.0

1.2.0.0

Create dynamic objects.

  Sources   Download

GPL

The Requires

 

The Development Requires

by Pol Dellaiera

18/09 2017

1.1.0

1.1.0.0

Create dynamic objects.

  Sources   Download

GPL

The Requires

  • php >=5.3.0

 

The Development Requires

by Pol Dellaiera

18/09 2017

1.0.0

1.0.0.0

Create dynamic objects.

  Sources   Download

GPL

The Requires

  • php >=5.3.0

 

The Development Requires

by Pol Dellaiera