composer require symplify/smart-file-system
The SplFileInfo::getRealPath()
method returns absolute path to the file... or FALSE
, if the file doesn't exist. This default PHP behavior forces you to check all getRealPath()
calls:
$fileInfo = new SplFileInfo('non_existing_file.txt');
if ($fileInfo->getRealPath() === false) {
// damn, the files doesn't exist
// throw exception or whatever
// everytime!
}
$fileRealPath = $fileInfo->getRealPath();
While this has a reason - e.g. to be sure the file was not deleted since the construction, we actually have to call the method to find out the file was removed. Another annoyance is to tell this to static analyzers.
In reality, it's very rare to work with file that was existing a while ago, but now is gone, without us doing it on purpose. We usually use SplFileInfo
to modify files or work with their paths.
What if:
- we could remove this problem and make sure
getRealPath()
method always returns string? - get an exception of non-existing file on SplFileInfo creation?
$fileInfo = new Symplify\SmartFileSystem\SmartFileInfo('non_existing_file.txt');
// throws Symplify\SmartFileSystem\Exception\FileNotFoundException
This class also bring new useful methods:
// current directory (cwd()) is "/var/www"
$smartFileInfo = new Symplify\SmartFileSystem\SmartFileInfo('/var/www/src/ExistingFile.php');
echo $smartFileInfo->getBasenameWithoutSuffix();
// "ExistingFile"
echo $smartFileInfo->getRelativeFilePath();
// "src/ExistingFile.php"
echo $smartFileInfo->getRelativeDirectoryPath();
// "src"
echo $smartFileInfo->getRelativeFilePathFromDirectory('/var');
// "www/src/ExistingFile.php"
It also fixes WTF behavior of Symfony\Component\Finder\SplFileInfo
. Which one? When you run e.g. vendor/bin/ecs check src
and use Finder
, the getRelativeFilePath()
in Symfony now returns all the relative paths to src
. Which is useless, mainly with multiple dirs like: vendor/bin/ecs check src tests
both containing file Post.php
.
$smartFileInfo = new Symplify\SmartFileSystem\SmartFileInfo('/var/www/src/Post.php');
echo $smartFileInfo->getRelativeFilePathFromCwd();
// "src/Post.php"
Last but not least, matching a file comes useful in excluding files (typical for tools like ECS, PHPStan, Psalm, Rector, PHP CS Fixer or PHP_CodeSniffer):
$smartFileInfo = new Symplify\SmartFileSystem\SmartFileInfo('/var/www/src/PostRepository.php');
echo $smartFileInfo->endsWith('Repository.php');
// true
echo $smartFileInfo->doesFnmatch('*Repo*');
// true
New method - readFile()
(to read files):
$smartFileSystem = new Symplify\SmartFileSystem\SmartFileSystem();
$fileContent = $smartFileSystem->readFile(__DIR__ . '/SomeFile.php');
// if you plan to use SmartFileInfo, use this
$smartFileInfo = $smartFileSystem->readFileToSmartFileInfo(__DIR__ . '/SomeFile.php');
Do you have multiple file inputs that can mix-up?
$files = [new SplFileInfo('someFile.php')];
$files = [new Symfony\Component\Finder\SplFileInfo('someFile.php', 'someFile', '')];
// or
$files = (new Symfony\Component\Finder\Finder())->files();
// or
$files = Nette\Utils\Finder::findFiles('*');
// or
$files = ['someFile.php'];
Later, you wan to actually work with the files:
foreach ($files as $file) {
// what methods do we have here
// what kind of object?
// is it even object or a string?
$file->...
}
Use sanitized files, that have united format you can rely on:
use Symplify\SmartFileSystem\Finder\FinderSanitizer;
$finderSanitizer = new FinderSanitizer();
$smartFileInfos = $finderSanitizer->sanitize($files);
// always array of Symplify\SmartFileSystem\SmartFileInfo
var_dump($smartFileInfos);
In case you are experiencing a bug or want to request a new feature head over to the Symplify monorepo issue tracker
The sources of this package are contained in the Symplify monorepo. We welcome contributions for this package on symplify/symplify.