新闻中心

记录团队成长点滴以及对技术、理念的探索,同时我们乐于分享!

laravel-download-link生成下载链接

2020-09-14 10:31:13 分类:技术学堂

这个扩展包允许你给文件生成一个下载链接,安装以后,你可以执行以下操作:


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->generate();

// zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe


默认下载路由在配置文件(config/download.php)里设置为”download”, 因此,你的域名如果是”example.com”, 则你的文件下载链接为如下这个链接:


example.com/download/{link}


// For example

example.com/download/zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe


注意:您应将 {link} 替换为生成的链接。



安装


你可以通过 composer 安装扩展包:


composer require armancodes/laravel-download-link

你可以使用下面的命令发布和执行数据库迁移:


php artisan vendor:publish --provider="Armancodes\DownloadLink\DownloadLinkServiceProvider" --tag="migrations"


php artisan migrate


这个扩展包允许你生成文件的下载链接。


安装后,你可以执行以下操作:


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->generate();

// zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe

配置文件中的默认下载路由为「download」,所以如果你的域名是「example.com」,则应使用此链接:


example.com/download/{link}


// 例如

example.com/download/zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe

注意: 你需要将 {link} 替换成生成的链接。


你可以使用以下命令发布配置文件:


php artisan vendor:publish --provider="Armancodes\DownloadLink\DownloadLinkServiceProvider" --tag="config"

这是已发布的配置文件的内容:


return [

    /*

    |--------------------------------------------------------------------------

    | Download Route

    |--------------------------------------------------------------------------

    |

    | Download route will be added to your app URL for using download links.

    | E.g. if your app URL is "example.com", then if your set the download route to

    | "download" it will be "example.com/download/{link}".

    |

    */

    'download_route' => 'download',

];

使用

你可以使用给定名称显式设置要保存和下载的文件名:


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->fileName('new-text.txt')->generate();

还可以添加过期时间,以便仅在链接过期之前可用:


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->expire(now()->addDay())->generate();

你还可以指定是否只有经过身份验证的用户或游客才能使用该链接:


// 仅通过身份验证的用户

$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->auth()->generate();


// 仅游客

$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->guest()->generate();

你可以将一个或多个 IP 地址放入黑名单 (下载链接不适用于这些 IP 地址):


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->limitIp('127.0.0.1')->generate();


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->limitIp(['127.0.0.1', '127.0.0.2', '127.0.0.3'])->generate();

或者,您可以将一个或多个 IP 地址放入白名单 (下载链接仅适用于这些 IP 地址):


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->allowIp('127.0.0.1')->generate();


$link = DownloadLink::disk('public')->filePath('uploads/test.txt')->allowIp(['127.0.0.1', '127.0.0.2', '127.0.0.3'])->generate();

配置文件中的默认下载路由为「download」,所以如果你的域名是「example.com」,则应使用此链接:


example.com/download/{link}


// 例如

example.com/download/zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe

注意: 你需要将 {link} 替换成生成的链接。


你可以这样删除一个链接:


DownloadLink::delete('link');


// For example

DownloadLink::delete('zkTu70fieUFZLGMoEP95l1RQfFj5zCOqHlM0XBTnc6ZaZTtm4GY5xPXGGLzLEAVe');

你可以使用以下命令删除数据库中的过期链接:


php artisan download-links:remove-expired