Composer负责PHP后端依赖管理，Webpack通过Symfony Encore处理前端资源；两者通过package.json与composer.json分别声明依赖，并可通过Composer脚本自动执行前端构建，实现开发与生产环境的高效协同。
在Symfony Encore项目中，Composer 和 Webpack 分别负责 PHP 后端依赖与前端资源（如 JavaScript、CSS）的管理。虽然它们各自独立运行，但通过合理的配置和协作流程，可以实现统一、高效的工作流。关键在于明确职责边界，并让两者互补而非冲突。
理解职责划分：Composer 管后端，Webpack 管前端
Symfony 项目使用 Composer 来安装和管理 PHP 包，比如 Doctrine、Twig 扩展或第三方服务 SDK。这些是服务器端逻辑的一部分。而 Webpack（通过 Symfony Encore 封装）专注于前端资产处理——包括 JS 模块打包、CSS 编译（如 Sass）、图片优化等。
不要试图用 Webpack 去加载 PHP 类，也不要指望 Composer 能编译 JavaScript。清晰分工是协同工作的基础。
通过 package.json 统一前端依赖入口
Symfony Encore 使用 package.json 来声明前端依赖，就像 Composer 使用 composer.json 管理 PHP 依赖一样。你可以在同一个项目根目录下共存这两个文件，互不干扰。
立即学习“PHP免费学习笔记（深入）”；
例如，在 package.json 中添加一个 JS 库：
{
"devDependencies": {
"@symfony/webpack-encore": "^4.0",
"bootstrap": "^5.3.0",
"sass": "^1.69.5",
"sass-loader": "^13.0.0"
},
"scripts": {
"dev": "encore dev",
"watch": "encore dev --watch",
"build": "encore production"
}
}
运行 npm install 安装这些前端依赖，然后在你的入口 JS 文件中导入 Bootstrap：
// assets/app.js import 'bootstrap'; import '../scss/app.scss';
结合 Composer 脚本自动化构建流程
为了让开发体验更流畅，可以在 composer.json 中定义脚本，自动触发前端构建任务。这样每次执行 Composer 命令时，也能确保前端资源同步更新。
例如：
{
"scripts": {
"post-install-cmd": [
"@php bin/console assets:install",
"npm install",
"npm run build"
],
"post-update-cmd": [
"@php bin/console assets:install",
"npm install",
"npm run build"
]
}
}
这样当你在部署环境中运行 composer install 时，会自动安装前端依赖并构建静态资源，无需手动干预。
开发环境中的热重载与调试协同
本地开发时，建议分别启动两个进程：
- 使用 symfony server:start 或 php -S 运行 PHP 开发服务器
- 在另一个终端运行 npm run watch，启用 Webpack 的监听模式
Encore 默认会在开发模式下生成 manifest.json，Symfony 的 asset() 函数能正确读取该清单文件，确保页面引用最新的 JS/CSS 文件名（含哈希），避免缓存问题。
基本上就这些。Composer 和 Webpack 在 Symfony 项目中各司其职，只要配置得当，就能形成顺畅的统一工作流。不复杂但容易忽略的是脚本联动和环境适配细节。
