Struct UploadedFile 

pub struct UploadedFile { /* private fields */ }

上传文件类 — 对齐 PHP think\file\UploadedFile

PHP 第 18-34 行：

class UploadedFile extends File {
    private $test = false;
    private $originalName;
    private $mimeType;
    private $error;
    public function __construct(string $path, string $originalName, string $mimeType = null, int $error = null, bool $test = false) {
        $this->originalName = $originalName;
        $this->mimeType     = $mimeType ?: 'application/octet-stream';
        $this->test         = $test;
        $this->error        = $error ?: UPLOAD_ERR_OK;
        parent::__construct($path, UPLOAD_ERR_OK === $this->error);
    }
}

Implementations

impl UploadedFile

pub fn new<P: AsRef<Path>>( path: P, original_name: &str, mime_type: Option<&str>, error: Option<i32>, test: bool, ) -> Result<Self, UploadError>

创建 UploadedFile 实例 — 对齐 PHP UploadedFile::__construct 第 26-34 行

pub fn is_valid(&self) -> bool

验证上传文件 — 对齐 PHP UploadedFile::isValid() 第 36-41 行

PHP 行为：

public function isValid(): bool {
    $isOk = UPLOAD_ERR_OK === $this->error;
    return $this->test ? $isOk : $isOk && is_uploaded_file($this->getPathname());
}

Rust 端：is_uploaded_file 是 PHP SAPI 函数，无法精确对齐。 简化为检查文件是否存在（非 test 模式）。

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

移动上传文件 — 对齐 PHP UploadedFile::move() 第 50-75 行

PHP 行为：

1. isValid() 失败 → 抛 FileException($this->getErrorMessage())
2. test 模式：调用 parent::move()（即 rename）
3. 非 test 模式：move_uploaded_file($pathname, $target)
4. 失败抛 FileException
5. chmod($target, 0666 & ~umask())
6. 返回新 File

pub fn original_mime(&self) -> &str

获取原始 MIME — 对齐 PHP UploadedFile::getOriginalMime() 第 112-115 行

pub fn original_name(&self) -> &str

获取原始文件名 — 对齐 PHP UploadedFile::getOriginalName() 第 121-124 行

pub fn original_extension(&self) -> String

获取原始扩展名 — 对齐 PHP UploadedFile::getOriginalExtension() 第 130-133 行

PHP 行为：return pathinfo($this->originalName, PATHINFO_EXTENSION);

pub fn extension(&self) -> String

获取文件扩展名 — 对齐 PHP UploadedFile::extension() 第 139-142 行

PHP 行为：覆写父类，返回原始扩展名。

public function extension(): string {
    return $this->getOriginalExtension();
}

pub fn error_message(&self) -> &'static str

获取错误信息 — 对齐 PHP UploadedFile::getErrorMessage() 第 82-106 行

pub fn error_code(&self) -> UploadErrCode

获取错误码

pub fn as_file(&self) -> &File

访问内部 File（不可变）

pub fn as_file_mut(&mut self) -> &mut File

访问内部 File（可变）

Trait Implementations

impl Clone for UploadedFile

fn clone(&self) -> UploadedFile

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for UploadedFile

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

Formats the value using the given formatter.