不想手动整理歌单？用 getID3 这个 PHP 音频解析库把 MP3 标签自动读出来

【免费下载链接】getID3项目地址: https://gitcode.com/gh_mirrors/ge/getID3

做音乐类网站、写本地播放器，或者只是想把硬盘里上千首散乱的 MP3 重新归档，第一步几乎都是同一个问题：怎么拿到每首歌的歌手、标题、比特率和时长？如果靠一个个右键查看属性，几百个文件就能让人崩溃。我的解决思路是找一款开源的 PHP 音频解析库，把这件事交给代码。而 getID3，就是我试过之后一直在用的那个。

它到底是个什么"角色"？

简单说，getID3 是一个专门跟多媒体文件"打交道"的 PHP 库。它最出名的地方，是把 MP3 文件里 ID3v1、ID3v2 这些藏在文件头尾的元数据解析出来——就像把压缩包的目录结构解压给你看，你能一眼看到里面装着什么。

但别被名字骗了，它远不止会读 MP3：

也就是说，一个库几乎把常见的音视频、图片和压缩包格式全包圆了。更难得的是它完全开源免费，采用 GPL / LGPL / MPL 多重许可，商用前挑一个合适的条款即可，版权上没有后顾之忧。

开工之前，先办这两件小事

第一件事：把代码拿到本地。直接在终端执行：

git clone https://gitcode.com/gh_mirrors/ge/getID3

第二件事：确认环境达标。项目对运行环境相当宽容，PHP 5.3.0 以上版本就能跑（见根目录composer.json），内存建议至少 8MB。如果你的服务器连 PHP 环境都还没装，那先解决环境问题再回来也不迟。

小贴士：装好后可以先访问demos/demo.browse.php，它会生成一个可视化页面，让你直观看到解析某个文件后到底返回了哪些数据，比看文档更直观。

三行核心代码，读出歌手和标题

整个解析流程精简到极致，核心就三步。参照项目里的 demos/demo.basic.php：

require_once('getid3/getid3.php'); // 引入主类 $getID3 = new getID3; // 创建解析引擎 $info = $getID3->analyze('song.mp3'); // 分析目标文件

analyze()跑完之后，$info就是一个装着海量信息的多维数组。不过这里有个小细节：ID3v2 和 ID3v1 的标签是分开存放的，直接取值会比较绕。项目提供了CopyTagsToComments()方法，把各格式的标签汇总到同一个位置，取数就清爽多了：

$getID3->CopyTagsToComments($info); echo $info['comments_html']['artist'][0]; // 歌手 echo $info['comments_html']['title'][0]; // 标题 echo round($info['audio']['bitrate'] / 1000) . ' kbps'; // 比特率 echo $info['playtime_string']; // 播放时长

注意comments_html下的字段是数组，因为一首歌可能同时存在多个标签来源，取第一个通常就够了。另外，返回的键不一定都存在，取值前用isset()或empty()判断一下更稳妥。

一张表看懂常用返回字段

解析结果到底长什么样？下表是最高频用到的几个位置：

更完整的返回结构可以查阅项目根目录的structure.txt，或者用print_r($info)直接把整个数组打印出来，一目了然。

批量玩法：一个循环扫完整个文件夹

单文件解析只是开胃菜，真正爽的是批量处理。比如给整个音乐目录生成一份资料清单：用opendir()遍历目录，对每个文件调用一次analyze()，把结果拼成表格输出即可。demos/demo.simple.php 就是这个思路的完整示例，输出"文件名、歌手、标题、比特率、时长"五列信息。

要是目录里还套着子目录，想要递归扫描、甚至把结果存进数据库做检索，项目里也有现成的参考：demos/demo.dirscan.php 演示目录批量解析，demos/demo.mysql.php则展示了配合数据库做递归扫描和后续维护的玩法。

还有一点对大文件很友好：getID3 采用分段读取的方式，不会把整个文件一次性塞进内存，几十上百 MB 的音频也能从容解析。

反向操作：给音频写标签

能读元数据当然也就能写。项目把写入能力单独放在getid3/write.*.php系列模块里，支持 ID3v1、ID3v2、VorbisComment、APE 等标签的写入，其中 ID3v2 还支持 v2.3 和 v2.4 两个版本。想批量把"歌手/专辑/曲目"写回文件？demos/demo.write.php 提供了完整示例，直接抄作业即可。

高频疑问快问快答

Q：除了 MP3，其他格式能解析吗？A：能。音频方面有 FLAC、AAC、WAV 等 20+ 种格式，每个格式对应getid3/目录下一个module.audio.*.php模块，比如 getid3/module.audio.mp3.php、module.audio.flac.php，需要排查具体格式问题时直接翻对应模块即可。

Q：解析出错了怎么办？A：留意返回数组里的error和warning两个键。error有内容说明文件没被正确解析，返回的数据不可靠；只有warning说明数据基本可用，多半是文件本身有些小瑕疵被库兼容处理了。

Q：想分析远程 URL 上的音频？A：不能直接把 URL 丢给analyze()，需要先把远程文件下载到本地临时文件再解析，这也是流式读取特性下的标准姿势。

写在最后

从单文件读标签，到目录批量扫描，再到反向写标签，getID3 这套 PHP 音频解析库基本覆盖了音乐元数据处理的全部日常需求。如果你想用它整理本地歌单，或者给项目加一个"自动读取音频信息"的功能，不妨从analyze()三行代码开始，半小时内就能看到第一份解析结果。上手之后你就会发现，整理歌单这件事，真的可以交给代码。

【免费下载链接】getID3项目地址: https://gitcode.com/gh_mirrors/ge/getID3