Sergey Makinen
7 years ago
committed by
Alexander Makarov
7 changed files with 220 additions and 91 deletions
@ -0,0 +1,40 @@ |
|||||||
|
<?php |
||||||
|
/** |
||||||
|
* @link http://www.yiiframework.com/ |
||||||
|
* @copyright Copyright (c) 2008 Yii Software LLC |
||||||
|
* @license http://www.yiiframework.com/license/ |
||||||
|
*/ |
||||||
|
|
||||||
|
namespace yii\base; |
||||||
|
|
||||||
|
/** |
||||||
|
* DynamicContentAwareInterface is the interface that should be implemented by classes |
||||||
|
* which support a [[View]] dynamic content feature. |
||||||
|
* |
||||||
|
* @author Sergey Makinen <sergey@makinen.ru> |
||||||
|
* @since 2.0.14 |
||||||
|
*/ |
||||||
|
interface DynamicContentAwareInterface |
||||||
|
{ |
||||||
|
/** |
||||||
|
* Returns a list of placeholders for dynamic content. This method |
||||||
|
* is used internally to implement the content caching feature. |
||||||
|
* @return array a list of placeholders. |
||||||
|
*/ |
||||||
|
public function getDynamicPlaceholders(); |
||||||
|
|
||||||
|
/** |
||||||
|
* Sets a list of placeholders for dynamic content. This method |
||||||
|
* is used internally to implement the content caching feature. |
||||||
|
* @param array $placeholders a list of placeholders. |
||||||
|
*/ |
||||||
|
public function setDynamicPlaceholders($placeholders); |
||||||
|
|
||||||
|
/** |
||||||
|
* Adds a placeholder for dynamic content. |
||||||
|
* This method is used internally to implement the content caching feature. |
||||||
|
* @param string $name the placeholder name. |
||||||
|
* @param string $statements the PHP statements for generating the dynamic content. |
||||||
|
*/ |
||||||
|
public function addDynamicPlaceholder($name, $statements); |
||||||
|
} |
@ -0,0 +1,77 @@ |
|||||||
|
<?php |
||||||
|
|
||||||
|
namespace yii\base; |
||||||
|
|
||||||
|
/** |
||||||
|
* DynamicContentAwareTrait implements common methods for classes |
||||||
|
* which support a [[View]] dynamic content feature. |
||||||
|
* |
||||||
|
* @author Sergey Makinen <sergey@makinen.ru> |
||||||
|
* @since 2.0.14 |
||||||
|
*/ |
||||||
|
trait DynamicContentAwareTrait |
||||||
|
{ |
||||||
|
/** |
||||||
|
* @var string[] a list of placeholders for dynamic content |
||||||
|
*/ |
||||||
|
private $_dynamicPlaceholders; |
||||||
|
|
||||||
|
/** |
||||||
|
* Returns the view object that can be used to render views or view files using dynamic contents. |
||||||
|
* @return View the view object that can be used to render views or view files. |
||||||
|
*/ |
||||||
|
abstract protected function getView(); |
||||||
|
|
||||||
|
/** |
||||||
|
* {@inheritdoc} |
||||||
|
*/ |
||||||
|
public function getDynamicPlaceholders() |
||||||
|
{ |
||||||
|
return $this->_dynamicPlaceholders; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* {@inheritdoc} |
||||||
|
*/ |
||||||
|
public function setDynamicPlaceholders($placeholders) |
||||||
|
{ |
||||||
|
$this->_dynamicPlaceholders = $placeholders; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* {@inheritdoc} |
||||||
|
*/ |
||||||
|
public function addDynamicPlaceholder($name, $statements) |
||||||
|
{ |
||||||
|
$this->_dynamicPlaceholders[$name] = $statements; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* Replaces placeholders in $content with results of evaluated dynamic statements. |
||||||
|
* @param string $content content to be parsed. |
||||||
|
* @param string[] $placeholders placeholders and their values. |
||||||
|
* @param bool $isRestoredFromCache whether content is going to be restored from cache. |
||||||
|
* @return string final content. |
||||||
|
*/ |
||||||
|
protected function updateDynamicContent($content, $placeholders, $isRestoredFromCache = false) |
||||||
|
{ |
||||||
|
if (empty($placeholders) || !is_array($placeholders)) { |
||||||
|
return $content; |
||||||
|
} |
||||||
|
|
||||||
|
if (count($this->getView()->getDynamicContents()) === 0) { |
||||||
|
// outermost cache: replace placeholder with dynamic content |
||||||
|
foreach ($placeholders as $name => $statements) { |
||||||
|
$placeholders[$name] = $this->getView()->evaluateDynamicContent($statements); |
||||||
|
} |
||||||
|
$content = strtr($content, $placeholders); |
||||||
|
} |
||||||
|
if ($isRestoredFromCache) { |
||||||
|
foreach ($placeholders as $name => $statements) { |
||||||
|
$this->getView()->addDynamicPlaceholder($name, $statements); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
return $content; |
||||||
|
} |
||||||
|
} |
Loading…
Reference in new issue