質問をすることでしか得られない、回答やアドバイスがある。

15分調べてもわからないことは、質問しよう!

ただいまの
回答率

88.92%

Laravel Storage の put() と putFileAs() の違いがわからない。

解決済

回答 1

投稿 編集

  • 評価
  • クリップ 0
  • VIEW 272

takaoS

score 9

初歩的な質問ですみません。

LaravelのStorageのメソッドで、put() と putFileAs() の違いがよくわかりません。

公式ドキュメントの日本語訳(https://readouble.com/laravel/6.x/ja/filesystem.html)を見てみると、purFileAs()では自動ストリーミングを管理してくれると書いてあるのですが、よく意味がわからなくて...。

ストリーミングとは、YouTubeのように、少しずつデータをダウンロードしつつ、同時並行で動画を流すことだと思っているのですが、putFileAs()でも同じように、少しずつ画像をアップロードしてくれるということなのでしょうか?

その場合、画像をサーバにアップロードする点に関して、put()と比較してどのようなメリットがあるのでしょうか?

教えて頂けると嬉しいです。
よろしくお願いいたします。

  • 気になる質問をクリップする

    クリップした質問は、後からいつでもマイページで確認できます。

    またクリップした質問に回答があった際、通知やメールを受け取ることができます。

    クリップを取り消します

  • 良い質問の評価を上げる

    以下のような質問は評価を上げましょう

    • 質問内容が明確
    • 自分も答えを知りたい
    • 質問者以外のユーザにも役立つ

    評価が高い質問は、TOPページの「注目」タブのフィードに表示されやすくなります。

    質問の評価を上げたことを取り消します

  • 評価を下げられる数の上限に達しました

    評価を下げることができません

    • 1日5回まで評価を下げられます
    • 1日に1ユーザに対して2回まで評価を下げられます

    質問の評価を下げる

    teratailでは下記のような質問を「具体的に困っていることがない質問」、「サイトポリシーに違反する質問」と定義し、推奨していません。

    • プログラミングに関係のない質問
    • やってほしいことだけを記載した丸投げの質問
    • 問題・課題が含まれていない質問
    • 意図的に内容が抹消された質問
    • 過去に投稿した質問と同じ内容の質問
    • 広告と受け取られるような投稿

    評価が下がると、TOPページの「アクティブ」「注目」タブのフィードに表示されにくくなります。

    質問の評価を下げたことを取り消します

    この機能は開放されていません

    評価を下げる条件を満たしてません

    評価を下げる理由を選択してください

    詳細な説明はこちら

    上記に当てはまらず、質問内容が明確になっていない質問には「情報の追加・修正依頼」機能からコメントをしてください。

    質問の評価を下げる機能の利用条件

    この機能を利用するためには、以下の事項を行う必要があります。

質問への追記・修正、ベストアンサー選択の依頼

  • m.ts10806

    2020/07/11 07:46

    ちなみにreadoubleは「公式ドキュメント」ではないです。
    「公式を日本語訳したドキュメント」です。公式に近しいものであって公式はあくまで先に提示したlaravel.comです。

    キャンセル

  • takaoS

    2020/07/11 11:22

    そうなんですね、申し訳ないです。

    キャンセル

  • m.ts10806

    2020/07/11 11:24 編集

    私もteratailの回答で指摘されて認識したことなので、謝ることはないと思います。
    ただ、原文を結構正確に訳しているので、大きな問題はないと思ってます。

    キャンセル

回答 1

checkベストアンサー

0

この場合の「ストリーミング」というのは「書き込みたい内容をPHPの変数として一度にメモリ上に用意しなくていい」ぐらいの意味です。

そしてストリームサポートはマニュアルの少し手前のところに書かれているようにputにもあります。

putメソッドはファイル内容をディスクへ保存するために使用します。putメソッドにはPHPのresourceも渡すことができ、Flysystemの裏で動いているストリームサポートを使用します。

まずストリーミングでない場合はどういうものか説明します。put$contentsパラメタに送りたいファイルの中身を設定するのが基本の使い方で、例えば画像ファイルならいったんfile_get_contentsを使って全体を変数に読み込んでからputします。一度に全部メモリ上に読み込むのでメモリを食います。

$contents = file_get_contents('foo.jpg');
Storage::put('file.jpg', $contents);

ストリーミングの場合はどうなるかというと、ファイルを開いただけで中身は読み込まずにそのままリソースをパラメタとして渡します。こちらの場合は一度に中身を読み込まずに一定量ずつ読んでは書くようなことを裏で行ってくれるのでメモリの消費が抑えられます。

$resource = fopen('foo.jpg', 'r');
Storage::put('file.jpg', $resource);
fclose($resource);

そしてputFileAsはパラメタで与えたファイル名からfopenしてputしてfcloseという一連の流れを「自動」でやってくれます。実際ソースはこうなっています。これを「自動ストリーミング」と呼んでいるようです。

    /**
     * Store the uploaded file on the disk with a given name.
     *
     * @param  string  $path
     * @param  \Illuminate\Http\File|\Illuminate\Http\UploadedFile|string  $file
     * @param  string  $name
     * @param  array  $options
     * @return string|false
     */
    public function putFileAs($path, $file, $name, $options = [])
    {
        $stream = fopen(is_string($file) ? $file : $file->getRealPath(), 'r');

        // Next, we will format the path of the file and store the file using a stream since
        // they provide better performance than alternatives. Once we write the file this
        // stream will get closed automatically by us so the developer doesn't have to.
        $result = $this->put(
            $path = trim($path.'/'.$name, '/'), $stream, $options
        );

        if (is_resource($stream)) {
            fclose($stream);
        }

        return $result ? $path : false;
    }

投稿

  • 回答の評価を上げる

    以下のような回答は評価を上げましょう

    • 正しい回答
    • わかりやすい回答
    • ためになる回答

    評価が高い回答ほどページの上位に表示されます。

  • 回答の評価を下げる

    下記のような回答は推奨されていません。

    • 間違っている回答
    • 質問の回答になっていない投稿
    • スパムや攻撃的な表現を用いた投稿

    評価を下げる際はその理由を明確に伝え、適切な回答に修正してもらいましょう。

  • 2020/07/12 12:21

    なるほど、そういうことだったのですね。
    ご丁寧に解説いただきありがとうございました!

    キャンセル

15分調べてもわからないことは、teratailで質問しよう!

  • ただいまの回答率 88.92%
  • 質問をまとめることで、思考を整理して素早く解決
  • テンプレート機能で、簡単に質問をまとめられる

関連した質問

同じタグがついた質問を見る