处理文件

CodeIgniter 提供了一个 File 类,它封装了 SplFileInfo 类, 并提供了一些额外的方便方法。这个类是 上传文件 和 图像处理 的基类。

获取 File 实例

你可以通过在构造函数中传入文件的路径来创建一个新的 File 实例。

$file = new \CodeIgniter\Files\File($path);

默认情况下，文件不需要存在。然而，你可以传递一个额外的参数 true 来检查文件是否存在，如果文件不存在则抛出 FileNotFoundException()。

利用 Spl 的优势

一旦你有了一个实例,你就可以完全使用 SplFileInfo 类的功能,包括:

// Get the file's basename
echo $file->getBasename();
// Get last modified time
echo $file->getMTime();
// Get the true real path
echo $file->getRealPath();
// Get the file permissions
echo $file->getPerms();

// Write CSV rows to it.
if ($file->isWritable()) {
    $csv = $file->openFile('w');

    foreach ($rows as $row) {
        $csv->fputcsv($row);
    }
}

新功能

除了 SplFileInfo 类中的所有方法,你还可以获取一些新工具。

getRandomName()

你可以使用 getRandomName() 方法生成一个加密安全的随机文件名,文件名前面加上当前时间戳。当移动文件时,这对于使文件名不可猜测尤其有用:

// Generates something like: 1465965676_385e33f741.jpg
$newName = $file->getRandomName();

getSize()

返回文件的大小（以字节为单位）：

$size = $file->getSize(); // 256901

如果文件不存在或发生错误，将抛出 RuntimeException。

getSizeByUnit()

返回文件的大小，默认以字节为单位。你可以传入 'kb' 或 'mb' 作为第一个参数，以分别获取以千字节或兆字节为单位的结果：

$bytes     = $file->getSizeByUnit(); // 256901
$kilobytes = $file->getSizeByUnit('kb'); // 250.880
$megabytes = $file->getSizeByUnit('mb'); // 0.245

如果文件不存在或发生错误，将抛出 RuntimeException。

getMimeType()

检索文件媒体类型(mime 类型)。在确定文件类型时,使用尽可能安全的方法:

$type = $file->getMimeType();

echo $type; // image/png

guessExtension()

尝试根据受信任的 getMimeType() 方法确定文件扩展名。如果 mime 类型未知,将返回 null。这通常是比仅使用文件名提供的扩展名更可信的来源。使用 app/Config/Mimes.php 中的值来确定扩展名:

// Returns 'jpg' (WITHOUT the period)
$ext = $file->guessExtension();

移动文件

每个文件都可以使用恰当命名的 move() 方法移动到新位置。第一个参数是要移动文件到的目录:

$file->move(WRITEPATH . 'uploads');

默认情况下,使用了原始文件名。你可以通过作为第二个参数传递来指定一个新文件名:

$newName = $file->getRandomName();
$file->move(WRITEPATH . 'uploads', $newName);

move() 方法返回重新定位文件的新的 File 实例,所以如果需要结果位置,必须捕获结果:

$file = $file->move(WRITEPATH . 'uploads');