RetailCRM-Mirror/doctrine2
1
0
Fork 0
mirror of synced 2025-01-29 19:41:45 +03:00
Code Issues Projects Releases Wiki Activity

[DDC-1766] Explain details of Hydration cache, introduce AbstractQuery#setResultCacheProfile method

Browse Source
This commit is contained in:
Benjamin Eberlei 2012-04-04 23:55:14 +02:00
parent c32a77e6be
commit d31c7f5e2b
1 changed files with 25 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
lib/Doctrine/ORM/AbstractQuery.php
View File

@ -311,6 +311,12 @@ abstract class AbstractQuery
* If no result cache driver is set in the QueryCacheProfile, the default * If no result cache driver is set in the QueryCacheProfile, the default
* result cache driver is used from the configuration. * result cache driver is used from the configuration.
* *
* Important: Hydration caching does NOT register entities in the
* UnitOfWork when retrieved from the cache. Never use result cached
* entities for requests that also flush the EntityManager. If you want
* some form of caching with UnitOfWork registration you should use
* {@see AbstractQuery::setResultCacheProfile()}.
*
* @example * @example
* $lifetime = 100; * $lifetime = 100;
* $resultKey = "abc"; * $resultKey = "abc";
@ -338,6 +344,25 @@ abstract class AbstractQuery
return $this->_hydrationCacheProfile; return $this->_hydrationCacheProfile;
} }
/**
* Set a cache profile for the result cache.
*
* If no result cache driver is set in the QueryCacheProfile, the default
* result cache driver is used from the configuration.
*
* @param \Doctrine\DBAL\Cache\QueryCacheProfile $profile
* @return \Doctrine\ORM\AbstractQuery
*/
public function setResultCacheProfile(QueryCacheProfile $profile = null)
{
if ( ! $profile->getResultCacheDriver()) {
$profile = $profile->setResultCacheDriver($this->_em->getConfiguration()->getResultCacheImpl());
}
$this->_queryCacheProfile = $profile;
return $this;
}
/** /**
* Defines a cache driver to be used for caching result sets and implictly enables caching. * Defines a cache driver to be used for caching result sets and implictly enables caching.
* *