Files
smarty/tests/UnitTests/SmartyMethodsTests/ClearCompiledTemplate/ClearCompiledTest.php
Simon Wisselink ff2ef3b0cb Redirect test temp dirs to system temp directory
* Redirect test temp dirs to system temp directory. Fixes #1178

Move all test-generated output (compiled templates, cache files, and
temporary template sources) from per-test-directory folders inside the
working tree to a parallel structure under sys_get_temp_dir()/smarty-tests/.

This removes 215 boilerplate .gitignore files from the repo and ensures
running the test suite leaves zero uncommitted files in the working tree.

All 2296 tests continue to pass with identical behavior.

* Isolate each test class in a unique temp directory

getTempDir() now appends a per-class uniqid token to the temp path, so
concurrent or sequential test runs never share compiled/cached output.
The token is generated lazily on first use and reset in
tearDownAfterClass(), giving every test class a fresh isolated directory.

As a result, the Bootstrap.php pre-run cleanup of smarty-tests/ is no
longer needed for correctness (stale paths are unreachable) and was
harmful to concurrent runs, so it has been removed.

* Remove individualFolders dead code and spurious assertTrue from cleanDirs()

- Remove the never-active individualFolders code path from setUpSmarty()
  (the constant was always true, making the branch unreachable)
- Remove define('individualFolders') from Config.php and the constructor
- Remove $this->assertTrue(true) from cleanDirs(): it existed solely to
  make testInit() count as a passing test; now that cleanDirs() is called
  from setUpSmarty() and from test methods directly, the assertion was
  spuriously inflating assertion counts
- Add tests/**/templates_c/, cache/, templates_tmp/ to .gitignore to
  prevent stale test output from appearing as untracked files

* Clean up each test class's unique temp dir in tearDownAfterClass()

Add a private static removeDir() helper and call it from
tearDownAfterClass() to recursively delete the per-class unique temp
directory after each test class finishes. Cleanup failures are silently
ignored (@ suppression) so they never cause test failures.

Set KEEP_SMARTY_TEST_ARTIFACTS=1 in the environment to skip cleanup and
keep the artifacts on disk for debugging.

* cleanup of unused template files, non-shared files stored in __shared folder, no longer required calls to add template folders et cetera

* fixed the unit tests

* Apply suggestions from code review

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* remove useless resetting of static properties in tearDownAfterClass

* changed an incorrect doc and formatted some code.

* add changelog

---------

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2026-04-13 21:36:33 +02:00

447 lines
14 KiB
PHP

