/**
* Renders a template.
* @param string $name A template name
* @param array $parameters An array of parameters to pass to the template
* the default options engine can be override by $parameters['_engine_'][option]
* @return string The evaluated template as a string
*
* @throws \InvalidArgumentException if the template does not exist
* @throws \RuntimeException if the template cannot be rendered
*/
public function render($name, array $parameters = array() )
{
$template = new \PHPTAL();
// engine options by parameters to relpace configuration
if(isset($parameters['_engine_'])&&(is_array($parameters['_engine_']))){
$options = $parameters['_engine_'];
}else{
$options = array();
}
// code cache destination
$tmpdir = (isset($options['cache_dir']))?$options['cache_dir']:$this->options['cache_dir'];
if(!is_dir($tmpdir)){mkdir($tmpdir);}
$template->setPhpCodeDestination($tmpdir);
// code cache durration
$template->setCacheLifetime( (isset($options['cache_dir']))?$options['cache_lifetime']:$this->options['cache_lifetime'] );
// encoding
$template->setEncoding( (isset($options['charset']))?$options['charset']:$this->options['charset'] );
// output mod
if(!isset($options['output_format'])){
$options['output_format'] = $this->options['output_mode'];
}
if($options['output_format']=='XHTML'){
$template->setOutputMode( \PHPTAL::XHTML );
}elseif($options['output_format']=='HTML5'){
$template->setOutputMode( \PHPTAL::HTML5 );
}elseif($options['output_format']=='XML'){
$template->setOutputMode( \PHPTAL::XML );
}else{
throw new \InvalidArgumentException('Unsupported output mode ' . $options['output_format']);
}
// force reparse (for debug prefilter)
$template->setForceReparse( (isset($options['force_reparse']))?$options['force_reparse']:$this->options['force_reparse'] );
// pre filters
$filtres = $this->options['pre_filters'];
foreach($filtres as $filtre){
$template->addPreFilter( new $filtre['class']($filtre['params']) );
}
// post filters
$filtres = $this->options['post_filters'];
if($filtres){
$template->setPostFilter(new PhptalPostFilters($filtres));
}
// set SourceResolver
if(!isset($options['resolver'])){
$template->addSourceResolver($this->resolver);
}else{
if($this->container->has($options['resolver'])){
$resolver = $this->container->get($options['resolver']);
$r = new \ReflectionClass( get_class($resolver) );
if (!$r->implementsInterface('Neni\\PhptalBundle\\Phptal\\PhptalResolverInterface')) {
throw new \InvalidArgumentException(sprintf('The service "%s" does implements PhptalResolverInterface.', $options['resolver']));
}else{
$template->addSourceResolver( $resolver );
}
}else{
throw new \InvalidArgumentException(sprintf('The service "%s" does not exist.', $options['resolver']));
}
}
// set source template
$template->setTemplate($name);
// set data
if(!isset($options['populater'])){
unset($parameters['_engine_']);
$this->populater->populate($template, $parameters);
}else{
if($this->container->has($options['populater'])){
$populater = $this->container->get($options['populater']);
$r = new \ReflectionClass( get_class($populater) );
if (!$r->implementsInterface('Neni\\PhptalBundle\\Phptal\\PhptalPopulaterInterface')) {
throw new \InvalidArgumentException(sprintf('The service "%s" does implements PhptalPopulaterInterface.', $options['populater']));
}else{
unset($parameters['_engine_']);
$populater->populate($template, $parameters);
}
}else{
throw new \InvalidArgumentException(sprintf('The service "%s" does not exist.', $options['populater']));
}
}
// generic helper
$template->Helper = new PhptalGenericHelper($this->container, $parameters);
// perform
try{
$result = $template->execute();
}catch (PHPTAL_TemplateException $e){
throw new \InvalidArgumentException($e->getMessage(), $e->getCode(), $e);
}
return $result;
}
/**
* Returns PHPTAL output - either from a render or from the cache.
*
* @param string|array $template The name of the template to render or
* an array with the ('src') src for a template
* and a ('name') name to help identify the
* template in error messages.
*
* @return string
*/
public function render($template)
{
// Check we are fully configured and initialised.
if ($this->_engine == null) {
throw new \Zend_View_Exception('PHPTAL is not defined', $this);
}
// If a cache has been setup and content is available, return it
if ($this->_zendPageCacheContent != false) {
return $this->_zendPageCacheContent;
}
// Setup the script locations based on the view's script paths
$this->_engine->setTemplateRepository($this->getScriptPaths());
// Do this at this point rather than in the constructor because we don't
// know what the template repositories are going to be at that point.
$this->_engine->addSourceResolver(new PharResolver($this->getScriptPaths()));
// Assign all the variables set here through to the PHPTAL engine.
foreach ($this->getVars() as $key => $value) {
$this->_engine->set($key, $value);
}
if (!is_array($template)) {
$this->_engine->setTemplate($this->_convertTemplateName($template));
} else {
$this->_engine->setSource($template['src'], $template['name']);
}
// Setup a collection of standard variable available in the view
$this->_engine->set('doctype', $this->doctype());
$this->_engine->set('headTitle', $this->headTitle());
$this->_engine->set('headScript', $this->headScript());
$this->_engine->set('headLink', $this->headLink());
$this->_engine->set('headMeta', $this->headMeta());
$this->_engine->set('headStyle', $this->headStyle());
$this->productionMode = 'production' == APPLICATION_ENV;
// If perging of the tal template cache is enabled
// find all template cache files and delete them
if ($this->_purgeCacheBeforeRender) {
$cacheFolder = $this->_engine->getPhpCodeDestination();
if (is_dir($cacheFolder)) {
foreach (new \DirectoryIterator($cacheFolder) as $cacheItem) {
if (strncmp($cacheItem->getFilename(), 'tpl_', 4) != 0 || $cacheItem->isdir()) {
continue;
}
@unlink($cacheItem->getPathname());
}
}
}
// if a layout is being used and nothing has already overloaded the viewContent,
// register the content as viewContent, otherwise set it to empty
if (!isset($this->viewContent)) {
if ($this->getHelperPath('layout') != false && $this->layout()->isEnabled()) {
$this->_engine->set('viewContent', $this->layout()->content);
} else {
$this->viewContent = '';
}
}
if (!$this->_preFiltersRegistered) {
// Strip html comments and compress un-needed whitespace
$this->_engine->addPreFilter(new \PHPTAL_PreFilter_StripComments());
if ($this->_compressWhitespace == true) {
$this->_engine->addPreFilter(new \PHPTAL_PreFilter_Compress());
}
$this->_preFiltersRegistered = true;
}
try {
$result = $this->_engine->execute();
} catch (\PHPTAL_TemplateException $e) {
// If the exception is a root PHPTAL_TemplateException
// rather than a subclass of this exception and xdebug is enabled,
// it will have already been picked up by xdebug, if enabled, and
// should be shown like any other php error.
// Any subclass of PHPTAL_TemplateException can be handled by
// the phptal internal exception handler as it gives a useful
// error output
if (get_class($e) == 'PHPTAL_TemplateException' && function_exists('xdebug_is_enabled') && xdebug_is_enabled()) {
exit;
}
throw $e;
}
// If the page needed to be rendered but was configured to
// cache then cache the result of the render.
if ($this->_zendPageCache instanceof \Zend_Cache_Core) {
$this->_zendPageCache->save($result, $this->_zendPageCacheKey, array(), $this->_zendPageCacheDuration);
}
return $result;
}
