这个扩展包允许你给文件生成一个下载链接,安装以后,你可以执行以下操作:
$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