Tìm hiểu về File Storage của Laravel

Xem thêm tại: Tìm hiểu về File Storage của Laravel

Giới thiệu

  • Laravel cung cấp cho người dùng một giải pháp để quản lý file cực kỳ tiện lợi và hữu ích - đó là File Storage. Tính năng này bạn hoàn toàn có thể dùng trên các Framework khác vì nó là một package của Frank de Jonge. Bạn có thể xem package tại đây.
  • Với File Storage bạn có thể thao tác với các file ở local, Rackspace Cloud Storage và cả Amazon S3.

Config

  • Bạn có thể config File Storage tại file config/filesystems.php.
  • Driver mà Laravel hỗ trợ: "local", "ftp", "sftp", "s3", "rackspace".

Local

  • Để sử dụng và download các file trên web, bạn cần phải chạy lệnh sau để tạo ra một symbolic link trong thư mục public của Laravel: php artisan storage:link.
  • Mặc định, nó sẽ link đến đường dẫn storage/app/public. Bạn có thể config đường dẫn mà nó link đến tại dòng: 'root' => storage_path('app/public').
  • Để thao tác với thao trên web, bạn có thể dụng: asset('storage/filename');.
  • Để thao tác với file local, bạn có thể dùng Storage::disk('local')->put('file.txt', 'Contents');. Vì mặc định laravel sẽ dùng local nên bạn chỉ cần sử dụng Storage::put('file.txt', 'Contents');

S3 driver

Để lưu file lên Amazon S3 bạn cần install thêm package đó là:

Amazon S3: league/flysystem-aws-s3-v3 ~1.0`

Sau khi cài xong package, bạn cần config các thông số trong config/filesystems.php:

's3' => [
    'driver' => 's3',
    'key' => env('AWS_ACCESS_KEY_ID'),
    'secret' => env('AWS_SECRET_ACCESS_KEY'),
    'region' => env('AWS_DEFAULT_REGION'),
    'bucket' => env('AWS_BUCKET'),
    'url' => env('AWS_URL'),
],

FTP Driver

Bạn có thể sử dụng FTP Driver mà không cần thêm package giống như ở trên. Tuy nhiên, mặc định FTP sẽ không có sẵn trong config/filesystems.php. Để sử dụng FTP bạn phải thêm vào config/filesystems.php:

'ftp' => [
    'driver'   => 'ftp',
    'host'     => 'ftp.example.com',
    'username' => 'your-username',
    'password' => 'your-password',

    // Optional FTP Settings...
    // 'port'     => 21,
    // 'root'     => '',
    // 'passive'  => true,
    // 'ssl'      => true,
    // 'timeout'  => 30,
],

Thao tác với các disk

Như đã nói ở trên, mặc định ổ đĩa sẽ là local vì vậy nếu bạn muốn thao tác với Amazon S3 bạn sẽ cần sử dụng phương thức disk.

Mặc định:

Storage::put('avatars/1', $fileContents);

S3:

Storage::disk('s3')->put('avatars/1', $fileContents);

Rackspace

Storage::disk('rackspace')->put('avatars/1', $fileContents);

Thao tác với các file

Để lấy nội dung file:

$contents = Storage::get('file.jpg');

Để kiểm tra file có tồn tại không

Storage::exists('file.jpg');

Để lấy URL của file

$url = Storage::url('file1.jpg');

Lưu tạm file (chỉ hỗ trợ s3 và rackspace)

$url = Storage::temporaryUrl(
    'file1.jpg', now()->addMinutes(5)
);

File Metadata

Bạn có thể lấy thông tin của 1 file bằng cách sử dụng:

Storage::getMetaData('file.txt');

Lấy size:

$size = Storage::size('file1.jpg');

Lấy thời gian thao tác cuối

$time = Storage::lastModified('file1.jpg');

Copy và moving file

Storage::copy('old/file1.jpg', 'new/file1.jpg');
Storage::move('old/file1.jpg', 'new/file1.jpg');

Upload file

Chắc hẳn bạn đã từng làm qua tính năng upload file, hay ít nhất là upload avatar cho user hoặc thumbnail cho sản phẩm chẳng hạn. Laravel hỗ trợ bạn làm điều này một cách dễ dàng thông qua Request:

$path = $request->file('avatar')->store('public/avatars');

Hoặc thông qua Storage:

$path = Storage::putFile('avatars', $request->file('avatar'));

Lưu ý: mặc định với cách này Laravel sẽ lưu file dưới 1 unique name. Bạn có thể lấy filename bằng cách sử dụng:

$request->file('avatar')->hashName();

Upload dưới tên khác

Như cách ở trên thì Laravel sẽ tự động thêm tên cho file mà không trùng tên với các file có sẵn. Nhưng bạn cũng có thể lưu file với một tên tùy ý bằng cách sử dụng:

$path = $request->file('avatar')->storeAs(
    'avatars', $request->user()->id
);

Hoặc

$path = Storage::putFileAs(
    'avatars', $request->file('avatar'), $request->user()->id
);

Upload vào ổ đĩa khác

Ví dụ bạn muốn upload lên Amazon S3:

$path = $request->file('avatar')->store(
    'avatars/'.$request->user()->id, 's3'
);

Xóa file

Bạn có thể xóa file bằng cách sử dụng:

Storage::delete('file.jpg'); // Xóa 1 file
Storage::delete(['file1.jpg', 'file2.jpg']); // Xóa nhiều file

Hoặc xóa file trên Amazone S3:

Storage::disk('s3')->delete('folder_path/file_name.jpg');

Thao tác với thư mục

Lấy các file trong thư mục

$files = Storage::files('path');

Lấy tất cả các file con trong thư mục cùng với tất cả các file trong các thư mục con

$files = Storage::allFiles('path');

Tạo thư mục

Storage::makeDirectory('ten-thu-muc');

Xóa thư mục

Storage::deleteDirectory($directory);

Nguồn: https://laravel.com/docs/5.5/filesystem


All Rights Reserved