Yii2实现UploadedFile上传文件示例


Posted in PHP onFebruary 15, 2017

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

通过

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());

Yii2实现UploadedFile上传文件示例

对应的 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,
      ];
    }
  }
}

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

PHP 相关文章推荐
Zend的AutoLoad机制介绍
Sep 27 PHP
php语言流程控制中的主动与被动
Nov 05 PHP
基于PHP文件操作的详解
Jun 05 PHP
使用php验证复选框有效性的示例
Nov 13 PHP
php实现mysql封装类示例
May 07 PHP
ThinkPHP的L方法使用简介
Jun 18 PHP
PHP也能干大事 随机函数
Apr 14 PHP
php将日期格式转换成xx天前的格式
Apr 16 PHP
php无限分类使用concat如何实现
Nov 05 PHP
Yii2框架引用bootstrap中日期插件yii2-date-picker的方法
Jan 09 PHP
PHP获取中国时间(上海时区时间)及美国时间的方法
Feb 23 PHP
php设计模式之原型模式分析【星际争霸游戏案例】
Mar 23 PHP
使用PHPMailer发送邮件实例
Feb 15 #PHP
php使用gd2绘制基本图形示例(直线、圆、正方形)
Feb 15 #PHP
php使用GD2绘制几何图形示例
Feb 15 #PHP
php使用Jpgraph创建柱状图展示年度收支表效果示例
Feb 15 #PHP
php使用Jpgraph创建折线图效果示例
Feb 15 #PHP
php使用Jpgraph创建3D饼形图效果示例
Feb 15 #PHP
PHP反射机制原理与用法详解
Feb 15 #PHP
You might like
非常好的php目录导航文件代码
2006/10/09 PHP
php中$_POST与php://input的区别实例分析
2015/01/07 PHP
function, new function, new Function之间的区别
2007/03/08 Javascript
js利用div背景,做一个竖线的效果。
2008/11/22 Javascript
用 Javascript 验证表单(form)中的单选(radio)值
2009/09/08 Javascript
JQuery动画和停止动画实例代码
2013/03/01 Javascript
JavaScript 垃圾回收机制分析
2013/10/10 Javascript
javascript面向对象之访问对象属性的两种方式分析
2015/01/13 Javascript
JS中捕获console.log()输出的方法
2015/04/16 Javascript
微信小程序 wxapp内容组件 text详细介绍
2016/10/31 Javascript
微信小程序 PHP后端form表单提交实例详解
2017/01/12 Javascript
jQuery+Ajax实现用户名重名实时检测
2017/06/01 jQuery
Angular4实现鼠标悬停3d倾斜效果
2017/10/25 Javascript
一个基于react的图片裁剪组件示例
2018/04/18 Javascript
浅谈webpack+react多页面开发终极架构
2018/11/11 Javascript
Node.js中文件系统fs模块的使用及常用接口
2020/03/06 Javascript
Element Dialog对话框的使用示例
2020/07/26 Javascript
Vue封装全局过滤器Filters的步骤
2020/09/16 Javascript
[18:16]sakonoko 2017年卡尔集锦
2018/02/06 DOTA
Python加pyGame实现的简单拼图游戏实例
2015/05/15 Python
python 专题九 Mysql数据库编程基础知识
2017/03/16 Python
Python创建普通菜单示例【基于win32ui模块】
2018/05/09 Python
python 多进程共享全局变量之Manager()详解
2019/08/15 Python
python求一个字符串的所有排列的实现方法
2020/02/04 Python
django Model层常用验证器及自定义验证器详解
2020/07/15 Python
Python wordcloud库安装方法总结
2020/12/31 Python
请写出 BOOL flag 与"零值"比较的 if 语句
2016/02/29 面试题
C#软件工程师英语面试题
2015/06/07 面试题
大专毕业生自我评价分享
2013/11/10 职场文书
土木工程师职业规划范文
2014/03/07 职场文书
个人公开承诺书
2014/03/28 职场文书
土地租赁意向书
2014/07/30 职场文书
与美同行演讲稿
2014/09/13 职场文书
2014年学习委员工作总结
2014/11/14 职场文书
商业计划书之服装
2019/09/09 职场文书
JavaScript实现一键复制内容剪贴板
2022/07/23 Javascript