Composer 管理前端资产：配合 Asset Packagist 的平替使用-composer-PHP中文网

composer 不管理前端资产，需用其声明依赖并结合自定义脚本驱动构建流程；asset packagist 已停服，前端库在 packagist 上陈旧且不兼容现代工具链；应通过 composer.json 的 scripts 钩子调用 npm/vite 构建，并生成 php 可读的资产映射文件。

composer 管理前端资产：配合 asset packagist 的平替使用

Composer 本身不管理前端资产，Asset Packagist 也早已停止服务；所谓“平替”不是换一个包管理器，而是用 Composer 做依赖声明 + 手动或脚本驱动构建流程。

为什么不能直接用 `composer require` 安装前端库

Composer 的核心职责是管理 PHP 包及其 autoload、autoload-dev 和脚本钩子。它默认不下载 dist 目录下的 JS/CSS 文件，也不处理 node_modules 或构建产物。很多前端库（如 vue、lodash）在 Packagist 上的旧镜像已多年未更新，且无 ESM/UMD 兼容性保障。

Asset Packagist 的包本质是 Git 子模块快照 + 手动打包的 dist，与现代前端工具链脱节
composer install 不会触发 npm install 或 vite build
PHP 自动加载机制对 .js 文件无效，无法通过 use 引入前端模块

可行的平替方案：Composer 声明 + 自定义脚本驱动构建

利用 Composer 的 scripts 钩子，在 post-install-cmd 或 post-update-cmd 中调用 Node.js 工具链。关键在于把前端资产当作“构建产物”，而非“PHP 依赖”。

面向设计的AXUI前端框架表单

面向设计的AXUI前端框架表单是一款包含表格、列表、弹窗等的AXUI前端框架表单下载。

下载

在 composer.json 的 scripts 段添加：

"scripts": {
  "post-install-cmd": [
    "@build-assets"
  ],
  "post-update-cmd": [
    "@build-assets"
  ],
  "build-assets": "if [ -f package.json ]; then npm ci && npm run build; fi"
}

确保项目根目录存在 package.json 和 build 脚本（如 vite build 或 webpack --mode production）
输出目录（如 dist/）需被 Web 服务器直接可访问，不能放在 vendor/ 下

如何让 PHP 代码安全引用构建后的前端文件

硬编码路径或手动复制容易出错。推荐在构建后生成一个 PHP 可读的资产映射文件，比如 public/build/manifest.php：

<?php return [
  'app.js' => '/build/app-abc123.js',
  'style.css' => '/build/style-def456.css',
];

在构建脚本末尾加一行：echo "<?php return " . json_encode($manifest) . ";" > public/build/manifest.php
PHP 中用 require_once 'public/build/manifest.php' 获取真实路径，避免缓存失效问题
不要把 node_modules/ 提交进 Git，但要确保 package-lock.json 和构建产物（public/build/）受版本控制或 CI 重建

真正的难点不在怎么写脚本，而在于明确分层：Composer 管依赖声明和 PHP 生命周期，Node.js 管前端构建。混用时最容易忽略的是构建产物的部署路径是否被 Web 服务器正确路由，以及 manifest.php 是否在每次构建后被可靠覆盖。