* Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org) * * Licensed under The MIT License * For full copyright and license information, please see the LICENSE.txt * Redistributions of files must retain the above copyright notice * * @copyright Copyright (c) Cake Software Foundation, Inc. (https://cakefoundation.org) * @link https://book.cakephp.org/2.0/en/development/testing.html CakePHP(tm) Tests * @package Cake.Test.Case.Utility * @since CakePHP(tm) v 1.2.0.4206 * @license https://opensource.org/licenses/mit-license.php MIT License */ App::uses('File', 'Utility'); App::uses('Folder', 'Utility'); /** * FileTest class * * @package Cake.Test.Case.Utility * @coversDefaultClass File */ class FileTest extends CakeTestCase { /** * File property * * @var mixed */ public $File = null; /** * setup the test case * * @return void */ public function setUp() : void { parent::setUp(); $file = __FILE__; $this->File = new File($file); } /** * tearDown method * * @return void */ public function tearDown() : void { parent::tearDown(); $this->File->close(); unset($this->File); $Folder = new Folder(); $Folder->delete(TMP . 'tests' . DS . 'permissions'); } /** * testBasic method * * @return void * @covers ::__construct * @covers ::info * @covers ::ext * @covers ::name * @covers ::md5 * @covers ::size * @covers ::owner * @covers ::group * @covers ::Folder */ public function testBasic() { $file = CAKE . DS . 'LICENSE.txt'; $this->File = new File($file, false); $result = $this->File->name; $expecting = basename($file); $this->assertEquals($expecting, $result); $result = $this->File->info(); $expecting = array( 'dirname' => dirname($file), 'basename' => basename($file), 'extension' => 'txt', 'filename' => 'LICENSE', 'filesize' => filesize($file), 'mime' => 'text/plain' ); if (!function_exists('finfo_open') && (!function_exists('mime_content_type') || function_exists('mime_content_type') && mime_content_type($this->File->pwd()) === false) ) { $expecting['mime'] = false; } $this->assertEquals($expecting, $result); $result = $this->File->ext(); $expecting = 'txt'; $this->assertEquals($expecting, $result); $result = $this->File->name(); $expecting = 'LICENSE'; $this->assertEquals($expecting, $result); $result = $this->File->md5(); $expecting = md5_file($file); $this->assertEquals($expecting, $result); $result = $this->File->md5(true); $expecting = md5_file($file); $this->assertEquals($expecting, $result); $result = $this->File->size(); $expecting = filesize($file); $this->assertEquals($expecting, $result); $result = $this->File->owner(); $expecting = fileowner($file); $this->assertEquals($expecting, $result); $result = $this->File->group(); $expecting = filegroup($file); $this->assertEquals($expecting, $result); $result = $this->File->Folder(); $this->assertInstanceOf('Folder', $result); } /** * testPermission method * * @return void * @covers ::perms */ public function testPermission() { $this->skipIf(DIRECTORY_SEPARATOR === '\\', 'File permissions tests not supported on Windows.'); $dir = TMP . 'tests' . DS . 'permissions' . DS; $old = umask(); umask(0002); $file = $dir . 'permission_' . uniqid(); $expecting = decoct(0664 & ~umask()); $File = new File($file, true); $result = $File->perms(); $this->assertEquals($expecting, $result); $File->delete(); umask(0022); $file = $dir . 'permission_' . uniqid(); $expecting = decoct(0644 & ~umask()); $File = new File($file, true); $result = $File->perms(); $this->assertEquals($expecting, $result); $File->delete(); umask(0422); $file = $dir . 'permission_' . uniqid(); $expecting = decoct(0244 & ~umask()); $File = new File($file, true); $result = $File->perms(); $this->assertEquals($expecting, $result); $File->delete(); umask(0444); $file = $dir . 'permission_' . uniqid(); $expecting = decoct(0222 & ~umask()); $File = new File($file, true); $result = $File->perms(); $this->assertEquals($expecting, $result); $File->delete(); umask($old); } /** * testRead method * * @return void * @covers ::read */ public function testRead() { $file = __FILE__; $this->File = new File($file); $result = $this->File->read(); $expecting = file_get_contents(__FILE__); $this->assertEquals($expecting, $result); $this->assertTrue(!is_resource($this->File->handle)); $this->File->lock = true; $result = $this->File->read(); $expecting = file_get_contents(__FILE__); $this->assertEquals(trim($expecting), $result); $this->File->lock = null; $data = $expecting; $expecting = substr($data, 0, 3); $result = $this->File->read(3); $this->assertEquals($expecting, $result); $this->assertTrue(is_resource($this->File->handle)); $expecting = substr($data, 3, 3); $result = $this->File->read(3); $this->assertEquals($expecting, $result); } /** * testOffset method * * @return void * @covers ::offset */ public function testOffset() { $this->File->close(); $result = $this->File->offset(); $this->assertFalse($result); $this->assertFalse(is_resource($this->File->handle)); $success = $this->File->offset(0); $this->assertTrue($success); $this->assertTrue(is_resource($this->File->handle)); $result = $this->File->offset(); $expected = 0; $this->assertSame($expected, $result); $data = file_get_contents(__FILE__); $success = $this->File->offset(5); $expected = substr($data, 5, 3); $result = $this->File->read(3); $this->assertTrue($success); $this->assertEquals($expected, $result); $result = $this->File->offset(); $expected = 5 + 3; $this->assertSame($expected, $result); } /** * testOpen method * * @return void * @covers ::open */ public function testOpen() { $this->File->handle = null; $r = $this->File->open(); $this->assertTrue(is_resource($this->File->handle)); $this->assertTrue($r); $handle = $this->File->handle; $r = $this->File->open(); $this->assertTrue($r); $this->assertTrue($handle === $this->File->handle); $this->assertTrue(is_resource($this->File->handle)); $r = $this->File->open('r', true); $this->assertTrue($r); $this->assertFalse($handle === $this->File->handle); $this->assertTrue(is_resource($this->File->handle)); } /** * testClose method * * @return void * @covers ::close */ public function testClose() { $this->File->handle = null; $this->assertFalse(is_resource($this->File->handle)); $this->assertTrue($this->File->close()); $this->assertFalse(is_resource($this->File->handle)); $this->File->handle = fopen(__FILE__, 'r'); $this->assertTrue(is_resource($this->File->handle)); $this->assertTrue($this->File->close()); $this->assertFalse(is_resource($this->File->handle)); } /** * testCreate method * * @return void * @covers ::create * @covers ::exists * @covers ::clearStatCache */ public function testCreate() { $tmpFile = TMP . 'tests' . DS . 'cakephp.file.test.tmp'; $File = new File($tmpFile, true, 0777); $this->assertTrue($File->exists()); } /** * Tests the exists() method. * * @return void */ public function testExists() { $tmpFile = TMP . 'tests/cakephp.file.test.tmp'; $file = new File($tmpFile, true, 0777); $this->assertTrue($file->exists(), 'absolute path should exist'); $file = new File('file://' . $tmpFile, false); $this->assertTrue($file->exists(), 'file:// should exist.'); $file = new File('/something/bad', false); $this->assertFalse($file->exists(), 'missing file should not exist.'); } /** * testOpeningNonExistentFileCreatesIt method * * @return void * @covers ::open * @covers ::create */ public function testOpeningNonExistentFileCreatesIt() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertTrue($someFile->open()); $this->assertEquals('', $someFile->read()); $someFile->close(); $someFile->delete(); } /** * testPrepare method * * @return void * @covers ::prepare */ public function testPrepare() { $string = "some\nvery\ncool\r\nteststring here\n\n\nfor\r\r\n\n\r\n\nhere"; if (DS === '\\') { $expected = "some\r\nvery\r\ncool\r\nteststring here\r\n\r\n\r\n"; $expected .= "for\r\n\r\n\r\n\r\n\r\nhere"; } else { $expected = "some\nvery\ncool\nteststring here\n\n\nfor\n\n\n\n\nhere"; } $this->assertSame($expected, File::prepare($string)); $expected = "some\r\nvery\r\ncool\r\nteststring here\r\n\r\n\r\n"; $expected .= "for\r\n\r\n\r\n\r\n\r\nhere"; $this->assertSame($expected, File::prepare($string, true)); } /** * testReadable method * * @return void * @covers ::readable */ public function testReadable() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertTrue($someFile->open()); $this->assertTrue($someFile->readable()); $someFile->close(); $someFile->delete(); } /** * testWritable method * * @return void * @covers ::writable */ public function testWritable() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertTrue($someFile->open()); $this->assertTrue($someFile->writable()); $someFile->close(); $someFile->delete(); } /** * testExecutable method * * @return void * @covers ::executable */ public function testExecutable() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertTrue($someFile->open()); $this->assertFalse($someFile->executable()); $someFile->close(); $someFile->delete(); } /** * testLastAccess method * * @return void * @covers ::lastAccess */ public function testLastAccess() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertFalse($someFile->lastAccess()); $this->assertTrue($someFile->open()); $this->assertWithinMargin($someFile->lastAccess(), time(), 2); $someFile->close(); $someFile->delete(); } /** * testLastChange method * * @return void * @covers ::lastChange */ public function testLastChange() { $someFile = new File(TMP . 'some_file.txt', false); $this->assertFalse($someFile->lastChange()); $this->assertTrue($someFile->open('r+')); $this->assertWithinMargin($someFile->lastChange(), time(), 2); $someFile->write('something'); $this->assertWithinMargin($someFile->lastChange(), time(), 2); $someFile->close(); $someFile->delete(); } /** * testWrite method * * @return void * @covers ::write */ public function testWrite() { if (!$tmpFile = $this->_getTmpFile()) { return false; } if (file_exists($tmpFile)) { unlink($tmpFile); } $TmpFile = new File($tmpFile); $this->assertFalse(file_exists($tmpFile)); $this->assertFalse(is_resource($TmpFile->handle)); $testData = array('CakePHP\'s', ' test suite', ' was here ...', ''); foreach ($testData as $data) { $r = $TmpFile->write($data); $this->assertTrue($r); $this->assertTrue(file_exists($tmpFile)); $this->assertEquals($data, file_get_contents($tmpFile)); $this->assertTrue(is_resource($TmpFile->handle)); $TmpFile->close(); } unlink($tmpFile); } /** * testAppend method * * @return void * @covers ::append */ public function testAppend() { if (!$tmpFile = $this->_getTmpFile()) { return false; } if (file_exists($tmpFile)) { unlink($tmpFile); } $TmpFile = new File($tmpFile); $this->assertFalse(file_exists($tmpFile)); $fragments = array('CakePHP\'s', ' test suite', ' was here ...'); $data = null; $size = 0; foreach ($fragments as $fragment) { $r = $TmpFile->append($fragment); $this->assertTrue($r); $this->assertTrue(file_exists($tmpFile)); $data = $data . $fragment; $this->assertEquals($data, file_get_contents($tmpFile)); $newSize = $TmpFile->size(); $this->assertTrue($newSize > $size); $size = $newSize; $TmpFile->close(); } $TmpFile->append(''); $this->assertEquals($data, file_get_contents($tmpFile)); $TmpFile->close(); } /** * testDelete method * * @return void * @covers ::delete */ public function testDelete() { if (!$tmpFile = $this->_getTmpFile()) { return false; } if (!file_exists($tmpFile)) { touch($tmpFile); } $TmpFile = new File($tmpFile); $this->assertTrue(file_exists($tmpFile)); $result = $TmpFile->delete(); $this->assertTrue($result); $this->assertFalse(file_exists($tmpFile)); $TmpFile = new File('/this/does/not/exist'); $result = $TmpFile->delete(); $this->assertFalse($result); } /** * Windows has issues unlinking files if there are * active filehandles open. * * @return void * @covers ::delete */ public function testDeleteAfterRead() { if (!$tmpFile = $this->_getTmpFile()) { return false; } if (!file_exists($tmpFile)) { touch($tmpFile); } $File = new File($tmpFile); $File->read(); $this->assertTrue($File->delete()); } /** * testCopy method * * @return void * @covers ::copy */ public function testCopy() { $dest = TMP . 'tests' . DS . 'cakephp.file.test.tmp'; $file = __FILE__; $this->File = new File($file); $result = $this->File->copy($dest); $this->assertTrue($result); $result = $this->File->copy($dest, true); $this->assertTrue($result); $result = $this->File->copy($dest, false); $this->assertFalse($result); $this->File->close(); unlink($dest); $TmpFile = new File('/this/does/not/exist'); $result = $TmpFile->copy($dest); $this->assertFalse($result); $TmpFile->close(); } /** * Test mime() * * @return void * @covers ::mime */ public function testMime() { $this->skipIf(!function_exists('finfo_open') && !function_exists('mime_content_type'), 'Not able to read mime type'); $path = CAKE . 'Test' . DS . 'test_app' . DS . 'webroot' . DS . 'img' . DS . 'cake.power.gif'; $file = new File($path); $expected = 'image/gif'; if (function_exists('mime_content_type') && mime_content_type($file->pwd()) === false) { $expected = false; } $this->assertEquals($expected, $file->mime()); } /** * getTmpFile method * * @param bool $paintSkip * @return void */ protected function _getTmpFile($paintSkip = true) { $tmpFile = TMP . 'tests' . DS . 'cakephp.file.test.tmp'; if (is_writable(dirname($tmpFile)) && (!file_exists($tmpFile) || is_writable($tmpFile))) { return $tmpFile; } if ($paintSkip) { $trace = debug_backtrace(); $caller = $trace[0]['function']; $shortPath = dirname($tmpFile); $message = __d('cake_dev', '[FileTest] Skipping %s because "%s" not writeable!', $caller, $shortPath); $this->markTestSkipped($message); } return false; } /** * testReplaceText method * * @return void * @covers ::replaceText */ public function testReplaceText() { $TestFile = new File(dirname(__FILE__) . '/../../test_app/Vendor/welcome.php'); $TmpFile = new File(TMP . 'tests' . DS . 'cakephp.file.test.tmp'); // Copy the test file to the temporary location $TestFile->copy($TmpFile->path, true); // Replace the contents of the tempory file $result = $TmpFile->replaceText('welcome.php', 'welcome.tmp'); $this->assertTrue($result); // Double check $expected = 'This is the welcome.tmp file in vendors directory'; $contents = $TmpFile->read(); $this->assertStringContainsString($expected, $contents); $search = array('This is the', 'welcome.php file', 'in tmp directory'); $replace = array('This should be a', 'welcome.tmp file', 'in the Lib directory'); // Replace the contents of the tempory file $result = $TmpFile->replaceText($search, $replace); $this->assertTrue($result); // Double check $expected = 'This should be a welcome.tmp file in vendors directory'; $contents = $TmpFile->read(); $this->assertStringContainsString($expected, $contents); $TmpFile->delete(); } /** * Tests that no path is being set for passed file paths that * do not exist. * * @return void * @covers ::pwd */ public function testNoPartialPathBeingSetForNonExistentPath() { $tmpFile = new File('/non/existent/file'); $this->assertNull($tmpFile->pwd()); $this->assertNull($tmpFile->path); } }