闲来无事，整理了一下自己写的文件上传类。

通过

UploadFile::getInstance($model, $attribute);

UploadFile::getInstances($model, $attribute);

UploadFile::getInstanceByName($name);

UploadFile::getInstancesByName($name);

把表单上传的文件赋值到  UploadedFile中的  private static $_files  中

/**
   * Returns an uploaded file for the given model attribute.
   * The file should be uploaded using [[\yii\widgets\ActiveField::fileInput()]].
   * @param \yii\base\Model $model the data model
   * @param string $attribute the attribute name. The attribute name may contain array indexes.
   * For example, '[1]file' for tabular file uploading; and 'file[1]' for an element in a file array.
   * @return UploadedFile the instance of the uploaded file.
   * Null is returned if no file is uploaded for the specified model attribute.
   * @see getInstanceByName()
   */
  public static function getInstance($model, $attribute)
  {
    $name = Html::getInputName($model, $attribute);
    return static::getInstanceByName($name);
  }

  /**
   * Returns all uploaded files for the given model attribute.
   * @param \yii\base\Model $model the data model
   * @param string $attribute the attribute name. The attribute name may contain array indexes
   * for tabular file uploading, e.g. '[1]file'.
   * @return UploadedFile[] array of UploadedFile objects.
   * Empty array is returned if no available file was found for the given attribute.
   */
  public static function getInstances($model, $attribute)
  {
    $name = Html::getInputName($model, $attribute);
    return static::getInstancesByName($name);
  }

  /**
   * Returns an uploaded file according to the given file input name.
   * The name can be a plain string or a string like an array element (e.g. 'Post[imageFile]', or 'Post[0][imageFile]').
   * @param string $name the name of the file input field.
   * @return UploadedFile the instance of the uploaded file.
   * Null is returned if no file is uploaded for the specified name.
   */
  public static function getInstanceByName($name)
  {
    $files = self::loadFiles();
    return isset($files[$name]) ? $files[$name] : null;
  }

  /**
   * Returns an array of uploaded files corresponding to the specified file input name.
   * This is mainly used when multiple files were uploaded and saved as 'files[0]', 'files[1]',
   * 'files[n]'..., and you can retrieve them all by passing 'files' as the name.
   * @param string $name the name of the array of files
   * @return UploadedFile[] the array of UploadedFile objects. Empty array is returned
   * if no adequate upload was found. Please note that this array will contain
   * all files from all sub-arrays regardless how deeply nested they are.
   */
  public static function getInstancesByName($name)
  {
    $files = self::loadFiles();
    if (isset($files[$name])) {
      return [$files[$name]];
    }
    $results = [];
    foreach ($files as $key => $file) {
      if (strpos($key, "{$name}[") === 0) {
        $results[] = $file;
      }
    }
    return $results;
  }

loadFiles()方法，把$_FILES中的键值作为参数传递到loadFilesRecursive（$key, $names, $tempNames, $types, $sizes, $errors） 中

/**
   * Creates UploadedFile instances from $_FILE.
   * @return array the UploadedFile instances
   */
  private static function loadFiles()
  {
    if (self::$_files === null) {
      self::$_files = [];
      if (isset($_FILES) && is_array($_FILES)) {
        foreach ($_FILES as $class => $info) {
          self::loadFilesRecursive($class, $info['name'], $info['tmp_name'], $info['type'], $info['size'], $info['error']);
        }
      }
    }
    return self::$_files;
  }

loadFilesRecursive方法，通过递归把$_FILES中的内容保存到  self::$_files 中

/**
   * Creates UploadedFile instances from $_FILE recursively.
   * @param string $key key for identifying uploaded file: class name and sub-array indexes
   * @param mixed $names file names provided by PHP
   * @param mixed $tempNames temporary file names provided by PHP
   * @param mixed $types file types provided by PHP
   * @param mixed $sizes file sizes provided by PHP
   * @param mixed $errors uploading issues provided by PHP
   */
  private static function loadFilesRecursive($key, $names, $tempNames, $types, $sizes, $errors)
  {
    if (is_array($names)) {
      foreach ($names as $i => $name) {
        self::loadFilesRecursive($key . '[' . $i . ']', $name, $tempNames[$i], $types[$i], $sizes[$i], $errors[$i]);
      }
    } elseif ($errors !== UPLOAD_ERR_NO_FILE) {
      self::$_files[$key] = new static([
        'name' => $names,
        'tempName' => $tempNames,
        'type' => $types,
        'size' => $sizes,
        'error' => $errors,
      ]);
    }
  }

