[symfony/finder]最好用的文件操作库

在有些时候,我们需要操作服务器上的文件,要么遍历目录,要么查找相应扩展的文件,这时候我们在网上搜到的代码都是十分糟糕的,有没有一种优雅的高性能的方式呢?

finder就是这样一个库.

基本用法

use Symfony\Component\Finder\Finder;

$finder = new Finder();
// 进入某一个文件夹
$finder->files()->in(__DIR__);

// 查看是否为空
if ($finder->hasResults()) {
    // ...
}

foreach ($finder as $file) {
    // 开始遍历文件
    $absoluteFilePath = $file->getRealPath();
    $fileNameWithExtension = $file->getRelativePathname();

    // ...
}

优雅的过滤搜索

链式调用in方法,意味着在某一个目录下找另一个目录.

$finder->in(__DIR__)->in('/elsewhere');

通过*匹配对应文件

$finder->in('src/Symfony/*/*/Resources');

排除一些文件

$finder->in(__DIR__)->exclude('ruby');

直接过滤掉没有权限读取的文件

$finder->ignoreUnreadableDirs()->in(__DIR__);

支持各类底层系统

支持标准文件协议的访问

// 打开一个FTP地址
$finder->in('ftp://example.com/');

$finder->in('ftp://example.com/pub/');

以下访问方式都支持:

• file:// — 访问本地文件系统
• http:// — 访问 HTTP(s) 网址
• ftp:// — 访问 FTP(s) URLs
• php:// — 访问各个输入/输出流（I/O streams）
• zlib:// — 压缩流
• data:// — 数据（RFC 2397）
• glob:// — 查找匹配的文件路径模式
• phar:// — PHP 归档
• ssh2:// — 安全外壳协议 2
• rar:// — RAR
• ogg:// — 音频流
• expect:// — 处理交互式的流

支持自定义底层系统协议,下面这个例子展示了访问亚马逊的存储.

use Symfony\Component\Finder\Finder;

// 通过AWS官方包注册访问协议 's3://'
$s3Client = new Aws\S3\S3Client([/* config options */]);
$s3Client->registerStreamWrapper();

$finder = new Finder();
$finder->name('photos*')->size('< 100K')->date('since 1 hour ago');
foreach ($finder->in('s3://bucket-name') as $file) {
    // ... do something with the file
}

轻易地操作文件或目录

// 只查询文件
$finder->files();

// 只查询目录
$finder->directories();

对文件进行过滤

支持非常优雅的操作文件的方式.

$finder->files()->name('*.php');
$finder->files()->name('/\.php$/');
$finder->files()->notName('*.rb');
$finder->files()->size('>= 1K')->size('<= 2K');
$finder->date('>= 2018-01-01')->date('<= 2018-12-31');