Struct File 

pub struct File { /* private fields */ }

文件类 — 对齐 PHP think\File（基于 SplFileInfo）

PHP 第 22-46 行：

class File extends SplFileInfo {
    protected $hash = [];
    protected $hashName;
    protected $extension;
    public function __construct(string $path, bool $checkPath = true) {
        if ($checkPath && !is_file($path)) {
            throw new FileException(sprintf('The file "%s" does not exist', $path));
        }
        parent::__construct($path);
    }
}

Implementations

impl File

pub fn new<P>(path: P, check_path: bool) -> Result<File, UploadError>

where P: AsRef<Path>,

创建 File 实例 — 对齐 PHP File::__construct 第 39-46 行

check_path = true 时检查文件是否存在，不存在返回 UploadError::FileNotFound。

pub fn new_unchecked<P>(path: P) -> File

where P: AsRef<Path>,

不检查路径创建实例 — 对齐 PHP 第 138 行 new self($target, false)

pub fn path(&self) -> &Path

获取文件路径 — 对齐 PHP SplFileInfo::getPathname()

pub fn path_name(&self) -> String

获取文件路径字符串

pub fn hash(&mut self, algo: HashAlgo) -> Result<String, UploadError>

获取文件哈希 — 对齐 PHP File::hash($type) 第 54-61 行

PHP 行为：

public function hash(string $type = 'sha1'): string {
    if (!isset($this->hash[$type])) {
        $this->hash[$type] = hash_file($type, $this->getPathname());
    }
    return $this->hash[$type];
}

pub fn md5(&mut self) -> Result<String, UploadError>

获取文件 MD5 — 对齐 PHP File::md5() 第 68-71 行

pub fn sha1(&mut self) -> Result<String, UploadError>

获取文件 SHA1 — 对齐 PHP File::sha1() 第 78-81 行

pub fn get_mime(&self) -> Result<String, UploadError>

获取文件 MIME — 对齐 PHP File::getMime() 第 88-93 行

PHP 行为：使用 finfo_open(FILEINFO_MIME_TYPE) + finfo_file() 检测 MIME。 Rust 端：优先用 infer crate 从内容检测，回退到 mime_guess 从扩展名猜测。

pub fn move_to<P>( &mut self, directory: P, name: Option<&str>, ) -> Result<File, UploadError>

where P: AsRef<Path>,

移动文件 — 对齐 PHP File::move() 第 102-118 行

PHP 行为：

1. 获取 target 文件
2. rename($this->getPathname(), $target) 移动文件
3. 失败抛 FileException
4. chmod($target, 0666 & ~umask()) 设置权限
5. 返回新 File 实例

pub fn extension(&self) -> String

文件扩展名 — 对齐 PHP File::extension() 第 159-162 行

PHP 行为：return $this->getExtension();（SplFileInfo::getExtension() 返回最后点后的部分）

pub fn set_extension(&mut self, extension: &str)

指定保存文件的扩展名 — 对齐 PHP File::setExtension() 第 169-172 行

pub fn hash_name(&mut self, rule: HashNameRule) -> Result<String, UploadError>

自动生成文件名 — 对齐 PHP File::hashName($rule) 第 180-203 行

PHP 行为：

public function hashName($rule = ''): string {
    if (!$this->hashName) {
        if ($rule instanceof \Closure) {
            $this->hashName = call_user_func_array($rule, [$this]);
        } else {
            switch (true) {
                case in_array($rule, hash_algos()):
                    $hash = $this->hash($rule);
                    $this->hashName = substr($hash, 0, 2) . DIRECTORY_SEPARATOR . substr($hash, 2);
                    break;
                case is_callable($rule):
                    $this->hashName = call_user_func($rule);
                    break;
                default:
                    $this->hashName = date('Ymd') . DIRECTORY_SEPARATOR . md5(microtime(true) . $this->getPathname());
                    break;
            }
        }
    }
    $extension = $this->extension ?? $this->extension();
    return $this->hashName . ($extension ? '.' . $extension : '');
}

Rust 端简化：只支持 Default 和 Hash(algo) 两种规则。

pub fn basename(&self) -> String

获取文件名（不含目录） — 对齐 PHP SplFileInfo::getBasename()

Trait Implementations

impl Clone for File

fn clone(&self) -> File

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for File

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.