实例:

html

<form class="form-horizontal form-margin50" action="<?= \yii\helpers\Url::toRoute('upload-face') ?>"
          method="post" enctype="multipart/form-data" id="form1">
         <input type="hidden" name="_csrf" value="<?= Yii::$app->request->getCsrfToken() ?>">
         <input type="file" name="head_pic" id="doc" style="display: none" onchange="setImagePreview()"/>
 </form>

php代码,打印的

public static function uploadImage($userId = '', $tem = '')
  {
    $returnPath = '';
    $path = 'uploads/headpic/' . $userId;
    if (!file_exists($path)) {
      mkdir($path, 0777);
      chmod($path, 0777);
    }

    $patch = $path . '/' . date("YmdHis") . '_';
    $tmp = UploadedFile::getInstanceByName('head_pic');
    if ($tmp) {
      $patch = $path . '/' . date("YmdHis") . '_';
      $tmp->saveAs($patch . '1.jpg');
      $returnPath .= $patch;
    }

    return $returnPath;
  }

打印dump($tmp,$_FILES,$tmp->getExtension());

对应的 UploadedFile

class UploadedFile extends Object
{
  /**
   * @var string the original name of the file being uploaded
   */
  // "Chrysanthemum.jpg"
  public $name;
  /**
   * @var string the path of the uploaded file on the server.
   * Note, this is a temporary file which will be automatically deleted by PHP
   * after the current request is processed.
   */
  // "C:\Windows\Temp\php8CEF.tmp"
  public $tempName;
  /**
   * @var string the MIME-type of the uploaded file (such as "image/gif").
   * Since this MIME type is not checked on the server-side, do not take this value for granted.
   * Instead, use [[\yii\helpers\FileHelper::getMimeType()]] to determine the exact MIME type.
   */
  // "image/jpeg"
  public $type;
  /**
   * @var integer the actual size of the uploaded file in bytes
   */
  // 879394
  public $size;
  /**
   * @var integer an error code describing the status of this file uploading.
   * @see http://www.php.net/manual/en/features.file-upload.errors.php
   */
  // 0
  public $error;

  private static $_files;


  /**
   * String output.
   * This is PHP magic method that returns string representation of an object.
   * The implementation here returns the uploaded file's name.
   * @return string the string representation of the object
   */
  public function __toString()
  {
    return $this->name;
  }

  /**
   * Returns an uploaded file for the given model attribute.
   * The file should be uploaded using [[\yii\widgets\ActiveField::fileInput()]].
   * @param \yii\base\Model $model the data model
   * @param string $attribute the attribute name. The attribute name may contain array indexes.
   * For example, '[1]file' for tabular file uploading; and 'file[1]' for an element in a file array.
   * @return UploadedFile the instance of the uploaded file.
   * Null is returned if no file is uploaded for the specified model attribute.
   * @see getInstanceByName()
   */
  public static function getInstance($model, $attribute)
  {
    $name = Html::getInputName($model, $attribute);
    return static::getInstanceByName($name);
  }

  /**
   * Returns all uploaded files for the given model attribute.
   * @param \yii\base\Model $model the data model
   * @param string $attribute the attribute name. The attribute name may contain array indexes
   * for tabular file uploading, e.g. '[1]file'.
   * @return UploadedFile[] array of UploadedFile objects.
   * Empty array is returned if no available file was found for the given attribute.
   */
  public static function getInstances($model, $attribute)
  {
    $name = Html::getInputName($model, $attribute);
    return static::getInstancesByName($name);
  }

  /**
   * Returns an uploaded file according to the given file input name.
   * The name can be a plain string or a string like an array element (e.g. 'Post[imageFile]', or 'Post[0][imageFile]').
   * @param string $name the name of the file input field.
   * @return null|UploadedFile the instance of the uploaded file.
   * Null is returned if no file is uploaded for the specified name.
   */
  public static function getInstanceByName($name)
  {
    $files = self::loadFiles();
    return isset($files[$name]) ? new static($files[$name]) : null;
  }

