Yii框架中的檔案上傳與下載

Yii框架是一個非常流行的PHP框架，具有強大的功能和豐富的擴充庫。在網路應用程式中，檔案上傳和下載是非常常見的需求，而Yii框架提供了方便且易用的解決方案來處理這些任務。

在Yii框架中，檔案上傳和下載操作是透過附加到模型類別的行為來實現的。行為是將一些公共方法和屬性集中在一起，然後可以輕鬆地將它們附加到需要使用它們的類別中。 Yii框架提供了許多預先定義的行為，包括檔案上傳和下載行為。

檔案上傳

檔案上傳是Web應用程式中常見的任務之一，許多應用程式都需要允許使用者上傳檔案。 Yii框架中有一個名為FileUploadBehavior的行為可用來處理檔案上傳。

FileUploadBehavior行為要求在使用它之前在模型類別中定義一個公共屬性。這個屬性將用於儲存上傳的檔案。例如，以下是一個包含一個名為file的公共屬性的模型類別：

use yiidbActiveRecord;
use yiiwebUploadedFile;

class Post extends ActiveRecord
{
    public $file;
    // ...
}

要使用FileUploadBehavior，將其附加到模型類別。建構函數需要提供一個包含一些配置選項的陣列。以下是一些重要選項：

• attribute：指定要上傳到的屬性名稱，這裡是上面定義的file屬性。
• filePath：上傳檔案的目錄路徑。

use yiidbActiveRecord;
use yiiwebUploadedFile;
use yiiehaviorsTimestampBehavior;
use yiiehaviorsBlameableBehavior;
use yiiehaviorsFileUploadBehavior;

class Post extends ActiveRecord
{
    public $file;

    public function behaviors()
    {
        return [
            TimestampBehavior::class,
            BlameableBehavior::class,
            [
                'class' => FileUploadBehavior::class,
                'attribute' => 'file',
                'filePath' => '@app/web/uploads/[[filename]].[[extension]]',
            ],
        ];
    }

    // ...
}

現在，透過在模型中使用load()方法，上傳的檔案將自動儲存到$file屬性中：

$post = new Post();
$post->load(Yii::$app->request->post());

if ($post->save()) {
    $filePath = $post->file->saveAs();
    // ...
}

FileUploadBehavior也提供了其他有用的選項，例如限製檔案類型、最大檔案大小等等。詳細資訊可以查看Yii框架文件。

檔案下載

檔案下載也是常見的網頁應用程式任務。有時，您希望使用者能夠下載特定資源或檔案。 Yii框架提供了一個名為FileDownloadBehavior的行為來處理檔案下載。

要使用FileDownloadBehavior，需要在模型類別中定義一個公共屬性來儲存檔案路徑。接下來，將行為加入模型中。與FileUploadBehavior相似，FileDownloadBehavior也需要提供一些設定選項，包括：

• attribute：指定要從中下載檔案的屬性名稱。
• basePath：檔案的基本路徑。
• forceDownload：確定是將檔案下載到電腦還是在瀏覽器視窗中開啟檔案。

下面是一個範例，展示如何使用FileDownloadBehavior從模型的$file屬性下載檔案：

use yiidbActiveRecord;
use yiiwebUploadedFile;
use yiiehaviorsTimestampBehavior;
use yiiehaviorsBlameableBehavior;
use yiiehaviorsFileUploadBehavior;
use yiiehaviorsFileDownloadBehavior;

class Post extends ActiveRecord
{
    public $file;
    public $filename;

    public function behaviors()
    {
        return [
            TimestampBehavior::class,
            BlameableBehavior::class,
            [
                'class' => FileUploadBehavior::class,
                'attribute' => 'file',
                'filePath' => '@app/web/uploads/[[filename]].[[extension]]',
            ],
            [
                'class' => FileDownloadBehavior::class,
                'attribute' => 'filename',
                'basePath' => '@app/web/uploads',
                'forceDownload' => true,
            ],
        ];
    }

    // ...
}

現在，可以透過$file屬性或在視圖中使用URL來指定要下載的檔案。例如，以下程式碼示範如何為$file屬性建立一個下載連結：

<?= Html::a('Download', ['post/download', 'id' => $model->id], ['target' => '_blank']) ?>

在控制器中，可以使用FileDownloadBehavior提供的download()方法進行檔案下載：

public function actionDownload($id)
{
    $model = $this->findModel($id);
    return $model->download();
}

#結論

在Yii框架中，處理檔案上傳和下載任務非常簡單。可以使用FileUploadBehavior和FileDownloadBehavior兩個行為來處理這些任務。這些行為提供了各種選項和功能，例如自動驗證、限制上傳檔案大小和類型以及設定檔案下載選項。透過使用這些Yii框架提供的工具，可以輕鬆完成文件上傳和下載任務，使Web應用程式更加靈活和強大。

以上是Yii框架中的檔案上傳與下載的詳細內容。更多資訊請關注PHP中文網其他相關文章！