composer 不处理动画或音频，仅管理 php 依赖；音频需作为静态资源手动添加或通过构建工具导入，并用 javascript（如 audio api）控制播放。
Composer 本身不处理动画或音频——它只是 PHP 的依赖管理工具。所谓“Composer 动画中添加背景音乐”，本质是混淆了工具链：你真正在做的，是在某个前端动画项目（比如用 Swiper、GSAP 或 Lottie）里集成音频，而 Composer 只负责帮你拉取 JS 库的依赖。
为什么 composer.json 里加不了背景音乐
Composer 管理的是 PHP 包，不是音频文件，也不是浏览器运行时资源。你在 composer.json 中写 "require": { "some/music-package": "^1.0" } 是无效的——没有这样的合法包源，PHP 社区也不提供音频分发服务。
- 音频必须作为静态资源（如
public/audio/bg.mp3）手动放入项目，或通过构建工具（Vite/Webpack）导入 - Swiper、GSAP 等动画库本身不带音频能力；播放音乐得靠
HTMLAudioElement、Howler.js或 Web Audio API - 试图用 Composer 下载 MP3 文件会触发安全限制，多数托管平台（Packagist）直接拒绝非代码类资源提交
如何在 Swiper 动画页里同步播放 BGM
假设你用 Composer 安装了 Swiper："swiper/swiper": "^8.4"，现在想让轮播开始时自动播放背景音乐，并随幻灯片切换淡入淡出——关键不在 Composer，而在 JS 初始化逻辑。
- 把音频文件放进
public/audio/目录，确保能被浏览器直接访问（路径如/audio/bgm.mp3） - 在 Swiper 初始化后创建
new Audio('/audio/bgm.mp3')实例，别用autoplay属性（现代浏览器禁止无用户交互的自动播放） - 监听
swiper.on('slideChange', () => { audio.currentTime = 0; audio.play(); })，但注意：每次play()都可能被策略拦截，需绑定到用户点击事件首次触发 - 淡出要用 Web Audio API 手动控制音量节点，HTMLAudioElement 的
volume属性无法做平滑过渡
常见错误：用 require 加载音频文件
有人尝试在 JS 中写 require('../audio/bgm.mp3') 或 import bgm from '../audio/bgm.mp3'，然后传给 Swiper——这不会报错，但结果往往是：
- Webpack/Vite 把 MP3 当作模块处理，生成 hash 路径（如
/assets/bgm.abc123.mp3），而 Swiper 初始化时仍用旧路径请求 404 - ESM import 返回的是一个字符串 URL，但没做 MIME 类型校验，某些安卓 WebView 会静默失败
- 音频加载未完成就调用
play()，抛出DOMException: The element has no supported sources
正确做法是显式检查 audio.readyState === 4 再播放，或用 audio.addEventListener('canplay', handler)。
真正需要 Composer 干的事只有一件
如果你选的是 howler 这类专业音频库（支持精灵音效、多声道、Web Audio 封装），才值得用 Composer 管理——但注意：Howler 是 JS 库，应通过 npm/yarn 安装；PHP 的 Composer 对它完全无感。
- 错误操作：
composer require howler/howler→ 不会成功，Packagist 上没有这个包 - 正确操作：
npm install howler，再在 JS 中import { Howl } from 'howler' - 若硬要用 Composer 加 JS 库（极不推荐），得配置
fxp/composer-asset-plugin，但它已废弃多年，兼容性差，且不支持 ES 模块
真正容易被忽略的点是：音频播放权限、跨域音频资源、以及 iOS Safari 对 play() 的额外限制（必须在 touchend 后 1s 内调用）。这些跟 Composer 没半点关系，但调试时最容易误判成“依赖没装好”。