  /**
   * Returns an array of uploaded files corresponding to the specified file input name.
   * This is mainly used when multiple files were uploaded and saved as 'files[0]', 'files[1]',
   * 'files[n]'..., and you can retrieve them all by passing 'files' as the name.
   * @param string $name the name of the array of files
   * @return UploadedFile[] the array of UploadedFile objects. Empty array is returned
   * if no adequate upload was found. Please note that this array will contain
   * all files from all sub-arrays regardless how deeply nested they are.
   */
  public static function getInstancesByName($name)
  {
    $files = self::loadFiles();
    if (isset($files[$name])) {
      return [new static($files[$name])];
    }
    $results = [];
    foreach ($files as $key => $file) {
      if (strpos($key, "{$name}[") === 0) {
        $results[] = new static($file);
      }
    }
    return $results;
  }

  /**
   * Cleans up the loaded UploadedFile instances.
   * This method is mainly used by test scripts to set up a fixture.
   */
  //清空self::$_files
  public static function reset()
  {
    self::$_files = null;
  }

  /**
   * Saves the uploaded file.
   * Note that this method uses php's move_uploaded_file() method. If the target file `$file`
   * already exists, it will be overwritten.
   * @param string $file the file path used to save the uploaded file
   * @param boolean $deleteTempFile whether to delete the temporary file after saving.
   * If true, you will not be able to save the uploaded file again in the current request.
   * @return boolean true whether the file is saved successfully
   * @see error
   */
  //通过php的move_uploaded_file() 方法保存临时文件为目标文件
  public function saveAs($file, $deleteTempFile = true)
  {
    //$this->error == UPLOAD_ERR_OK UPLOAD_ERR_OK 其值为 0，没有错误发生，文件上传成功。
    if ($this->error == UPLOAD_ERR_OK) {
      if ($deleteTempFile) {
        //将上传的文件移动到新位置
        return move_uploaded_file($this->tempName, $file);
      } elseif (is_uploaded_file($this->tempName)) {//判断文件是否是通过 HTTP POST 上传的
        return copy($this->tempName, $file);//copy — 拷贝文件
      }
    }
    return false;
  }

  /**
   * @return string original file base name
   */
  //获取上传文件原始名称 "name" => "Chrysanthemum.jpg" "Chrysanthemum"
  public function getBaseName()
  {
    // https://github.com/yiisoft/yii2/issues/11012
    $pathInfo = pathinfo('_' . $this->name, PATHINFO_FILENAME);
    return mb_substr($pathInfo, 1, mb_strlen($pathInfo, '8bit'), '8bit');
  }

  /**
   * @return string file extension
   */
  //获取上传文件扩展名称 "name" => "Chrysanthemum.jpg" "jpg"
  public function getExtension()
  {
    return strtolower(pathinfo($this->name, PATHINFO_EXTENSION));
  }

  /**
   * @return boolean whether there is an error with the uploaded file.
   * Check [[error]] for detailed error code information.
   */
  //上传文件是否出现错误
  public function getHasError()
  {
    return $this->error != UPLOAD_ERR_OK;
  }

  /**
   * Creates UploadedFile instances from $_FILE.
   * @return array the UploadedFile instances
   */
  private static function loadFiles()
  {
    if (self::$_files === null) {
      self::$_files = [];
      if (isset($_FILES) && is_array($_FILES)) {
        foreach ($_FILES as $class => $info) {
          self::loadFilesRecursive($class, $info['name'], $info['tmp_name'], $info['type'], $info['size'], $info['error']);
        }
      }
    }
    return self::$_files;
  }

