本教程详细介绍了如何在Laravel应用中上传音乐文件，并利用laravel-getid3包提取ID3标签中的艺术作品（封面图）。文章将指导你如何正确地将音乐文件和提取的艺术作品存储到文件系统，并将它们的文件路径保存到数据库，确保封面图能够被正确读取和显示。
1. 理解音乐文件与艺术作品的存储需求
在开发音乐上传功能时，通常需要处理两个主要方面：
- 音乐文件本身： 这是音频数据，需要存储在服务器的文件系统中。
- 艺术作品（封面图）： 这是嵌入在音乐文件ID3标签中的图片，也需要提取并存储，以便在播放器或列表中展示。
本教程将使用owen-oj/laravel-getid3包来解析音乐文件的ID3标签，提取艺术作品数据，并利用Laravel的Storage门面进行文件存储。
2. 准备工作
在开始之前，请确保你的Laravel项目已安装并配置好laravel-getid3包。如果尚未安装，可以通过Composer进行安装：
composer require owen-oj/laravel-getid3
登录后复制
此外，为了能够通过公共URL访问存储的文件（包括音乐和封面图），你需要创建存储的符号链接：
php artisan storage:link
登录后复制
这将在public目录下创建一个名为storage的符号链接，指向storage/app/public目录。
3. 提取与存储艺术作品
laravel-getid3包提供了一个方便的方法getArtwork(true)来获取音乐文件的嵌入式艺术作品。此方法返回一个Artwork对象，其中包含艺术作品的二进制数据和文件类型信息。
以下是正确提取和存储艺术作品的步骤：
3.1 获取艺术作品二进制数据和扩展名
当调用$track-youjiankuohaophpcngetArtwork(true)时，你会得到一个Artwork对象。这个对象具有getBinary()方法用于获取图片内容的二进制数据，以及getExtension()方法用于获取图片的文件扩展名。
use Owenoj/LaravelGetID3/GetID3;
use Illuminate/Support/Facades/Storage;
use Illuminate/Http/UploadedFile; // 引入UploadedFile，以便类型提示更清晰
// 假设 $uploadedFile 是一个 Illuminate/Http/UploadedFile 实例
// 例如：$uploadedFile = $request->file('songs')[$key];
$track = new GetID3($uploadedFile);
$artwork = $track->getArtwork(true); // 获取 Artwork 对象
$thumbnailFileName = null; // 初始化封面图文件名
if ($artwork) {
$artworkBinary = $artwork->getBinary(); // 获取艺术作品的二进制数据
$artworkExtension = $artwork->getExtension(); // 获取艺术作品的推荐扩展名 (例如 'jpeg', 'png')
if ($artworkBinary && $artworkExtension) {
// 生成一个唯一的封面图文件名
$thumbnailFileName = 'artwork-' . time() . uniqid() . '.' . $artworkExtension;
// 使用Laravel的Storage门面存储二进制数据
// 存储到 public/sthumbs 目录下
Storage::disk('public')->put('sthumbs/' . $thumbnailFileName, $artworkBinary);
}
}
登录后复制
注意事项：
- 文件名生成： 务必为存储的艺术作品生成一个唯一的、不重复的文件名，以避免文件冲突。time() . uniqid()是一个常用的组合方式。
- 存储路径： Storage::disk(‘public’)->put(‘sthumbs/’ . $thumbnailFileName, $artworkBinary);会将文件存储到storage/app/public/sthumbs目录下。由于之前运行了php artisan storage:link，这些文件将可以通过your_app_url/storage/sthumbs/your_thumbnail_filename.ext访问。
4. 整合到音乐上传控制器
现在，我们将上述逻辑整合到你的音乐上传控制器中。以下是一个完整的示例，展示了如何同时处理音乐文件上传、ID3信息提取、艺术作品存储以及数据库记录。
<?php
namespace App/Http/Controllers;
use App/Models/MusicUpload; // 假设你的模型名为 MusicUpload
use Illuminate/Http/Request;
use Illuminate/Support/Facades/Auth;
use Illuminate/Support/Facades/Storage;
use Owenoj/LaravelGetID3/GetID3;
class MusicController extends Controller
{
/**
* 处理音乐文件及其艺术作品的上传。
*
* @param /Illuminate/Http/Request $request
* @return /Illuminate/Http/Response
*/
public function uploadMusic(Request $request)
{
// 验证上传文件
$request->validate([
'songs.*' => 'required|file|mimes:mp3,wav,ogg|max:20480', // 示例验证规则，最大20MB
]);
if ($request->hasFile('songs')) {
foreach ($request->file('songs') as $uploadedFile) {
// 初始化 getID3 实例
$track = new GetID3($uploadedFile);
$track->extractInfo(); // 提取所有信息
// 提取ID3元数据
$artistName = $track->getArtist();
$songName = $track->getTitle();
$albumName = $track->getAlbum();
$extension = $track->getFileFormat(); // 获取音乐文件的格式，例如 'mp3'
// --- 1. 存储音乐文件 ---
$musicFileName = time() . uniqid() . '.' . $extension;
// 将音乐文件存储到 storage/app/public/songs 目录下
$uploadedFile->storeAs('public/songs', $musicFileName);
// --- 2. 提取并存储艺术作品 (封面图) ---
$artwork = $track->getArtwork(true); // 获取 Artwork 对象
$thumbnailFileName = null; // 初始化封面图文件名
if ($artwork) {
$artworkBinary = $artwork->getBinary();
$artworkExtension = $artwork->getExtension();
if ($artworkBinary && $artworkExtension) {
$thumbnailFileName = 'artwork-' . time() . uniqid() . '.' . $artworkExtension;
// 将封面图的二进制数据存储到 storage/app/public/sthumbs 目录下
Storage::disk('public')->put('sthumbs/' . $thumbnailFileName, $artworkBinary);
}
}
// --- 3. 将文件信息保存到数据库 ---
$music_upload_record = new MusicUpload();
$music_upload_record->user_id = Auth::user()->id;
$music_upload_record->filename = $songName; // 存储歌曲标题
$music_upload_record->extension = $extension;
$music_upload_record->artistname = $artistName;
$music_upload_record->albumname = $albumName;
$music_upload_record->location = $musicFileName; // 存储音乐文件的实际文件名
$music_upload_record->thumbnail = $thumbnailFileName; // 存储封面图的实际文件名
$music_upload_record->save();
}
return redirect()->back()->with('success', '音乐文件上传成功！');
}
return redirect()->back()->with('error', '未选择任何音乐文件。');
}
}
登录后复制
重要提示：
- 模型字段： 确保你的MusicUpload模型包含user_id, filename, extension, artistname, albumname, `location
以上就是Laravel中存储音乐文件及其ID3标签艺术作品的教程的详细内容，更多请关注php中文网其它相关文章！