<?php
/**
* Smarty PHPunit tests for deleting compiled templates
*
* @author Uwe Tews
* @author Rodney Rehm
*/
/**
* class for delete compiled template tests
*
*
*
*
*/
class ClearCompiledTest extends PHPUnit_Smarty
{
public function setUp(): void
{
$this->setUpSmarty(__DIR__);
$this->smarty->setTemplateDir('./templates/');
$this->smarty->addTemplateDir('./templates_2/');
}
// helpers
/**
* clear $smarty->compile_dir
*
* @return void
*/
protected function clearFiles()
{
$this->cleanCompileDir();
}
/**
* list of compiled files
*
* @var array
*/
protected $_files = array();
/**
* generate compiled files
*
* @uses $_files to store references
* @return array list of files array( id => path )
*/
protected function makeFiles()
{
$this->_files = array();
$directory_length = strlen($this->getSmarty()->getCompileDir());
$templates = array(
'helloworld.tpl' => array(null, 'compile1', 'compile2'),
'helloworld2.tpl' => array(null, 'compile1', 'compile2'),
'ambiguous/case1/foobar.tpl' => array(null, 'compile1', 'compile2'),
'[1]ambiguous/case1/foobar.tpl' => array(null, 'compile1', 'compile2'),
);
foreach ($templates as $template => $compile_ids) {
foreach ($compile_ids as $compile_id) {
$tpl = $this->getSmarty()->createTemplate($template, null, $compile_id);
$tpl->fetch();
$this->_files[$template . '#' . $compile_id] = substr($tpl->getCompiled()->filepath, $directory_length);
}
}
return $this->_files;
}
/**
* Transform $id to $path
*
* @param array $keys IDs like "template#compile_id"
*
* @return array list of (sorted) compiled file paths
*/
protected function expectFiles($keys)
{
$files = array();
foreach ($keys as $key) {
if (isset($this->_files[$key])) {
$files[] = $this->_files[$key];
}
}
sort($files);
return $files;
}
/**
* update mtime of compiled files
*
* @param array $keys IDs like "template#compile_id"
* @param string $offset time offset added to time()
*
* @return void
*/
protected function touchFiles($keys, $offset = 0)
{
$base = $this->getSmarty()->getCompileDir();
$time = time();
foreach ($keys as $key) {
if (isset($this->_files[$key])) {
file_put_contents($base . $this->_files[$key], ' #');
touch($base . $this->_files[$key], $time + $offset);
}
}
clearstatcache();
}
/**
* find all compiled files
*
* @return array list of (sorted) compiled file paths
*/
protected function getFiles()
{
$directory = realpath($this->getSmarty()->getCompileDir());
if (!$directory) {
return array();
}
$directory_length = strlen($directory);
$files = array();
$di = new RecursiveDirectoryIterator($directory);
$it = new RecursiveIteratorIterator($di);
foreach ($it as $file) {
$_file = $file->__toString();
// skip anything with a /. in it.
if (preg_match("#[\\\\/]\.#", $_file) || substr((string)$file,-4) === '.txt' || !$file->isFile()) {
continue;
}
$files[] = substr($file->__toString(), $directory_length + 1);
}
sort($files);
return $files;
}
// Smarty::clearCompiledTemplate(null, null, null)
public function testClearAll()
{
$this->runClearAll(false);
}
public function testSubsClearAll()
{
$this->runClearAll(true);
}
public function runClearAll($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array();
$this->assertEquals(12, $this->getSmarty()->clearCompiledTemplate());
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate($template, null, null)
public function testClearTemplate()
{
$this->runClearTemplate(false);
}
public function testSubsClearTemplate()
{
$this->runClearTemplate(true);
}
public function testClearOtherTemplate()
{
$this->runClearOtherTemplate(false);
}
public function testSubsClearOtherTemplate()
{
$this->runClearOtherTemplate(true);
}
public function runClearTemplate($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile1', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->assertEquals(3, $this->getSmarty()->clearCompiledTemplate('helloworld.tpl'));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
public function runClearOtherTemplate($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array_keys($this->_files);
$this->assertEquals(0, $this->getSmarty()->clearCompiledTemplate('foobar.tpl'));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate(null, $cache_id, null)
public function testClearCompileid()
{
$this->runClearCompileid(false);
}
public function testSubsClearCompileid()
{
$this->runClearCompileid(true);
}
public function testClearOtherCompileid()
{
$this->runClearOtherCompileid(false);
}
public function testSubsClearOtherCompileid()
{
$this->runClearOtherCompileid(true);
}
public function runClearCompileid($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$count = $this->getSmarty()->clearCompiledTemplate(null, 'compile1');
$this->assertEquals(4, $count);
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
public function runClearOtherCompileid($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array_keys($this->_files);
$this->assertEquals(0, $this->getSmarty()->clearCompiledTemplate(null, 'other'));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate(null, null, $expired)
public function testClearExpired()
{
$this->runClearExpired(false);
}
public function testSubsClearExpired()
{
$this->runClearExpired(true);
}
public function runClearExpired($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array('helloworld.tpl#', 'helloworld2.tpl#');
$this->touchFiles(array_diff(array_keys($this->_files), $expected), - 1000);
$this->assertEquals(10, $this->getSmarty()->clearCompiledTemplate(null, null, 500));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate($template, null, $expired)
public function testClearTemplateExpired()
{
$this->runClearTemplateExpired(false);
}
public function testSubsClearTemplateExpired()
{
$this->runClearTemplateExpired(true);
}
public function runClearTemplateExpired($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile1', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->touchFiles(array('helloworld.tpl#compile1'), - 1000);
$this->assertEquals(1, $this->getSmarty()->clearCompiledTemplate("helloworld.tpl", null, 500));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate($template, $cache_id, $expired)
public function testClearTemplateCacheidExpired()
{
$this->runClearTemplateCacheidExpired(false);
}
public function testSubsClearTemplateCacheidExpired()
{
$this->runClearTemplateCacheidExpired(true);
}
public function runClearTemplateCacheidExpired($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile1', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->touchFiles(array('helloworld.tpl#compile1', 'helloworld.tpl#compile2'), - 1000);
$this->assertEquals(1, $this->getSmarty()->clearCompiledTemplate("helloworld.tpl", "compile1", 500));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate(null, $cache_id, $expired)
public function testClearCacheidExpired()
{
$this->runClearCacheidExpired(false);
}
public function testSubsClearCacheidExpired()
{
$this->runClearCacheidExpired(true);
}
public function runClearCacheidExpired($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile1', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->touchFiles(array('helloworld.tpl#compile1'), - 1000);
$this->assertEquals(1, $this->getSmarty()->clearCompiledTemplate(null, "compile1", 500));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
// Smarty::clearCompiledTemplate($template, $cache_id, null)
public function testClearTemplateCacheid()
{
$this->runClearTemplateCacheid(false);
}
public function testSubsClearTemplateCacheid()
{
$this->runClearTemplateCacheid(true);
}
public function runClearTemplateCacheid($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'ambiguous/case1/foobar.tpl#', 'ambiguous/case1/foobar.tpl#compile1', 'ambiguous/case1/foobar.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->assertEquals(1, $this->getSmarty()->clearCompiledTemplate("helloworld.tpl", "compile1"));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
public function testClearAmbiguousTemplate()
{
$this->runClearAmbiguousTemplate(false);
}
public function testSubsAmbiguousTemplate()
{
$this->runClearAmbiguousTemplate(true);
}
public function runClearAmbiguousTemplate($useSubDirs)
{
$this->getSmarty()->setUseSubDirs($useSubDirs);
$this->clearFiles();
$this->makeFiles();
// TODO: uwe.tews - shouldn't clearCompiledTemplate("foo.tpl") remove "{$template_dir[0]}/foo.tpl" AND "{$template_dir[1]}/foo.tpl"?
// currently it kills only the first one found (through regular template file identification methods)
$expected = array(
'helloworld.tpl#', 'helloworld.tpl#compile1', 'helloworld.tpl#compile2',
'helloworld2.tpl#', 'helloworld2.tpl#compile1', 'helloworld2.tpl#compile2',
'[1]ambiguous/case1/foobar.tpl#', '[1]ambiguous/case1/foobar.tpl#compile1', '[1]ambiguous/case1/foobar.tpl#compile2',
);
$this->assertEquals(3, $this->getSmarty()->clearCompiledTemplate("ambiguous/case1/foobar.tpl"));
$this->assertEquals($this->expectFiles($expected), $this->getFiles());
$this->clearFiles();
}
}