composer本身不管理css/js依赖，仅负责php包；前端资源应由npm/yarn管理，通过构建工具（如vite/webpack）打包后输出至public目录，再由php模板引用最终路径，实现职责分离与可控串联。
Composer 本身不管理 CSS/JS 依赖，它只管 PHP；前端资源必须交给 npm 或 yarn —— 这不是权宜之计，而是生态边界决定的。强行让 Composer 下载 jQuery 或 Bootstrap 的 min.js，只会带来路径混乱、版本漂移、构建不可控等问题。
为什么不能直接用 Composer 安装 JS/CSS 文件
Composer 的设计目标是解决 PHP 类自动加载、扩展兼容性、语义化版本约束等后端问题。它没有内置对浏览器环境、模块解析（ESM/CommonJS）、Tree-shaking、CSS 预处理的支持。当你执行 composer require npm-asset/bootstrap：
- 下载的是原始源码（含
package.json、src/、dist/），不是可直接部署的产物 - 文件散落在
vendor/npm-asset/bootstrap/，路径不统一，无法被 Web 服务器直接访问 - 依赖声明（如 Bootstrap 依赖 Popper）仅在 Composer 层表达，浏览器里仍需手动管理
<script></script>加载顺序 - Asset Packagist 已停止维护，
fxp/composer-asset-plugin不再兼容 Composer 2.2+，且官方明确不推荐
npm install 和 composer install 必须分步执行，但可以串联
正确做法是保留两个独立的依赖描述文件和安装流程，再通过脚本桥接。关键不是“融合”，而是“可控串联”：
如果你了解HTML，CSS和JavaScript，您已经拥有所需的工具开发Android应用程序。本动手本书展示了如何使用这些开源web标准设计和建造，可适应任何Android设备的应用程序 - 无需使用Java。您将学习如何创建一个在您选择的平台的Android友好的网络应用程序，然后转换与自由PhoneGap框架到一个原生的Android应用程序。了解为什么设备无关的移动应用是未来的潮流，并开始构建应用程序，提供更
-
composer.json只写 PHP 依赖（如monolog/monolog、laravel/framework） -
package.json放在resources/js/或frontend/子目录下，写前端依赖（如vue、axios、tailwindcss） - 在
composer.json的scripts中调用 npm，但必须加判断逻辑，避免开发时重复构建：
"scripts": {
"post-install-cmd": [
"if [ -f 'package.json' ] && [ \"$APP_ENV\" = \"production\" ]; then cd frontend && npm ci && npm run build; fi"
],
"post-update-cmd": [
"if [ -f 'package.json' ] && [ \"$APP_ENV\" = \"production\" ]; then cd frontend && npm ci && npm run build; fi"
]
}
- CI/CD 脚本中也应显式分步：
composer install --no-dev --optimize-autoloader→cd frontend && npm ci && npm run build
PHP 模板里引用什么路径，决定了你是否真做到了解耦
模板中绝不能出现 /vendor/npm-asset/bootstrap/dist/css/bootstrap.min.css 这类路径。真正可维护的做法是：
- 前端构建产物输出到
public/build/（Laravel Mix 默认）或public/assets/（自定义 Webpack） - PHP 视图中只引用最终静态路径，例如：
<link rel="stylesheet" href="/build/app.css"> - 如果使用 Yii2 的 Asset Bundle，
sourcePath应指向@app/web/build，而非vendor/下任意子目录 - 不要把
node_modules/提交进 Git，但必须提交package-lock.json和composer.lock—— 二者锁定的是不同维度的确定性
最易被忽略的一点：前端构建命令（如 npm run build）的输出目录，必须与 Web 服务器配置的 document root + URI 路径完全对齐。哪怕只是多了一个 dist/ 嵌套层级，就会导致 404 —— 这个错误不会在 Composer 或 npm 安装阶段暴露，而是在第一次打开页面时才浮现。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
