mirror of
https://github.com/yiisoft/yii2.git
synced 2025-08-14 22:30:27 +08:00
1274 lines
54 KiB
PHP
1274 lines
54 KiB
PHP
<?php
|
|
/**
|
|
* @link https://www.yiiframework.com/
|
|
* @copyright Copyright (c) 2008 Yii Software LLC
|
|
* @license https://www.yiiframework.com/license/
|
|
*/
|
|
|
|
use yii\helpers\FileHelper;
|
|
use yii\helpers\VarDumper;
|
|
use yiiunit\TestCase;
|
|
|
|
/**
|
|
* Unit test for [[yii\helpers\FileHelper]].
|
|
* @see FileHelper
|
|
* @group helpers
|
|
*/
|
|
class FileHelperTest extends TestCase
|
|
{
|
|
/**
|
|
* @var string test files path.
|
|
*/
|
|
private $testFilePath = '';
|
|
|
|
public function setUp()
|
|
{
|
|
$this->testFilePath = Yii::getAlias('@yiiunit/runtime') . DIRECTORY_SEPARATOR . get_class($this);
|
|
$this->createDir($this->testFilePath);
|
|
if (!file_exists($this->testFilePath)) {
|
|
$this->markTestIncomplete('Unit tests runtime directory should have writable permissions!');
|
|
}
|
|
|
|
if (!$this->isChmodReliable()) {
|
|
$this->markTestInComplete('Unit tests runtime directory should be local!');
|
|
}
|
|
|
|
parent::setUp();
|
|
|
|
// destroy application, Helper must work without Yii::$app
|
|
$this->destroyApplication();
|
|
}
|
|
|
|
/**
|
|
* Check if chmod works as expected
|
|
*
|
|
* On remote file systems and vagrant mounts chmod returns true
|
|
* but file permissions are not set properly.
|
|
*/
|
|
private function isChmodReliable()
|
|
{
|
|
$dir = $this->testFilePath . DIRECTORY_SEPARATOR . 'test_chmod';
|
|
mkdir($dir);
|
|
chmod($dir, 0700);
|
|
$mode = $this->getMode($dir);
|
|
rmdir($dir);
|
|
|
|
return $mode === '0700';
|
|
}
|
|
|
|
public function tearDown()
|
|
{
|
|
$this->removeDir($this->testFilePath);
|
|
}
|
|
|
|
/**
|
|
* Creates directory.
|
|
* @param string $dirName directory full name.
|
|
*/
|
|
protected function createDir($dirName)
|
|
{
|
|
if (!file_exists($dirName)) {
|
|
mkdir($dirName, 0777, true);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Removes directory.
|
|
* @param string $dirName directory full name.
|
|
*/
|
|
protected function removeDir($dirName)
|
|
{
|
|
if (!empty($dirName) && is_dir($dirName)) {
|
|
if ($handle = opendir($dirName)) {
|
|
while (false !== ($entry = readdir($handle))) {
|
|
if ($entry !== '.' && $entry !== '..') {
|
|
$item = $dirName . DIRECTORY_SEPARATOR . $entry;
|
|
if (is_dir($item) === true && !is_link($item)) {
|
|
$this->removeDir($item);
|
|
} else {
|
|
unlink($item);
|
|
}
|
|
}
|
|
}
|
|
closedir($handle);
|
|
rmdir($dirName);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Get file permission mode.
|
|
* @param string $file file name.
|
|
* @return string permission mode.
|
|
*/
|
|
protected function getMode($file)
|
|
{
|
|
return substr(sprintf('%o', fileperms($file)), -4);
|
|
}
|
|
|
|
/**
|
|
* Creates test files structure.
|
|
* @param array $items file system objects to be created in format: objectName => objectContent
|
|
* Arrays specifies directories, other values - files.
|
|
* @param string $basePath structure base file path.
|
|
*/
|
|
protected function createFileStructure(array $items, $basePath = '')
|
|
{
|
|
if (empty($basePath)) {
|
|
$basePath = $this->testFilePath;
|
|
}
|
|
foreach ($items as $name => $content) {
|
|
$itemName = $basePath . DIRECTORY_SEPARATOR . $name;
|
|
if (is_array($content)) {
|
|
if (isset($content[0], $content[1]) && $content[0] === 'symlink') {
|
|
symlink($content[1], $itemName);
|
|
} else {
|
|
mkdir($itemName, 0777, true);
|
|
$this->createFileStructure($content, $itemName);
|
|
}
|
|
} else {
|
|
file_put_contents($itemName, $content);
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Asserts that file has specific permission mode.
|
|
* @param int $expectedMode expected file permission mode.
|
|
* @param string $fileName file name.
|
|
* @param string $message error message
|
|
*/
|
|
protected function assertFileMode($expectedMode, $fileName, $message = '')
|
|
{
|
|
$expectedMode = sprintf('%o', $expectedMode);
|
|
$this->assertEquals($expectedMode, $this->getMode($fileName), $message);
|
|
}
|
|
|
|
// Tests :
|
|
|
|
public function testCreateDirectory()
|
|
{
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . 'test_dir_level_1' . DIRECTORY_SEPARATOR . 'test_dir_level_2';
|
|
$this->assertTrue(FileHelper::createDirectory($dirName), 'FileHelper::createDirectory should return true if directory was created!');
|
|
$this->assertFileExists($dirName, 'Unable to create directory recursively!');
|
|
$this->assertTrue(FileHelper::createDirectory($dirName), 'FileHelper::createDirectory should return true for already existing directories!');
|
|
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . 'test_dir_perms';
|
|
$this->assertTrue(FileHelper::createDirectory($dirName, 0700, false));
|
|
$this->assertFileMode(0700, $dirName);
|
|
}
|
|
|
|
/**
|
|
* @depends testCreateDirectory
|
|
*/
|
|
public function testCopyDirectory()
|
|
{
|
|
$srcDirName = 'test_src_dir';
|
|
$files = [
|
|
'file1.txt' => 'file 1 content',
|
|
'file2.txt' => 'file 2 content',
|
|
];
|
|
$this->createFileStructure([
|
|
$srcDirName => $files,
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$srcDirName = $basePath . DIRECTORY_SEPARATOR . $srcDirName;
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_dst_dir';
|
|
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
foreach ($files as $name => $content) {
|
|
$fileName = $dstDirName . DIRECTORY_SEPARATOR . $name;
|
|
$this->assertFileExists($fileName);
|
|
$this->assertStringEqualsFile($fileName, $content, 'Incorrect file content!');
|
|
}
|
|
}
|
|
|
|
public function testCopyDirectoryRecursive()
|
|
{
|
|
$srcDirName = 'test_src_dir_rec';
|
|
$structure = [
|
|
'directory1' => [
|
|
'file1.txt' => 'file 1 content',
|
|
'file2.txt' => 'file 2 content',
|
|
],
|
|
'directory2' => [
|
|
'file3.txt' => 'file 3 content',
|
|
'file4.txt' => 'file 4 content',
|
|
],
|
|
'file5.txt' => 'file 5 content',
|
|
];
|
|
$this->createFileStructure([
|
|
$srcDirName => $structure,
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$srcDirName = $basePath . DIRECTORY_SEPARATOR . $srcDirName;
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_dst_dir';
|
|
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
|
|
$checker = function ($structure, $dstDirName) use (&$checker) {
|
|
foreach ($structure as $name => $content) {
|
|
if (is_array($content)) {
|
|
$checker($content, $dstDirName . DIRECTORY_SEPARATOR . $name);
|
|
} else {
|
|
$fileName = $dstDirName . DIRECTORY_SEPARATOR . $name;
|
|
$this->assertFileExists($fileName);
|
|
$this->assertStringEqualsFile($fileName, $content, 'Incorrect file content!');
|
|
}
|
|
}
|
|
};
|
|
|
|
$checker($structure, $dstDirName);
|
|
}
|
|
|
|
public function testCopyDirectoryNotRecursive()
|
|
{
|
|
$srcDirName = 'test_src_dir_not_rec';
|
|
$structure = [
|
|
'directory1' => [
|
|
'file1.txt' => 'file 1 content',
|
|
'file2.txt' => 'file 2 content',
|
|
],
|
|
'directory2' => [
|
|
'file3.txt' => 'file 3 content',
|
|
'file4.txt' => 'file 4 content',
|
|
],
|
|
'file5.txt' => 'file 5 content',
|
|
];
|
|
$this->createFileStructure([
|
|
$srcDirName => $structure,
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$srcDirName = $basePath . DIRECTORY_SEPARATOR . $srcDirName;
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_dst_dir';
|
|
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName, ['recursive' => false]);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
|
|
foreach ($structure as $name => $content) {
|
|
$fileName = $dstDirName . DIRECTORY_SEPARATOR . $name;
|
|
|
|
if (is_array($content)) {
|
|
$this->assertFileNotExists($fileName);
|
|
} else {
|
|
$this->assertFileExists($fileName);
|
|
$this->assertStringEqualsFile($fileName, $content, 'Incorrect file content!');
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @depends testCopyDirectory
|
|
*/
|
|
public function testCopyDirectoryPermissions()
|
|
{
|
|
if (DIRECTORY_SEPARATOR === '\\') {
|
|
$this->markTestSkipped("Can't reliably test it on Windows because fileperms() always return 0777.");
|
|
}
|
|
|
|
$srcDirName = 'test_src_dir';
|
|
$subDirName = 'test_sub_dir';
|
|
$fileName = 'test_file.txt';
|
|
$this->createFileStructure([
|
|
$srcDirName => [
|
|
$subDirName => [],
|
|
$fileName => 'test file content',
|
|
],
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$srcDirName = $basePath . DIRECTORY_SEPARATOR . $srcDirName;
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_dst_dir';
|
|
|
|
$dirMode = 0755;
|
|
$fileMode = 0755;
|
|
$options = [
|
|
'dirMode' => $dirMode,
|
|
'fileMode' => $fileMode,
|
|
];
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName, $options);
|
|
|
|
$this->assertFileMode($dirMode, $dstDirName, 'Destination directory has wrong mode!');
|
|
$this->assertFileMode($dirMode, $dstDirName . DIRECTORY_SEPARATOR . $subDirName, 'Copied sub directory has wrong mode!');
|
|
$this->assertFileMode($fileMode, $dstDirName . DIRECTORY_SEPARATOR . $fileName, 'Copied file has wrong mode!');
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/10710
|
|
*/
|
|
public function testCopyDirectoryToItself()
|
|
{
|
|
$dirName = 'test_dir';
|
|
|
|
$this->createFileStructure([
|
|
$dirName => [],
|
|
]);
|
|
|
|
$this->expectException('yii\base\InvalidParamException');
|
|
|
|
$dirName = $this->testFilePath . DIRECTORY_SEPARATOR . 'test_dir';
|
|
FileHelper::copyDirectory($dirName, $dirName);
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/10710
|
|
*/
|
|
public function testCopyDirToSubdirOfItself()
|
|
{
|
|
$this->createFileStructure([
|
|
'data' => [],
|
|
'backup' => ['data' => []],
|
|
]);
|
|
|
|
$this->expectException('yii\base\InvalidParamException');
|
|
|
|
FileHelper::copyDirectory(
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'backup',
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'backup' . DIRECTORY_SEPARATOR . 'data'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/10710
|
|
*/
|
|
public function testCopyDirToAnotherWithSameName()
|
|
{
|
|
$this->createFileStructure([
|
|
'data' => [],
|
|
'backup' => ['data' => []],
|
|
]);
|
|
|
|
FileHelper::copyDirectory(
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'data',
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'backup' . DIRECTORY_SEPARATOR . 'data'
|
|
);
|
|
$this->assertFileExists($this->testFilePath . DIRECTORY_SEPARATOR . 'backup' . DIRECTORY_SEPARATOR . 'data');
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/10710
|
|
*/
|
|
public function testCopyDirWithSameName()
|
|
{
|
|
$this->createFileStructure([
|
|
'data' => [],
|
|
'data-backup' => [],
|
|
]);
|
|
|
|
FileHelper::copyDirectory(
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'data',
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'data-backup'
|
|
);
|
|
}
|
|
|
|
public function testRemoveDirectory()
|
|
{
|
|
$dirName = 'test_dir_for_remove';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'file1.txt' => 'file 1 content',
|
|
'file2.txt' => 'file 2 content',
|
|
'test_sub_dir' => [
|
|
'sub_dir_file_1.txt' => 'sub dir file 1 content',
|
|
'sub_dir_file_2.txt' => 'sub dir file 2 content',
|
|
],
|
|
],
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . $dirName;
|
|
|
|
FileHelper::removeDirectory($dirName);
|
|
|
|
$this->assertFileNotExists($dirName, 'Unable to remove directory!');
|
|
|
|
// should be silent about non-existing directories
|
|
FileHelper::removeDirectory($basePath . DIRECTORY_SEPARATOR . 'nonExisting');
|
|
}
|
|
|
|
public function testRemoveDirectorySymlinks1()
|
|
{
|
|
if (DIRECTORY_SEPARATOR === '\\') {
|
|
$this->markTestSkipped('Cannot test this on MS Windows since symlinks are uncommon for it.');
|
|
}
|
|
|
|
$dirName = 'remove-directory-symlinks-1';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'file' => 'Symlinked file.',
|
|
'directory' => [
|
|
'standard-file-1' => 'Standard file 1.',
|
|
],
|
|
'symlinks' => [
|
|
'standard-file-2' => 'Standard file 2.',
|
|
'symlinked-file' => ['symlink', '..' . DIRECTORY_SEPARATOR . 'file'],
|
|
'symlinked-directory' => ['symlink', '..' . DIRECTORY_SEPARATOR . 'directory'],
|
|
],
|
|
],
|
|
]);
|
|
|
|
$basePath = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName . DIRECTORY_SEPARATOR;
|
|
$this->assertFileExists($basePath . 'file');
|
|
$this->assertTrue(is_dir($basePath . 'directory'));
|
|
$this->assertFileExists($basePath . 'directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
$this->assertTrue(is_dir($basePath . 'symlinks'));
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
|
|
$this->assertTrue(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
|
|
FileHelper::removeDirectory($basePath . 'symlinks');
|
|
|
|
$this->assertFileExists($basePath . 'file');
|
|
$this->assertTrue(is_dir($basePath . 'directory'));
|
|
$this->assertFileExists($basePath . 'directory' . DIRECTORY_SEPARATOR . 'standard-file-1'); // symlinked directory still have it's file
|
|
$this->assertFalse(is_dir($basePath . 'symlinks'));
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
|
|
$this->assertFalse(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
}
|
|
|
|
public function testRemoveDirectorySymlinks2()
|
|
{
|
|
if (DIRECTORY_SEPARATOR === '\\') {
|
|
$this->markTestSkipped('Cannot test this on MS Windows since symlinks are uncommon for it.');
|
|
}
|
|
|
|
$dirName = 'remove-directory-symlinks-2';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'file' => 'Symlinked file.',
|
|
'directory' => [
|
|
'standard-file-1' => 'Standard file 1.',
|
|
],
|
|
'symlinks' => [
|
|
'standard-file-2' => 'Standard file 2.',
|
|
'symlinked-file' => ['symlink', '..' . DIRECTORY_SEPARATOR . 'file'],
|
|
'symlinked-directory' => ['symlink', '..' . DIRECTORY_SEPARATOR . 'directory'],
|
|
],
|
|
],
|
|
]);
|
|
|
|
$basePath = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName . DIRECTORY_SEPARATOR;
|
|
$this->assertFileExists($basePath . 'file');
|
|
$this->assertTrue(is_dir($basePath . 'directory'));
|
|
$this->assertFileExists($basePath . 'directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
$this->assertTrue(is_dir($basePath . 'symlinks'));
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
|
|
$this->assertTrue(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
|
|
$this->assertFileExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
|
|
FileHelper::removeDirectory($basePath . 'symlinks', ['traverseSymlinks' => true]);
|
|
|
|
$this->assertFileExists($basePath . 'file');
|
|
$this->assertTrue(is_dir($basePath . 'directory'));
|
|
$this->assertFileNotExists($basePath . 'directory' . DIRECTORY_SEPARATOR . 'standard-file-1'); // symlinked directory doesn't have it's file now
|
|
$this->assertFalse(is_dir($basePath . 'symlinks'));
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
|
|
$this->assertFalse(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
|
|
$this->assertFileNotExists($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
|
|
}
|
|
|
|
public function testFindFiles()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'file_1.txt' => 'file 1 content',
|
|
'file_2.txt' => 'file 2 content',
|
|
'test_sub_dir' => [
|
|
'file_1_1.txt' => 'sub dir file 1 content',
|
|
'file_1_2.txt' => 'sub dir file 2 content',
|
|
],
|
|
],
|
|
]);
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . $dirName;
|
|
$expectedFiles = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'file_1.txt',
|
|
$dirName . DIRECTORY_SEPARATOR . 'file_2.txt',
|
|
$dirName . DIRECTORY_SEPARATOR . 'test_sub_dir' . DIRECTORY_SEPARATOR . 'file_1_1.txt',
|
|
$dirName . DIRECTORY_SEPARATOR . 'test_sub_dir' . DIRECTORY_SEPARATOR . 'file_1_2.txt',
|
|
];
|
|
|
|
$foundFiles = FileHelper::findFiles($dirName);
|
|
sort($expectedFiles);
|
|
sort($foundFiles);
|
|
$this->assertEquals($expectedFiles, $foundFiles);
|
|
}
|
|
|
|
/**
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testFindFileFilter()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$passedFileName = 'passed.txt';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
$passedFileName => 'passed file content',
|
|
'declined.txt' => 'declined file content',
|
|
],
|
|
]);
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . $dirName;
|
|
|
|
$options = [
|
|
'filter' => function ($path) use ($passedFileName) {
|
|
return $passedFileName == basename($path);
|
|
},
|
|
];
|
|
$foundFiles = FileHelper::findFiles($dirName, $options);
|
|
$this->assertEquals([$dirName . DIRECTORY_SEPARATOR . $passedFileName], $foundFiles);
|
|
}
|
|
|
|
/**
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testFindFilesRecursiveWithSymLink()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'theDir' => [
|
|
'file1' => 'abc',
|
|
'file2' => 'def',
|
|
],
|
|
'symDir' => ['symlink', 'theDir'],
|
|
],
|
|
]);
|
|
$dirName = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName;
|
|
|
|
$expected = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'symDir' . DIRECTORY_SEPARATOR . 'file1',
|
|
$dirName . DIRECTORY_SEPARATOR . 'symDir' . DIRECTORY_SEPARATOR . 'file2',
|
|
$dirName . DIRECTORY_SEPARATOR . 'theDir' . DIRECTORY_SEPARATOR . 'file1',
|
|
$dirName . DIRECTORY_SEPARATOR . 'theDir' . DIRECTORY_SEPARATOR . 'file2',
|
|
];
|
|
$result = FileHelper::findFiles($dirName);
|
|
sort($result);
|
|
$this->assertEquals($expected, $result);
|
|
}
|
|
|
|
/**
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testFindFilesNotRecursive()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'theDir' => [
|
|
'file1' => 'abc',
|
|
'file2' => 'def',
|
|
],
|
|
'symDir' => ['symlink', 'theDir'],
|
|
'file3' => 'root',
|
|
],
|
|
]);
|
|
$dirName = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName;
|
|
|
|
$expected = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'file3',
|
|
];
|
|
$this->assertEquals($expected, FileHelper::findFiles($dirName, ['recursive' => false]));
|
|
}
|
|
|
|
/**
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testFindFilesExclude()
|
|
{
|
|
$basePath = $this->testFilePath . DIRECTORY_SEPARATOR;
|
|
$dirs = ['', 'one', 'one' . DIRECTORY_SEPARATOR . 'two', 'three'];
|
|
$files = array_fill_keys(array_map(function ($n) {
|
|
return "a.$n";
|
|
}, range(1, 8)), 'file contents');
|
|
|
|
$tree = $files;
|
|
$root = $files;
|
|
$flat = [];
|
|
foreach ($dirs as $dir) {
|
|
foreach ($files as $fileName => $contents) {
|
|
$flat[] = rtrim($basePath . $dir, DIRECTORY_SEPARATOR) . DIRECTORY_SEPARATOR . $fileName;
|
|
}
|
|
if ($dir === '') {
|
|
continue;
|
|
}
|
|
$parts = explode(DIRECTORY_SEPARATOR, $dir);
|
|
$last = array_pop($parts);
|
|
$parent = array_pop($parts);
|
|
$tree[$last] = $files;
|
|
if ($parent !== null) {
|
|
$tree[$parent][$last] = &$tree[$last];
|
|
} else {
|
|
$root[$last] = &$tree[$last];
|
|
}
|
|
}
|
|
$this->createFileStructure($root);
|
|
|
|
// range
|
|
$foundFiles = FileHelper::findFiles($basePath, ['except' => ['a.[2-8]']]);
|
|
sort($foundFiles);
|
|
$expect = array_values(array_filter($flat, function ($p) {
|
|
return substr($p, -3) === 'a.1';
|
|
}));
|
|
$this->assertEquals($expect, $foundFiles);
|
|
|
|
// suffix
|
|
$foundFiles = FileHelper::findFiles($basePath, ['except' => ['*.1']]);
|
|
sort($foundFiles);
|
|
$expect = array_values(array_filter($flat, function ($p) {
|
|
return substr($p, -3) !== 'a.1';
|
|
}));
|
|
$this->assertEquals($expect, $foundFiles);
|
|
|
|
// dir
|
|
$foundFiles = FileHelper::findFiles($basePath, ['except' => ['/one']]);
|
|
sort($foundFiles);
|
|
$expect = array_values(array_filter($flat, function ($p) {
|
|
return strpos($p, DIRECTORY_SEPARATOR . 'one') === false;
|
|
}));
|
|
$this->assertEquals($expect, $foundFiles);
|
|
|
|
// dir contents
|
|
$foundFiles = FileHelper::findFiles($basePath, ['except' => ['?*/a.1']]);
|
|
sort($foundFiles);
|
|
$expect = array_values(array_filter($flat, function ($p) {
|
|
return substr($p, -11, 10) === 'one' . DIRECTORY_SEPARATOR . 'two' . DIRECTORY_SEPARATOR . 'a.' || (
|
|
substr($p, -8) !== DIRECTORY_SEPARATOR . 'one' . DIRECTORY_SEPARATOR . 'a.1' &&
|
|
substr($p, -10) !== DIRECTORY_SEPARATOR . 'three' . DIRECTORY_SEPARATOR . 'a.1'
|
|
);
|
|
}));
|
|
$this->assertEquals($expect, $foundFiles);
|
|
|
|
// negative pattern
|
|
$foundFiles = FileHelper::findFiles($basePath, ['except' => ['/one/*', '!/one/two']]);
|
|
sort($foundFiles);
|
|
$expect = array_values(array_filter($flat, function ($p) {
|
|
return strpos($p, DIRECTORY_SEPARATOR . 'one') === false || strpos($p, DIRECTORY_SEPARATOR . 'two') !== false;
|
|
}));
|
|
|
|
$this->assertEquals($expect, $foundFiles);
|
|
}
|
|
|
|
/**
|
|
* @depends testFindFilesExclude
|
|
*/
|
|
public function testFindFilesCaseSensitive()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'lower.txt' => 'lower case filename',
|
|
'upper.TXT' => 'upper case filename',
|
|
],
|
|
]);
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . $dirName;
|
|
|
|
$options = [
|
|
'except' => ['*.txt'],
|
|
'caseSensitive' => false,
|
|
];
|
|
$foundFiles = FileHelper::findFiles($dirName, $options);
|
|
$this->assertCount(0, $foundFiles);
|
|
|
|
$options = [
|
|
'only' => ['*.txt'],
|
|
'caseSensitive' => false,
|
|
];
|
|
$foundFiles = FileHelper::findFiles($dirName, $options);
|
|
$this->assertCount(2, $foundFiles);
|
|
}
|
|
|
|
public function testGetMimeTypeByExtension()
|
|
{
|
|
$magicFile = $this->testFilePath . DIRECTORY_SEPARATOR . 'mime_type.php';
|
|
$mimeTypeMap = [
|
|
'txa' => 'application/json',
|
|
'txb' => 'another/mime',
|
|
];
|
|
$magicFileContent = '<?php return ' . var_export($mimeTypeMap, true) . ';';
|
|
file_put_contents($magicFile, $magicFileContent);
|
|
|
|
foreach ($mimeTypeMap as $extension => $mimeType) {
|
|
$fileName = 'test.' . $extension;
|
|
$this->assertNull(FileHelper::getMimeTypeByExtension($fileName));
|
|
$this->assertEquals($mimeType, FileHelper::getMimeTypeByExtension($fileName, $magicFile));
|
|
}
|
|
}
|
|
|
|
public function testGetMimeType()
|
|
{
|
|
$file = $this->testFilePath . DIRECTORY_SEPARATOR . 'mime_type_test.txt';
|
|
file_put_contents($file, 'some text');
|
|
$this->assertEquals('text/plain', FileHelper::getMimeType($file));
|
|
|
|
// see https://stackoverflow.com/questions/477816/what-is-the-correct-json-content-type
|
|
// JSON/JSONP should not use text/plain - see http://jibbering.com/blog/?p=514
|
|
// with "fileinfo" extension enabled, returned MIME is not quite correctly "text/plain"
|
|
// without "fileinfo" it falls back to getMimeTypeByExtension() and returns application/json
|
|
$file = $this->testFilePath . DIRECTORY_SEPARATOR . 'mime_type_test.json';
|
|
file_put_contents($file, '{"a": "b"}');
|
|
$this->assertTrue(in_array(FileHelper::getMimeType($file), ['application/json', 'text/plain']));
|
|
}
|
|
|
|
public function testGetUploadedImageMimeTypes()
|
|
{
|
|
$ds = DIRECTORY_SEPARATOR;
|
|
$phpunitPath = Yii::getAlias('@yiiunit');
|
|
$runtimeLocation = Yii::getAlias('@yiiunit/runtime');
|
|
$resourceSourceLocation = "{$phpunitPath}{$ds}framework{$ds}validators{$ds}data{$ds}mimeType";
|
|
|
|
$pngFile = "{$runtimeLocation}{$ds}php1234";
|
|
copy("{$resourceSourceLocation}{$ds}test.png", $pngFile);
|
|
|
|
$this->assertEquals('image/png', FileHelper::getMimeType($pngFile));
|
|
|
|
$jpgFile = "{$runtimeLocation}{$ds}php4567";
|
|
copy("{$resourceSourceLocation}{$ds}test.jpg", $jpgFile);
|
|
|
|
$this->assertEquals('image/jpeg', FileHelper::getMimeType($jpgFile));
|
|
}
|
|
|
|
public function testNormalizePath()
|
|
{
|
|
$ds = DIRECTORY_SEPARATOR;
|
|
$this->assertEquals("{$ds}a{$ds}b", FileHelper::normalizePath('//a\b/'));
|
|
$this->assertEquals("{$ds}b{$ds}c", FileHelper::normalizePath('/a/../b/c'));
|
|
$this->assertEquals("{$ds}c", FileHelper::normalizePath('/a\\b/../..///c'));
|
|
$this->assertEquals("{$ds}c", FileHelper::normalizePath('/a/.\\b//../../c'));
|
|
$this->assertEquals('c', FileHelper::normalizePath('/a/.\\b/../..//../c'));
|
|
$this->assertEquals("..{$ds}c", FileHelper::normalizePath('//a/.\\b//..//..//../../c'));
|
|
|
|
// relative paths
|
|
$this->assertEquals('.', FileHelper::normalizePath('.'));
|
|
$this->assertEquals('.', FileHelper::normalizePath('./'));
|
|
$this->assertEquals('a', FileHelper::normalizePath('.\\a'));
|
|
$this->assertEquals("a{$ds}b", FileHelper::normalizePath('./a\\b'));
|
|
$this->assertEquals('.', FileHelper::normalizePath('./a\\../'));
|
|
$this->assertEquals("..{$ds}..{$ds}a", FileHelper::normalizePath('../..\\a'));
|
|
$this->assertEquals("..{$ds}..{$ds}a", FileHelper::normalizePath('../..\\a/../a'));
|
|
$this->assertEquals("..{$ds}..{$ds}b", FileHelper::normalizePath('../..\\a/../b'));
|
|
$this->assertEquals("..{$ds}a", FileHelper::normalizePath('./..\\a'));
|
|
$this->assertEquals("..{$ds}a", FileHelper::normalizePath('././..\\a'));
|
|
$this->assertEquals("..{$ds}a", FileHelper::normalizePath('./..\\a/../a'));
|
|
$this->assertEquals("..{$ds}b", FileHelper::normalizePath('./..\\a/../b'));
|
|
|
|
// Windows file system may have paths for network shares that start with two backslashes
|
|
// https://msdn.microsoft.com/en-us/library/windows/desktop/aa365247%28v=vs.85%29.aspx
|
|
// https://github.com/yiisoft/yii2/issues/13034
|
|
$this->assertEquals('\\\\server\share\path\file', FileHelper::normalizePath('\\\\server\share\path\file', '\\'));
|
|
|
|
// Stream Wrappers should not have the double slashes stripped
|
|
// https://github.com/yiisoft/yii2/issues/17235
|
|
$this->assertEquals('ftp://192.168.1.100/test', FileHelper::normalizePath('ftp://192.168.1.100/test/'));
|
|
}
|
|
|
|
public function testLocalizedDirectory()
|
|
{
|
|
$this->createFileStructure([
|
|
'views' => [
|
|
'faq.php' => 'English FAQ',
|
|
'de-DE' => [
|
|
'faq.php' => 'German FAQ',
|
|
],
|
|
],
|
|
]);
|
|
$viewFile = $this->testFilePath . DIRECTORY_SEPARATOR . 'views' . DIRECTORY_SEPARATOR . 'faq.php';
|
|
$sourceLanguage = 'en-US';
|
|
|
|
// Source language and target language are same. The view path should be unchanged.
|
|
$currentLanguage = $sourceLanguage;
|
|
$this->assertSame($viewFile, FileHelper::localize($viewFile, $currentLanguage, $sourceLanguage));
|
|
|
|
// Source language and target language are different. The view path should be changed.
|
|
$currentLanguage = 'de-DE';
|
|
$this->assertSame(
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . 'views' . DIRECTORY_SEPARATOR . $currentLanguage . DIRECTORY_SEPARATOR . 'faq.php',
|
|
FileHelper::localize($viewFile, $currentLanguage, $sourceLanguage)
|
|
);
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/3393
|
|
*
|
|
* @depends testCopyDirectory
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testCopyDirectoryExclude()
|
|
{
|
|
$srcDirName = 'test_src_dir';
|
|
$textFiles = [
|
|
'file1.txt' => 'text file 1 content',
|
|
'file2.txt' => 'text file 2 content',
|
|
];
|
|
$dataFiles = [
|
|
'file1.dat' => 'data file 1 content',
|
|
'file2.dat' => 'data file 2 content',
|
|
];
|
|
$this->createFileStructure([
|
|
$srcDirName => array_merge($textFiles, $dataFiles),
|
|
]);
|
|
|
|
$basePath = $this->testFilePath;
|
|
$srcDirName = $basePath . DIRECTORY_SEPARATOR . $srcDirName;
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_dst_dir';
|
|
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName, ['only' => ['*.dat']]);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
$copiedFiles = FileHelper::findFiles($dstDirName);
|
|
$this->assertCount(2, $copiedFiles, 'wrong files count copied');
|
|
|
|
foreach ($dataFiles as $name => $content) {
|
|
$fileName = $dstDirName . DIRECTORY_SEPARATOR . $name;
|
|
$this->assertFileExists($fileName);
|
|
$this->assertStringEqualsFile($fileName, $content, 'Incorrect file content!');
|
|
}
|
|
}
|
|
|
|
private function setupCopyEmptyDirectoriesTest()
|
|
{
|
|
$srcDirName = 'test_empty_src_dir';
|
|
$this->createFileStructure([
|
|
$srcDirName => [
|
|
'dir1' => [
|
|
'file1.txt' => 'file1',
|
|
'file2.txt' => 'file2',
|
|
],
|
|
'dir2' => [
|
|
'file1.log' => 'file1',
|
|
'file2.log' => 'file2',
|
|
],
|
|
'dir3' => [],
|
|
],
|
|
]);
|
|
|
|
return [
|
|
$this->testFilePath, // basePath
|
|
$this->testFilePath . DIRECTORY_SEPARATOR . $srcDirName,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/9669
|
|
*
|
|
* @depends testCopyDirectory
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testCopyDirectoryEmptyDirectories()
|
|
{
|
|
list($basePath, $srcDirName) = $this->setupCopyEmptyDirectoriesTest();
|
|
|
|
// copy with empty directories
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_empty_dst_dir';
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName, ['only' => ['*.txt'], 'copyEmptyDirectories' => true]);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
$copiedFiles = FileHelper::findFiles($dstDirName);
|
|
$this->assertCount(2, $copiedFiles, 'wrong files count copied');
|
|
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1' . DIRECTORY_SEPARATOR . 'file1.txt');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1' . DIRECTORY_SEPARATOR . 'file2.txt');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir2');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir3');
|
|
}
|
|
|
|
/**
|
|
* @see https://github.com/yiisoft/yii2/issues/9669
|
|
*
|
|
* @depends testCopyDirectory
|
|
* @depends testFindFiles
|
|
*/
|
|
public function testCopyDirectoryNoEmptyDirectories()
|
|
{
|
|
list($basePath, $srcDirName) = $this->setupCopyEmptyDirectoriesTest();
|
|
|
|
// copy without empty directories
|
|
$dstDirName = $basePath . DIRECTORY_SEPARATOR . 'test_empty_dst_dir2';
|
|
FileHelper::copyDirectory($srcDirName, $dstDirName, ['only' => ['*.txt'], 'copyEmptyDirectories' => false]);
|
|
|
|
$this->assertFileExists($dstDirName, 'Destination directory does not exist!');
|
|
$copiedFiles = FileHelper::findFiles($dstDirName);
|
|
$this->assertCount(2, $copiedFiles, 'wrong files count copied');
|
|
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1' . DIRECTORY_SEPARATOR . 'file1.txt');
|
|
$this->assertFileExists($dstDirName . DIRECTORY_SEPARATOR . 'dir1' . DIRECTORY_SEPARATOR . 'file2.txt');
|
|
$this->assertFileNotExists($dstDirName . DIRECTORY_SEPARATOR . 'dir2');
|
|
$this->assertFileNotExists($dstDirName . DIRECTORY_SEPARATOR . 'dir3');
|
|
}
|
|
|
|
public function testFindDirectories()
|
|
{
|
|
$dirName = 'test_dir';
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
'test_sub_dir' => [
|
|
'file_1.txt' => 'sub dir file 1 content',
|
|
],
|
|
'second_sub_dir' => [
|
|
'file_1.txt' => 'sub dir file 2 content',
|
|
],
|
|
],
|
|
]);
|
|
$basePath = $this->testFilePath;
|
|
$dirName = $basePath . DIRECTORY_SEPARATOR . $dirName;
|
|
$expectedFiles = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'test_sub_dir',
|
|
$dirName . DIRECTORY_SEPARATOR . 'second_sub_dir'
|
|
];
|
|
|
|
$foundFiles = FileHelper::findDirectories($dirName);
|
|
sort($expectedFiles);
|
|
sort($foundFiles);
|
|
$this->assertEquals($expectedFiles, $foundFiles);
|
|
|
|
// filter
|
|
$expectedFiles = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'second_sub_dir'
|
|
];
|
|
$options = [
|
|
'filter' => function ($path) {
|
|
return 'second_sub_dir' === basename($path);
|
|
},
|
|
];
|
|
$foundFiles = FileHelper::findDirectories($dirName, $options);
|
|
sort($expectedFiles);
|
|
sort($foundFiles);
|
|
$this->assertEquals($expectedFiles, $foundFiles);
|
|
|
|
// except
|
|
$expectedFiles = [
|
|
$dirName . DIRECTORY_SEPARATOR . 'second_sub_dir'
|
|
];
|
|
$options = [
|
|
'except' => ['test_sub_dir'],
|
|
];
|
|
$foundFiles = FileHelper::findDirectories($dirName, $options);
|
|
sort($expectedFiles);
|
|
sort($foundFiles);
|
|
$this->assertEquals($expectedFiles, $foundFiles);
|
|
}
|
|
|
|
public function testChangeOwnership()
|
|
{
|
|
if (DIRECTORY_SEPARATOR !== '/') {
|
|
$this->markTestSkipped('FileHelper::changeOwnership() fails silently on Windows, nothing to test.');
|
|
}
|
|
|
|
if (!extension_loaded('posix')) {
|
|
$this->markTestSkipped('posix extension is required.');
|
|
}
|
|
|
|
$dirName = 'change_ownership_test_dir';
|
|
$fileName = 'file_1.txt';
|
|
$testFile = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName . DIRECTORY_SEPARATOR . $fileName;
|
|
|
|
$currentUserId = posix_getuid();
|
|
$currentUserName = posix_getpwuid($currentUserId)['name'];
|
|
$currentGroupId = posix_getgid();
|
|
$currentGroupName = posix_getgrgid($currentGroupId)['name'];
|
|
|
|
/////////////
|
|
/// Setup ///
|
|
/////////////
|
|
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
$fileName => 'test 1',
|
|
],
|
|
]);
|
|
|
|
// Ensure the test file is created as the current user/group and has a specific file mode
|
|
$this->assertFileExists($testFile);
|
|
$fileMode = 0770;
|
|
@chmod($testFile, $fileMode);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected created test file owner to be current user.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected created test file group to be current group.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be changed.');
|
|
|
|
|
|
/////////////////
|
|
/// File Mode ///
|
|
/////////////////
|
|
|
|
// Test file mode
|
|
$fileMode = 0777;
|
|
FileHelper::changeOwnership($testFile, null, $fileMode);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be changed.');
|
|
|
|
if ($currentUserId !== 0) {
|
|
$this->markTestInComplete(__METHOD__ . ' could only run partially, chown() can only to be tested as root user. Current user: ' . $currentUserName);
|
|
}
|
|
|
|
//////////////////////
|
|
/// User Ownership ///
|
|
//////////////////////
|
|
|
|
// Test user ownership as integer
|
|
$ownership = 10001;
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership, fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as numeric string (should be treated as integer)
|
|
$ownership = '10002';
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)$ownership, fileowner($testFile), 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as string
|
|
$ownership = $currentUserName;
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership, posix_getpwuid(fileowner($testFile))['name'], 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as numeric string with trailing colon (should be treated as integer)
|
|
$ownership = '10003:';
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)$ownership, fileowner($testFile), 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as string with trailing colon
|
|
$ownership = $currentUserName . ':';
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals(substr($ownership, 0, -1), posix_getpwuid(fileowner($testFile))['name'], 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as indexed array (integer value)
|
|
$ownership = [10004];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership[0], fileowner($testFile), 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as indexed array (numeric string value)
|
|
$ownership = ['10005'];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)$ownership[0], fileowner($testFile), 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user ownership as associative array (string value)
|
|
$ownership = ['user' => $currentUserName];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership['user'], posix_getpwuid(fileowner($testFile))['name'], 'Expected created test file owner to be changed.');
|
|
$this->assertEquals($currentGroupId, filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
///////////////////////
|
|
/// Group Ownership ///
|
|
///////////////////////
|
|
|
|
// Test group ownership as numeric string
|
|
$ownership = ':10006';
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals((int)substr($ownership, 1), filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test group ownership as string
|
|
$ownership = ':' . $currentGroupName;
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals(substr($ownership, 1), posix_getgrgid(filegroup($testFile))['name'], 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test group ownership as associative array (integer value)
|
|
$ownership = ['group' => 10007];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals($ownership['group'], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test group ownership as associative array (numeric string value)
|
|
$ownership = ['group' => '10008'];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals((int)$ownership['group'], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test group ownership as associative array (string value)
|
|
$ownership = ['group' => $currentGroupName];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($currentUserId, fileowner($testFile), 'Expected file owner to be unchanged.');
|
|
$this->assertEquals($ownership['group'], posix_getgrgid(filegroup($testFile))['name'], 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
/////////////////////////////////
|
|
/// User- and Group Ownership ///
|
|
/////////////////////////////////
|
|
|
|
// Test user and group ownership as numeric string
|
|
$ownership = '10009:10010';
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)explode(':', $ownership)[0], fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals((int)explode(':', $ownership)[1], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as string
|
|
$ownership = $currentUserName . ':' . $currentGroupName;
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals(explode(':', $ownership)[0], posix_getpwuid(fileowner($testFile))['name'], 'Expected file owner to be changed.');
|
|
$this->assertEquals(explode(':', $ownership)[1], posix_getgrgid(filegroup($testFile))['name'], 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as indexed array (integer values)
|
|
$ownership = [10011, 10012];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership[0], fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals($ownership[1], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as indexed array (numeric string values)
|
|
$ownership = ['10013', '10014'];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)$ownership[0], fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals((int)$ownership[1], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as indexed array (string values)
|
|
$ownership = [$currentUserName, $currentGroupName];
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership[0], posix_getpwuid(fileowner($testFile))['name'], 'Expected file owner to be changed.');
|
|
$this->assertEquals($ownership[1], posix_getgrgid(filegroup($testFile))['name'], 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as associative array (integer values)
|
|
$ownership = ['group' => 10015, 'user' => 10016]; // user/group reversed on purpose
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership['user'], fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals($ownership['group'], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as associative array (numeric string values)
|
|
$ownership = ['group' => '10017', 'user' => '10018']; // user/group reversed on purpose
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals((int)$ownership['user'], fileowner($testFile), 'Expected file owner to be changed.');
|
|
$this->assertEquals((int)$ownership['group'], filegroup($testFile), 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
// Test user and group ownership as associative array (string values)
|
|
$ownership = ['group' => $currentGroupName, 'user' => $currentUserName]; // user/group reversed on purpose
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals($ownership['user'], posix_getpwuid(fileowner($testFile))['name'], 'Expected file owner to be changed.');
|
|
$this->assertEquals($ownership['group'], posix_getgrgid(filegroup($testFile))['name'], 'Expected created test file group to be changed.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected file mode to be unchanged.');
|
|
|
|
///////////////////////////////////////
|
|
/// Mode, User- and Group Ownership ///
|
|
///////////////////////////////////////
|
|
|
|
// Test user ownership as integer with file mode
|
|
$ownership = '10019:10020';
|
|
$fileMode = 0774;
|
|
FileHelper::changeOwnership($testFile, $ownership, $fileMode);
|
|
clearstatcache(true, $testFile);
|
|
$this->assertEquals(explode(':', $ownership)[0], fileowner($testFile), 'Expected created test file owner to be changed.');
|
|
$this->assertEquals(explode(':', $ownership)[1], filegroup($testFile), 'Expected file group to be unchanged.');
|
|
$this->assertEquals('0'.decoct($fileMode), substr(decoct(fileperms($testFile)), -4), 'Expected created test file mode to be changed.');
|
|
|
|
}
|
|
|
|
public function testChangeOwnershipNonExistingUser()
|
|
{
|
|
$dirName = 'change_ownership_non_existing_user';
|
|
$fileName = 'file_1.txt';
|
|
$testFile = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName . DIRECTORY_SEPARATOR . $fileName;
|
|
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
$fileName => 'test 1',
|
|
],
|
|
]);
|
|
|
|
// Test user ownership as integer with file mode (Due to the nature of chown we can't use PHPUnit's `expectException`)
|
|
$ownership = 'non_existing_user';
|
|
try {
|
|
FileHelper::changeOwnership($testFile, $ownership);
|
|
throw new \Exception('FileHelper::changeOwnership() should have thrown error for non existing user.');
|
|
} catch(\Exception $e) {
|
|
$this->assertEquals('chown(): Unable to find uid for non_existing_user', $e->getMessage());
|
|
}
|
|
}
|
|
|
|
/**
|
|
* @dataProvider changeOwnershipInvalidArgumentsProvider
|
|
* @param bool $useFile
|
|
* @param mixed $ownership
|
|
* @param mixed $mode
|
|
*/
|
|
public function testChangeOwnershipInvalidArguments($useFile, $ownership, $mode)
|
|
{
|
|
$dirName = 'change_ownership_invalid_arguments';
|
|
$fileName = 'file_1.txt';
|
|
$file = $this->testFilePath . DIRECTORY_SEPARATOR . $dirName . DIRECTORY_SEPARATOR . $fileName;
|
|
|
|
$this->createFileStructure([
|
|
$dirName => [
|
|
$fileName => 'test 1',
|
|
],
|
|
]);
|
|
|
|
$this->expectException('yii\base\InvalidArgumentException');
|
|
FileHelper::changeOwnership($useFile ? $file : null, $ownership, $mode);
|
|
}
|
|
|
|
public function changeOwnershipInvalidArgumentsProvider()
|
|
{
|
|
return [
|
|
[false, '123:123', null],
|
|
[true, new stdClass(), null],
|
|
[true, ['user' => new stdClass()], null],
|
|
[true, ['group' => new stdClass()], null],
|
|
[true, null, 'test'],
|
|
];
|
|
}
|
|
}
|