演示地址：http://www.songjiale.com/xcx/huanyin

下载地址：点击此处下载源码

🎵 悦音·灵动搜索 – 开源音乐搜索与播放器

一个干净、轻量的 PHP 音乐聚合搜索网站，基于 千千音乐 API，支持歌曲搜索、免费/付费标识、在线试听（免费歌曲完整播放 + 下载）、付费歌曲跳转原站。
前端采用浅色清新风格，响应式布局，内置音频播放器（支持进度拖动、音量调节、快进后退），无需数据库，开箱即用。

✨ 功能特性

• 🔍 歌曲搜索 – 输入歌名或歌手，即时返回相关歌曲列表（每页 10 首，自动分页）

• 🎼 歌曲详情 – 显示歌曲名称、歌手、免费/付费标签

• 🎧 智能播放

  • 免费歌曲：展示专辑封面（圆形旋转动画）、完整音频播放器（支持进度条、音量、快进后退）以及下载按钮

  • 付费歌曲：展示专辑封面、原站跳转链接，引导用户前往官方页面收听

• 🎚️ 仅显示免费 – 开关一键筛选，只展示免费歌曲

• 📱 响应式设计 – 适配电脑、平板、手机

• 🎨 现代 UI – 浅色渐变背景、毛玻璃效果、圆角卡片、流畅悬停动画

• ⚡ 高性能 – PHP 后端仅做 API 代理，前端异步加载，不阻塞页面渲染

📸 界面预览

🚀 快速开始

环境要求

• PHP 7.4+ （需启用 cURL 扩展）

• Web 服务器（Apache / Nginx / 本地 PHP 开发服务器均可）

安装步骤

1. 将本项目所有文件（仅一个 index.php）上传到你的网站根目录

2. 确保服务器可以访问外网（用于请求千千音乐 API）

3. 直接通过浏览器访问 index.php 即可使用

无需任何配置，也无需数据库，文件即程序。

本地测试（PHP 内置服务器）

php -S localhost:8000

然后打开浏览器访问 http://localhost:8000

🛠️ 技术栈

• 后端：PHP（原生 cURL 请求 API）

• 前端：HTML5 / CSS3 / JavaScript (ES6) / Fetch API

• 图标库：Font Awesome 6

• 音频处理：HTML5  元素 + 自定义控制条

📡 API 说明

项目使用第三方免费音乐 API：

https://api.cenguigui.cn/api/music/qianqian_music.php

• 搜索歌曲：?msg=关键词

• 获取单曲详情：?msg=关键词&n=序号

返回 JSON 格式，代码已做完整错误处理（网络超时、解析失败、空数据等均会友好提示）。

注意：该 API 由第三方提供，免费歌曲可获取完整 music_url 用于播放和下载；付费歌曲仅返回封面和官方链接。

📂 目录结构

/
└── index.php          # 唯一入口，包含所有逻辑（搜索、列表、播放页）

⚙️ 自定义修改

• 修改 API 地址：编辑 index.php 开头的 define('API_BASE_URL', ...)

• 修改每页显示数量：找到 pageSize = 10（前端 JS 变量）并修改

• 更换网站 Logo：替换 http://www.songjiale.com/img/logo.png 为自己的图片链接

• 调整配色：修改 CSS 中的渐变背景、按钮颜色等

⚠️ 注意事项

1. 本程序仅供学习和个人使用，请勿用于商业用途或大量抓取 API 资源。

2. 所有音乐版权归原始权利人所有，本项目仅做技术展示，不存储任何音乐文件。

3. 第三方 API 可能随时失效或限制访问，请自行承担使用风险。

4. 由于浏览器的安全策略，部分音频自动播放可能被阻止，用户需手动点击播放按钮。

📄 开源协议

本项目采用 MIT 许可证。
你可以自由使用、修改、分发，但需保留原作者的版权声明。

🤝 贡献与反馈

如果你有改进建议或发现了 Bug，欢迎提交 Issue 或 Pull Request。