Yii2实现UploadedFile上传文件示例
发布时间 - 2026-01-10 23:04:42 点击率:次闲来无事,整理了一下自己写的文件上传类。

通过
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 】
相关推荐:
Laravel如何集成微信支付SDK_Laravel使用yansongda-pay实现扫码支付【实战】
Python3.6正式版新特性预览
Python正则表达式进阶教程_复杂匹配与分组替换解析
laravel怎么配置和使用PHP-FPM来优化性能_laravel PHP-FPM配置与性能优化方法
教你用AI将一段旋律扩展成一首完整的曲子
Laravel的路由模型绑定怎么用_Laravel Route Model Binding简化控制器逻辑
微信小程序 input输入框控件详解及实例(多种示例)
香港服务器建站指南:免备案优势与SEO优化技巧全解析
佐糖AI抠图怎样调整抠图精度_佐糖AI精度调整与放大细化操作【攻略】
如何在沈阳梯子盘古建站优化SEO排名与功能模块?
佛山企业网站制作公司有哪些,沟通100网上服务官网?
HTML透明颜色代码怎么让图片透明_给img元素加透明色的技巧【方法】
想要更高端的建设网站,这些原则一定要坚持!
香港服务器网站卡顿?如何解决网络延迟与负载问题?
装修招标网站设计制作流程,装修招标流程?
黑客如何通过漏洞一步步攻陷网站服务器?
独立制作一个网站多少钱,建立网站需要花多少钱?
js实现点击每个li节点,都弹出其文本值及修改
Laravel怎么实现搜索高亮功能_Laravel结合Scout与Algolia全文检索【实战】
无锡营销型网站制作公司,无锡网选车牌流程?
香港网站服务器数量如何影响SEO优化效果?
如何在HTML表单中获取用户输入并结合JavaScript动态控制复利计算循环
Laravel如何部署到服务器_线上部署Laravel项目的完整流程与步骤
深圳网站制作培训,深圳哪些招聘网站比较好?
Laravel Docker环境搭建教程_Laravel Sail使用指南
Windows驱动无法加载错误解决方法_驱动签名验证失败处理步骤
php485函数参数是什么意思_php485各参数详细说明【介绍】
微信小程序 配置文件详细介绍
Laravel怎么实现微信登录_Laravel Socialite第三方登录集成
Laravel怎么创建自己的包(Package)_Laravel扩展包开发入门到发布
JavaScript如何实现继承_有哪些常用方法
邀请函制作网站有哪些,有没有做年会邀请函的网站啊?在线制作,模板很多的那种?
Laravel如何处理CORS跨域请求?(配置示例)
*服务器网站为何频现安全漏洞?
如何在七牛云存储上搭建网站并设置自定义域名?
laravel怎么用DB facade执行原生SQL查询_laravel DB facade原生SQL执行方法
如何获取PHP WAP自助建站系统源码?
网站制作软件免费下载安装,有哪些免费下载的软件网站?
Laravel路由怎么定义_Laravel核心路由系统完全入门指南
如何快速打造个性化非模板自助建站?
网站制作壁纸教程视频,电脑壁纸网站?
如何在IIS服务器上快速部署高效网站?
Python并发异常传播_错误处理解析【教程】
Bootstrap整体框架之CSS12栅格系统
Laravel怎么配置.env环境变量_Laravel生产环境敏感数据保护与读取【方法】
东莞专业网站制作公司有哪些,东莞招聘网站哪个好?
Laravel Telescope怎么调试_使用Laravel Telescope进行应用监控与调试
laravel怎么在请求结束后执行任务(Terminable Middleware)_laravel Terminable Middleware请求结束任务执行方法
Linux安全能力提升路径_长期防护思维说明【指导】
Win11怎么开启自动HDR画质_Windows11显示设置HDR选项

