php yii2 文件上传,Yii2实现UploadedFile上传文件示例

本文详细介绍了如何使用自定义的UploadFile类管理表单上传的文件,包括单文件和多文件上传,以及如何将文件实例存储和检索。重点讲解了`getInstance`、`getInstances`等核心方法的用法及其实例应用。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

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

通过

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

method="post" enctype="multipart/form-data" id="form1">

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

6be2635343193397cd27ee98fac619b8.png

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

];

}

}

}

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值