PHP Classes

File: README.md

Recommend this page to a friend!
  Classes of Thomas Björk  >  ObjectManager  >  README.md  >  Download  
File: README.md
Role: Auxiliary data
Content type: text/markdown
Description: Updated readme to markdown
Class: ObjectManager
Manage the creation of objects by class name
Author: By
Last change: Correcting readme to proper markdown
Date: 1 month ago
Size: 2,882 bytes
 

Contents

Class file image Download

ObjectManager

ObjectManager is an implementation of a kind of object factory with a cache capability. The objects can be created by using the classname or both a name and a classname. By calling the factory with the same name (or classname) it returns the previously created instance. The factory can be called in five different ways to allow the most flexibility according to the desired programming pattern used.

Usage

ObjectManager::Instance($name[, $class][, $action]);
  • If classname is omitted then the name is used as classname.
  • If action is true then the instance is recreated.
  • If action is false then the instance is removed.

There are several different ways to get an instance 1. Static call

$obj = ObjectManager::Instance($name, $class, $action);
  1. Normal call
    $objMgr = new ObjectManager();
    $obj = $objMgr->Instance($name, $class, $action);
    
  2. Invoke method
    $objMgr = new ObjectManager();
    $obj = $objMgr($name, $class, $action);
    
  3. Use object variable
    $objMgr = new ObjectManager();
    $obj = $objMgr->$name;
    
  4. Use array access
    $objMgr = new ObjectManager();
    $obj = $objMgr[$name];
    
    x) For static and normal calls the class can be omitted. Then the classname will be the same as the name for the instance.

There are several ways to remove a named instance 1. Static call

 ObjectManager::Instance($name, false);
  1. Normal call
    $objMgr = new ObjectManager();
    ...
    $objMgr->Instance($name, false);
    
  2. Use object variable
    $objMgr = new ObjectManager();
    ...
    $objMgr->$name = false;
    
  3. Use array access
    $objMgr = new ObjectManager();
    ...
    $objMgr[$name] = false;
    
  4. Use unset and array access
    $objMgr = new ObjectManager();
    ...
    unset($objMgr[$name]);
    

There are several ways to recreate a named instance

  1. Static call
    ObjectManager::Instance($name, $class, true);
    
  2. Normal call
    $objMgr = new ObjectManager();
    ...
    $objMgr->Instance($name, $class, true);
    
  3. Use object variable
    $objMgr = new ObjectManager();
    ...
    $objMgr->$name = true;
    
  4. Use array access
    $objMgr = new ObjectManager();
    ...
    $objMgr[$name] = true;
    
    x) For static and normal calls the class can be omitted. Then the classname will be the same as the name for the instance.

x) There is a slight limitations when using object variable and array access to create or recreate an instance since the name and classname will be the same. If there is a need to create or recreate a named object where the name and classname differs then please use static or normal calls.

Examples

There are som simple examples (also found in the file mentioned just before the example code.

There is an example file called examples_wild.php that covers a few more different ways of usage.

For more information send a message to info at phpclasses dot org.