Composer如何加载静态文件（配置技巧）-composer-PHP中文网

composer 不加载静态文件（css/js/图片等），因其 autoload 仅处理 php 类文件，psr-4、classmap、files 均跳过非 php 后缀，误配会拖慢构建、污染 classmap、引发运行时错误。

composer如何加载静态文件（配置技巧）

Composer 不会加载静态文件（CSS/JS/图片等），autoload 配置里写任何静态路径都无效——它只处理 PHP 类文件，强行塞进去只会拖慢 composer dump-autoload，还可能污染 classmap。

Composer 的 psr-4、classmap、files 三类 autoload 规则，底层只识别 PHP 可执行后缀（.php、.inc、.hh）。遇到 .css、.js、.svg 等文件，直接跳过，不解析、不映射、不生成路径条目。

"psr-4": {"Assets\": "public/css/"} → Composer 扫描 public/css/ 下所有 .php 文件（通常一个都没有），映射表为空，毫无作用
"classmap": ["public/css/"] → 会递归扫描该目录下所有 .php 文件（仍可能为零），但同时把 .js、.map 等无关文件路径也塞进 autoload_classmap.php，导致文件体积暴涨、OPcache 缓存效率下降
"files": ["public/js/app.js"] → 这个语法合法，但 app.js 不是 PHP 文件，运行时 require_once 直接报错：Fatal error: Uncaught Error: Failed opening required ...

这些写法看似“想让资源可访问”，实则破坏构建流程和部署效率：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

"psr-4": {"": "vendor/twbs/bootstrap/dist/"} —— 空命名空间前缀触发全目录扫描，数千个非 PHP 文件被遍历，composer install -o 卡死数分钟
"classmap": ["vendor/almasaeed2010/adminlte/"] —— 把整个 AdminLTE 包（>20MB）扫进 classmap，生成的 autoload_classmap.php 超过 8MB，OPcache 缓存失效频繁
"autoload-dev": {"files": ["vendor/ckeditor/ckeditor.js"]} —— files 在每次 Composer 启动时无条件 require_once，但 JS 文件无法执行，直接中断加载流程

核心原则：静态资源不走 autoload，只走 Web 服务器路径或构建工具链。

前端资源统一交给 npm 或 yarn 管理，安装到 resources/assets/，再由 Vite 或 Webpack 构建输出到 public/build/，PHP 项目通过 <link href="/build/app.css"> 引用
遗留项目必须用 Composer 装前端包（如 Yii1），则用 fxp/composer-asset-plugin，它会把 npm-asset/bootstrap 解压到独立目录（如 web/assets/bootstrap/），且自动过滤非 PHP 文件，不参与 autoload 扫描
若只是少量自定义 CSS/JS，手动复制到 public/css/ 或 public/js/，由 Web 服务器（Nginx/Apache）直接服务，PHP 层完全不感知其存在

别靠猜，查生成文件最准。先确保已执行 composer dump-autoload -o：

打开 vendor/composer/autoload_classmap.php，搜索你写的路径关键词（如 public/css）——如果出现，说明被 classmap 扫了，要删掉相关配置
打开 vendor/composer/autoload_psr4.php，检查是否有你声明的命名空间（注意末尾反斜杠："Assets\" ✅，"Assets" ❌）
运行 composer show --path vendor/twbs/bootstrap 看包实际位置，再确认你的 Web 服务器能否从该路径（如 /var/www/html/vendor/twbs/bootstrap/dist/css/）直接访问文件

真正容易被忽略的是：即使你删掉了 autoload 配置，旧的 autoload_classmap.php 仍可能残留无效路径——务必执行 composer dump-autoload 清空并重建，否则问题照旧。