<?php

/**
 * @link https://www.yiiframework.com/
 * @copyright Copyright (c) 2008 Yii Software LLC
 * @license https://www.yiiframework.com/license/
 */

namespace yiiunit\framework\helpers;

use Exception;
use stdClass;
use Yii;
use yii\helpers\FileHelper;
use yiiunit\TestCase;

/**
 * Unit test for [[yii\helpers\FileHelper]].
 * @see FileHelper
 * @group helpers
 */
class FileHelperTest extends TestCase
{
    /**
     * @var string test files path.
     */
    private string $testFilePath = '';

    protected function setUp(): void
    {
        $this->testFilePath = Yii::getAlias('@yiiunit/runtime') . DIRECTORY_SEPARATOR . str_replace('\\', '_', get_class($this)) . uniqid();
        $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';
    }

    protected function tearDown(): void
    {
        $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('%04o', $expectedMode);
        $this->assertEquals($expectedMode, $this->getMode($fileName), $message);
    }

    // Tests :

    public function testCreateDirectory(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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): void {
            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(): void
    {
        $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->assertFileDoesNotExist($fileName);
            } else {
                $this->assertFileExists($fileName);
                $this->assertStringEqualsFile($fileName, $content, 'Incorrect file content!');
            }
        }
    }

    /**
     * @depends testCopyDirectory
     */
    public function testCopyDirectoryPermissions(): void
    {
        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(): void
    {
        $dirName = 'test_dir';

        $this->createFileStructure([
            $dirName => [],
        ]);

        $this->expectException(\yii\base\InvalidArgumentException::class);

        $dirName = $this->testFilePath . DIRECTORY_SEPARATOR . 'test_dir';
        FileHelper::copyDirectory($dirName, $dirName);
    }

    /**
     * @see https://github.com/yiisoft/yii2/issues/10710
     */
    public function testCopyDirToSubdirOfItself(): void
    {
        $this->createFileStructure([
            'data' => [],
            'backup' => ['data' => []],
        ]);

        $this->expectException(\yii\base\InvalidArgumentException::class);

        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(): void
    {
        $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(): void
    {
        $this->createFileStructure([
            'data' => [],
            'data-backup' => [],
        ]);

        FileHelper::copyDirectory(
            $this->testFilePath . DIRECTORY_SEPARATOR . 'data',
            $this->testFilePath . DIRECTORY_SEPARATOR . 'data-backup'
        );

        $this->assertTrue(true);
    }

    public function testRemoveDirectory(): void
    {
        $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->assertFileDoesNotExist($dirName, 'Unable to remove directory!');

        // should be silent about non-existing directories
        FileHelper::removeDirectory($basePath . DIRECTORY_SEPARATOR . 'nonExisting');
    }

    public function testRemoveDirectorySymlinks1(): void
    {
        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->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
        $this->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
        $this->assertFalse(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
        $this->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
    }

    public function testRemoveDirectorySymlinks2(): void
    {
        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->assertFileDoesNotExist($basePath . 'directory' . DIRECTORY_SEPARATOR . 'standard-file-1'); // symlinked directory doesn't have it's file now
        $this->assertFalse(is_dir($basePath . 'symlinks'));
        $this->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'standard-file-2');
        $this->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-file');
        $this->assertFalse(is_dir($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory'));
        $this->assertFileDoesNotExist($basePath . 'symlinks' . DIRECTORY_SEPARATOR . 'symlinked-directory' . DIRECTORY_SEPARATOR . 'standard-file-1');
    }

    public function testFindFiles(): void
    {
        $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(): void
    {
        $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' => fn($path) => $passedFileName == basename((string) $path),
        ];
        $foundFiles = FileHelper::findFiles($dirName, $options);
        $this->assertEquals([$dirName . DIRECTORY_SEPARATOR . $passedFileName], $foundFiles);
    }

    /**
     * @depends testFindFiles
     */
    public function testFindFilesRecursiveWithSymLink(): void
    {
        $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(): void
    {
        $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(): void
    {
        $basePath = $this->testFilePath . DIRECTORY_SEPARATOR;
        $dirs = ['', 'one', 'one' . DIRECTORY_SEPARATOR . 'two', 'three'];
        $files = array_fill_keys(array_map(fn($n) => "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, fn($p) => str_ends_with($p, 'a.1')));
        $this->assertEquals($expect, $foundFiles);

        // suffix
        $foundFiles = FileHelper::findFiles($basePath, ['except' => ['*.1']]);
        sort($foundFiles);
        $expect = array_values(array_filter($flat, fn($p) => !str_ends_with((string) $p, 'a.1')));
        $this->assertEquals($expect, $foundFiles);

        // dir
        $foundFiles = FileHelper::findFiles($basePath, ['except' => ['/one']]);
        sort($foundFiles);
        $expect = array_values(array_filter($flat, fn($p) => !str_contains((string) $p, DIRECTORY_SEPARATOR . 'one')));
        $this->assertEquals($expect, $foundFiles);

        // dir contents
        $foundFiles = FileHelper::findFiles($basePath, ['except' => ['?*/a.1']]);
        sort($foundFiles);
        $expect = array_values(array_filter($flat, fn($p) => substr((string) $p, -11, 10) === 'one' . DIRECTORY_SEPARATOR . 'two' . DIRECTORY_SEPARATOR . 'a.' || (
            substr((string) $p, -8) !== DIRECTORY_SEPARATOR . 'one' . DIRECTORY_SEPARATOR . 'a.1' &&
            substr((string) $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, fn($p) => !str_contains((string) $p, DIRECTORY_SEPARATOR . 'one') || str_contains($p, DIRECTORY_SEPARATOR . 'two')));

        $this->assertEquals($expect, $foundFiles);
    }

    /**
     * @depends testFindFilesExclude
     */
    public function testFindFilesCaseSensitive(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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(): void
    {
        $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 => [...$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(): void
    {
        [$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(): void
    {
        [$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->assertFileDoesNotExist($dstDirName . DIRECTORY_SEPARATOR . 'dir2');
        $this->assertFileDoesNotExist($dstDirName . DIRECTORY_SEPARATOR . 'dir3');
    }

    public function testFindDirectories(): void
    {
        $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' => fn($path) => 'second_sub_dir' === basename((string) $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(): void
    {
        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(): void
    {
        $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 Use file.
     * @param mixed $ownership User and group ownership.
     * @param mixed $mode File mode.
     */
    public function testChangeOwnershipInvalidArguments(bool $useFile, mixed $ownership, mixed $mode): void
    {
        $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 static function changeOwnershipInvalidArgumentsProvider(): array
    {
        return [
            [false, '123:123', null],
            [true, new stdClass(), null],
            [true, ['user' => new stdClass()], null],
            [true, ['group' => new stdClass()], null],
            [true, null, 'test'],
        ];
    }

    /**
     * @dataProvider getExtensionsByMimeTypeProvider
     * @return void
     */
    public function testGetExtensionsByMimeType(string $mimeType, array $extensions): void
    {
        $this->assertEquals($extensions, FileHelper::getExtensionsByMimeType($mimeType));
    }

    public static function getExtensionsByMimeTypeProvider(): array
    {
        return [
            [
                'application/json',
                [
                    'json',
                ],
            ],
            [
                'image/jpeg',
                [ // Note: For backwards compatibility the (alphabetic) order of `framework/helpers/mimeTypes.php` is expected.
                    'jfif',
                    'jpe',
                    'jpeg',
                    'jpg',
                    'pjp',
                    'pjpeg',
                ],
            ],
        ];
    }

    /**
     * @dataProvider getExtensionByMimeTypeProvider
     * @param array $extension
     * @return void
     */
    public function testGetExtensionByMimeType(string $mimeType, bool $preferShort, string $extension): void
    {
        $this->assertEquals($extension, FileHelper::getExtensionByMimeType($mimeType, $preferShort));
    }

    public static function getExtensionByMimeTypeProvider(): array
    {
        return [
            ['application/json', true, 'json'],
            ['application/json', false, 'json'],
            ['image/jpeg', true, 'jpg'],
            ['image/jpeg', false, 'jpeg'],
        ];
    }
}
