PHP Classes
elePHPant
Icontem

Editable: Add functions and variables dynamically to objects

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Info   View files View files (10)   DownloadInstall with Composer Download .zip   Reputation   Support forum (1)   Blog    
Last Updated Ratings Unique User Downloads Download Rankings  
2014-02-01 (1 year ago) RSS 2.0 feedNot yet rated by the usersTotal: 249 All time: 7,162 This week: 1,199Up
Version License PHP version Categories  
editable 1BSD License5PHP 5, Language
Description Author  

This class can add functions and variables dynamically to objects.

It can add new public and private variables to an object that extends the editable class. The variables may be set to a given initial value.

It can also add or replace public and private functions with a new function code.

The class can also intercept calls to functions by calling the code of a given function before calling the actual function being intercepted.

Picture of jstar88
Name: jstar88 <contact>
Classes: 6 packages by
Country: Italy Italy
Age: ???
All time rank: 145758 in Italy Italy
Week rank: 572 Up29 in Italy Italy Up
Innovation award
Innovation award
Nominee: 2x

Details provided by the author  
Editable
========

This class can add functions and variables dynamically to objects.  
It can add new public and private variables to an object that extends the editable class. The variables may be set to a given initial value.   
It can also add or replace public and private functions with a new function code.  
The class can also intercept calls to functions by calling the code of a given function before calling the actual function being intercepted.  

## Feaures

* add public and private variables
* add public and private functions
* override public and private functions
* handle functions call registering interceptors with a callback

## Usage

#### Installation
**Require PHP >= 5.4**   
First of all download **Editable.php** and **pathwork.phar** in the same directory .  
Now choose the classes that should be editable by this script adding the word `extends Editable`:
```php
    class MyClass extends Editable
```
Then include in your main script **Editable.php** and use your class with new features!
```php
    require "Editable.php";
    $f = new MyClass(); // instantiate your class extending Editable
    $f-> ...
```


#### Managment of variables

###### Adding a variable
```php
    //private
    $f->addPrivateVariable("var1","Hello World",$handler,$handlerArgs);
    //or public
    $f->addPublicVariable("var2","Hello World 2",$handler,$handlerArgs);
```
* The first argument represent the variable name, the second its value.
* You can't assign the same variable both private and public.
* If the variable already exist an exception will be thrown.
* ```$handler``` is a callable function that will be called on variable changes.
* ```$handlerArgs``` is an array of arguments of the above function.
* Variable handling will work only on dinamically generated public/private/protected variables.

#### Managment of functions

###### Adding a function
```php
    //private
    $f->addPrivateFunction("sayHello",$callback);
    //or public
    $f->addPublicFunction("sayHello2",$callback);
```
* The first argument represent the function name, the second its definition.
* `$callback` must be  [callable](http://php.net/manual/en/language.types.callable.php) or a [closure](http://php.net/manual/en/functions.anonymous.php).
* You can't assign the same function both private and public.
* If the function already exist an exception will be thrown.

###### Rewritting a function
```php
    $f->replaceFunction($callbackOld,$callbackNew);
```
* The first argument rappresent the callback of function to rewrite , the second the callback(or [closure](http://php.net/manual/en/functions.anonymous.php)) for its new definition.
* If the function doesn't exist an exception will be thrown.

###### Intercepting a function
```php
    $f->interceptFunction($callbackFunction,$callbackInterceptor);
```
* The first argument rappresent the callback of function to handle , the second the callback(or [closure](http://php.net/manual/en/functions.anonymous.php)) for the interceptor definition.
* `$callbackInterceptor` is called **before** the target function.
  Files folder image Files  
File Role Description
Files folder imageexamples (3 directories)
Plain text file Editable.php Class Class source
Accessible without login Plain text file README.md Doc. Documentation

  Files folder image Files  /  examples  
File Role Description
Files folder imageadding (2 files)
Files folder imageintercepting (4 files)
Files folder imagerewritting (2 files)

  Files folder image Files  /  examples  /  adding  
File Role Description
  Plain text file B.php Class Example script
  Accessible without login Plain text file test.php Example Example script

  Files folder image Files  /  examples  /  intercepting  
File Role Description
  Plain text file B.php Class Example script
  Accessible without login Plain text file test2.php Example Example script
  Accessible without login Plain text file test3.php Example Example script
  Accessible without login Plain text file tets.php Example Example script

  Files folder image Files  /  examples  /  rewritting  
File Role Description
  Plain text file B.php Class Example script
  Accessible without login Plain text file test.php Example Example script

 Version Control Unique User Downloads Download Rankings  
 100%Total:249All time:7,162
 This week:0This week:1,199Up
 User Comments (1)  
 
good
1 year ago (Rahul Shambharkar)
80%StarStarStarStarStar