Yii2实现文件上传：步骤与实例代码解析

"Yii2 使用表单上传文件的实例代码及步骤详解" 在Yii2框架中，上传文件是一项常见的任务，本篇文章将详细讲解如何通过表单实现文件上传。以下是具体的步骤和实例代码： 1. 创建模型（Model） 首先，我们需要创建一个模型类，用于处理文件上传。在`models`目录下创建名为`UploadForm.php`的文件，内容如下： ```php namespace app\models; use yii\base\Model; use yii\web\UploadedFile; / * UploadForm是上传表单的模型。 */ class UploadForm extends Model { / * @var UploadedFile 文件属性 */ public $file; / * @return array 验证规则 */ public function rules() { return [ [['file'], 'file'], ]; } } ``` 这里的`UploadForm`类继承自`Model`，并定义了一个公开属性`$file`，用于存储上传的文件。`rules()`方法定义了验证规则，表示`file`属性必须是一个文件。 2. 创建视图（View） 接下来，我们需要创建一个视图文件，用户可以通过此视图选择文件进行上传。在视图文件中，使用`ActiveForm`组件创建表单，确保`enctype`属性设置为`multipart/form-data`，这样表单才能处理文件上传。以下是一个简单的视图文件示例： ```php <?php use yii\widgets\ActiveForm; ?> <?php $form = ActiveForm::begin(['options' => ['enctype' => 'multipart/form-data']]); ?> <?= $form->field($model, 'file')->fileInput() ?> <button>Submit</button> <?php ActiveForm::end(); ?> ``` 在这个视图中，我们使用`ActiveForm::field()`创建一个文件输入字段，并通过`fileInput()`方法将其渲染为文件选择器。 3. 控制器（Controller） 最后，我们需要创建一个控制器处理文件上传请求。在`controllers`目录下的`SiteController.php`文件中，添加一个`upload`动作： ```php namespace app\controllers; use Yii; use yii\web\Controller; use app\models\UploadForm; use yii\web\UploadedFile; class SiteController extends Controller { public function actionUpload() { $model = new UploadForm(); if (Yii::$app->request->isPost) { $model->file = UploadedFile::getInstance($model, 'file'); if ($model->file && $model->validate()) { // 这里可以添加文件保存到服务器的逻辑 // 例如： $model->file->saveAs('uploads/' . $model->file->baseName . '.' . $model->file->extension); Yii::$app->session->setFlash('success', '文件已成功上传'); } else { Yii::$app->session->setFlash('error', '文件上传失败'); } } return $this->render('upload', ['model' => $model]); } } ``` 在`actionUpload`方法中，我们检查请求是否为POST，并实例化`UploadForm`模型。如果用户提交了文件，我们将文件实例化为`UploadedFile`对象，并通过调用`validate()`方法进行验证。如果验证通过，可以使用`saveAs()`方法将文件保存到服务器。在这个例子中，文件被保存到了`uploads`目录下，文件名由其基础名称和扩展名组成。 Yii2框架中的文件上传过程包括创建模型、视图和控制器，通过这三个部分协作完成文件的上传和验证。在实际项目中，你可能还需要添加更多的验证规则，以及处理文件的保存位置、大小限制、文件类型检查等细节。