Yii フレームワークでのファイルのアップロードとダウンロード

Yii フレームワークは、強力な機能と豊富な拡張ライブラリを備えた非常に人気のある PHP フレームワークです。ファイルのアップロードとダウンロードは Web アプリケーションで非常に一般的なニーズであり、Yii フレームワークはこれらのタスクを処理するための便利で使いやすいソリューションを提供します。

Yii フレームワークでは、ファイルのアップロードとダウンロードの操作は、モデルクラスに関連付けられたビヘイビアーを通じて実装されます。この動作では、いくつかのパブリック メソッドとプロパティをグループ化して、それらを使用する必要があるクラスに簡単にアタッチできます。 Yii フレームワークは、ファイルのアップロードとダウンロードの動作を含む、多くの事前定義された動作を提供します。

ファイル アップロード

ファイル アップロードは Web アプリケーションの一般的なタスクの 1 つであり、多くのアプリケーションではユーザーがファイルをアップロードできるようにする必要があります。 Yii フレームワークには、ファイルのアップロードを処理するために使用できる FileUploadBehavior と呼ばれる動作があります。

FileUploadBehavior の動作では、パブリック プロパティを使用する前にモデル クラスで定義する必要があります。このプロパティは、アップロードされたファイルを保存するために使用されます。たとえば、file という名前のパブリック プロパティを含むモデル クラスを次に示します。

use yiidbActiveRecord;
use yiiwebUploadedFile;

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

FileUploadBehavior を使用するには、それをモデル クラスにアタッチします。コンストラクターは、いくつかの構成オプションを含む配列を提供する必要があります。ここにいくつかの重要なオプションがあります:

• 属性: アップロード先の属性の名前を指定します。これは上で定義したファイル属性です。
• 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 フレームワークのドキュメントを参照してください。

ファイルのダウンロード

ファイルのダウンロードも、Web アプリケーションの一般的なタスクです。ユーザーが特定のリソースまたはファイルをダウンロードできるようにしたい場合があります。 Yii フレームワークは、ファイルのダウンロードを処理するための FileDownloadBehavior と呼ばれる動作を提供します。

FileDownloadBehavior を使用するには、モデル クラスでパブリック プロパティを定義してファイル パスを保存する必要があります。次に、モデルに動作を追加します。 FileUploadBehavior と同様に、FileDownloadBehavior も次のようないくつかの構成オプションを提供する必要があります。

• 属性: ファイルのダウンロード元の属性名を指定します。
• basePath: ファイルのベース パス。
• forceDownload: ファイルをコンピュータにダウンロードするか、ブラウザ ウィンドウで開くかを決定します。

これは、FileDownloadBehavior を使用してモデルの $file プロパティからファイルをダウンロードする方法を示す例です: ダウンロードされたファイル。たとえば、次のコードは、$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,
            ],
        ];
    }

    // ...
}

コントローラーでは、FileDownloadBehavior によって提供される download() メソッドを使用して、ファイルをダウンロードできます:

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

結論

Yii フレームワークでは、ファイルのアップロードおよびダウンロードのタスクの処理は非常に簡単です。 FileUploadBehavior と FileDownloadBehavior という 2 つの動作を使用して、これらのタスクを処理できます。これらの動作により、自動検証、アップロード ファイルのサイズと種類の制限、ファイルのダウンロード オプションの設定など、さまざまなオプションと機能が提供されます。これらの Yii フレームワークが提供するツールを使用すると、ファイルのアップロードとダウンロードのタスクを簡単に実行でき、Web アプリケーションがより柔軟で強力になります。

以上がYii フレームワークでのファイルのアップロードとダウンロードの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。