Login   Register  
PHP Classes
elePHPant
Icontem

File: README.markdown

Recommend this page to a friend!
Stumble It! Stumble It! Bookmark in del.icio.us Bookmark in del.icio.us
  Classes of Gjero Krsteski  >  Building an Identity Map in PHP  >  README.markdown  >  Download  
File: README.markdown
Role: Documentation
Content type: text/plain
Description: README
Class: Building an Identity Map in PHP
Retrieve objects avoiding multiple instances
Author: By
Last change: Update master
Update README.markdown
Date: 2 years ago
Size: 2,307 bytes
 

Contents

Class file image Download
Building an Identity Map in PHP
===============================

Sample application used for training.

This example code is no production code and should be used for training
purposes only.

This example code requires:
---------------------------
* PDO a lightweight, consistent interface for accessing databases in PHP.
* PHPUnit a unit testing framework for PHP projects.

This example code implements:
-----------------------
* Data-Mapper Pattern
* Identity-Map Pattern

Why identity mapping?
---------------------
By using Data-Mapper pattern without an identity map, you can easily run
into problems because you may have more than one object that references
the same domain entity.

Data-Mapper without identity map
----------------------------------

      $userMapper = new UserMapper($pdo);

      $user1 = $userMapper->find(1); // creates new object
      $user2 = $userMapper->find(1); // creates new object

      echo $user1->getNickname(); // joe123
      echo $user2->getNickname(); // joe123

      $user1->setNickname('bob78');

      echo $user1->getNickname(); // bob78
      echo $user2->getNickname(); // joe123 -> ?!?

Data-Mapper with identity map
----------------------------------
The identity map solves this problem by acting as a registry for all
loaded domain instances.

      $userMapper = new UserMapper($pdo);

      $user1 = $userMapper->find(1); // creates new object
      $user2 = $userMapper->find(1); // returns same object

      echo $user1->getNickname(); // joe123
      echo $user2->getNickname(); // joe123

      $user1->setNickname('bob78');

      echo $user1->getNickname(); // bob78
      echo $user2->getNickname(); // bob78 -> yes, much better

By using an identity map you can be confident that your domain entity is
shared throughout your application for the duration of the request.

Note that using an identity map is not the same as adding a cache layer
to your mappers. Although caching is useful and encouraged, it can still
produce duplicate objects for the same domain entity.

Load the Data-Mappers with the Repository class
-----------------------------------------------


      $repository = new Repository($this->db);
      $userMapper = $repository->load('User');
      $insertId = $userMapper->insert(new User('billy', 'gatter'));