  /**
   * Creates UploadedFile instances from $_FILE recursively.
   * @param string $key key for identifying uploaded file: class name and sub-array indexes
   * @param mixed $names file names provided by PHP
   * @param mixed $tempNames temporary file names provided by PHP
   * @param mixed $types file types provided by PHP
   * @param mixed $sizes file sizes provided by PHP
   * @param mixed $errors uploading issues provided by PHP
   */
  private static function loadFilesRecursive($key, $names, $tempNames, $types, $sizes, $errors)
  {
    if (is_array($names)) {
      foreach ($names as $i => $name) {
        self::loadFilesRecursive($key . '[' . $i . ']', $name, $tempNames[$i], $types[$i], $sizes[$i], $errors[$i]);
      }
    } elseif ((int)$errors !== UPLOAD_ERR_NO_FILE) {
      self::$_files[$key] = [
        'name' => $names,
        'tempName' => $tempNames,
        'type' => $types,
        'size' => $sizes,
        'error' => $errors,
      ];
    }
  }
}

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。

# yii2  # uploadedfile  # yii 

相关栏目： 【 网站优化151355 】 【 网络推广146373 】 【 网络技术251813 】 【 AI营销90571 】

相关推荐： 阿里云网站搭建费用解析：服务器价格与建站成本优化指南  jQuery中的100个技巧汇总  MySQL查询结果复制到新表的方法(更新、插入)  Laravel怎么在Blade中安全地输出原始HTML内容  Win11怎么关闭专注助手 Win11关闭免打扰模式设置【操作】  免费的流程图制作网站有哪些,2025年教师初级职称申报网上流程？  如何用PHP工具快速搭建高效网站？  大型企业网站制作流程,做网站需要注册公司吗？  如何在IIS中新建站点并解决端口绑定冲突？  Laravel如何使用withoutEvents方法临时禁用模型事件  如何在Windows服务器上快速搭建网站？  Laravel如何使用集合（Collections）进行数据处理_Laravel Collection常用方法与技巧  微信h5制作网站有哪些,免费微信H5页面制作工具？  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门  javascript中数组（Array)对象和字符串（String)对象的常用方法总结  Laravel如何使用API Resources格式化JSON响应_Laravel数据资源封装与格式化输出  laravel服务容器和依赖注入怎么理解_laravel服务容器与依赖注入解析  手机软键盘弹出时影响布局的解决方法  Claude怎样写约束型提示词_Claude约束提示词写法【教程】  Python函数文档自动校验_规范解析【教程】  Laravel广播系统如何实现实时通信_Laravel Reverb与WebSockets实战教程  如何在宝塔面板中创建新站点？  Laravel怎么在Controller之外的地方验证数据  微信小程序 require机制详解及实例代码  油猴 教程,油猴搜脚本为什么会网页无法显示？  HTML 中如何正确使用模板变量为元素的 name 属性赋值  Laravel如何实现本地化和多语言支持_Laravel多语言配置与翻译文件管理  Laravel请求验证怎么写_Laravel Validator自定义表单验证规则教程  jquery插件bootstrapValidator表单验证详解  php嵌入式断网后怎么恢复_php检测网络重连并恢复硬件控制【操作】  Laravel怎么导出Excel文件_Laravel Excel插件使用教程  js实现获取鼠标当前的位置  Laravel N+1查询问题如何解决_Eloquent预加载(Eager Loading)优化数据库查询  南京网站制作费用,南京远驱官方网站？  ChatGPT怎么生成Excel公式_ChatGPT公式生成方法【指南】  百度输入法ai组件怎么删除 百度输入法ai组件移除工具  Laravel如何配置中间件Middleware_Laravel自定义中间件拦截请求与权限校验【步骤】  如何批量查询域名的建站时间记录？  EditPlus中的正则表达式 实战(1)  米侠浏览器网页图片不显示怎么办 米侠图片加载修复  Laravel怎么配置.env环境变量_Laravel生产环境敏感数据保护与读取【方法】  Internet Explorer官网直接进入 IE浏览器在线体验版网址  google浏览器怎么清理缓存_谷歌浏览器清除缓存加速详细步骤  javascript如何操作浏览器历史记录_怎样实现无刷新导航  Laravel与Inertia.js怎么结合_使用Laravel和Inertia构建现代单页应用  node.js报错：Cannot find module 'ejs'的解决办法  西安市网站制作公司,哪个相亲网站比较好?西安比较好的相亲网站？  百度输入法全感官ai怎么关 百度输入法全感官皮肤关闭  Laravel如何实现URL美化Slug功能_Laravel使用eloquent-sluggable生成别名【方法】