composer install仅管理php依赖，不处理package.json等其他语言文件；跨语言项目应使用makefile、github actions等分层工具协调，而非硬塞npm install到scripts中。
composer install 不能当跨语言安装入口用
它只管 PHP 包，对 package.json、pyproject.toml 或 requirements.txt 完全无视——连文件名都不会扫一眼。硬在 composer.json 的 scripts 里塞 npm install 或 pip install，看似省事，实则埋雷：
- 命令执行顺序不可控，
npm install失败时，后续 PHP 相关脚本可能不运行，但错误被吞掉，日志里只显示“Script xxx handling the post-install-cmd event returned with error code 1” - CI 环境中常因路径权限问题（比如
node_modules写入失败）导致整个composer install中断，而真正该报错的是前端构建环节 -
vendor/和node_modules/混放或互相引用，会破坏隔离性，也增加部署包体积和安全风险
多语言项目该用什么调度 composer install
把 Composer 当成一个“子任务”，而不是总指挥。推荐用分层工具统一协调：
- Makefile：定义
make deps同时调用composer install --no-dev+cd assets && npm ci，每个步骤独立失败、独立日志 - GitHub Actions：在
steps中分开写run: composer install --no-dev和run: npm ci，便于单独重试和缓存控制 - 自定义 shell 脚本（如
./build.sh）：显式检查每个命令的$?，出错立即exit 1，不靠 Composer 自动链式容错
如果非要在 composer.json 里触发前端构建，至少写成："post-install-cmd": ["cd assets && npm ci && npm run build"]，用 && 保证前序失败不继续，并确保 assets/ 目录存在。
composer install 必须加的参数组合
默认行为在混合项目里大概率踩坑，这几个参数不是可选，是上线刚需：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
composer install --no-dev：跳过require-dev，避免phpunit、larastan等开发工具意外进生产环境 -
composer install -o（等价于--optimize-autoloader）：生成类映射，减少自动加载时的文件系统遍历，尤其影响首次请求性能 -
composer install --ignore-platform-reqs：仅调试用，比如本地 PHP 版本低于composer.lock要求时临时绕过校验；生产环境严禁使用
注意：--no-dev 不等于删掉 require-dev，它只是不装包，autoload-dev 的 PSR-4 规则仍保留在 autoloader 中——这点常被误认为“禁用了 dev 类自动加载”。
PHP 依赖和其他语言资源怎么共享路径
没有真正的“共享加载”，只有约定路径 + 构建时拷贝。关键不是让 Composer 管 JS/Python，而是让它知道输出在哪：
- 在
composer.json的extra字段声明目标路径："extra": {"frontend-dist": "public/build"} - 前端构建脚本（如 Webpack/Vite）读取该值，把产物写入
public/build/，而非默认的dist/ - PHP 模板里用配置驱动的 URL 生成器，比如 Laravel 的
@vite或自定义asset('build/app.js')，避免硬编码../node_modules/xxx/dist/xxx.js
最容易被忽略的一点：别把 node_modules/ 放进 vendor/，也别把 vendor/ 目录暴露给 Web 服务器——前者破坏依赖边界，后者是明确的安全漏洞。
