WordPress非原生支持Composer，主题/插件中需手动加载autoload.php并确保路径正确、时机优先；禁用allow_url_include不影响autoload；分发时勿提交vendor，应构建优化包；私有包需预配置GitHub Token；注意polyfill冲突与类存在性校验。

Composer 不是 WordPress 的原生依赖管理工具，直接在主题或插件里用 composer install 很容易出问题——核心原因在于 WordPress 没有统一的自动加载入口，且多数托管环境不开放 shell 权限，vendor/ 目录位置和加载时机极易失控。

WordPress 主题中引入 Composer 包：别把 vendor/ 放进主题目录

常见错误是把整个 vendor/ 提交到主题 Git 仓库，导致体积膨胀、更新困难、CI/CD 失效。更糟的是，有些开发者直接在 functions.php 里 require 'vendor/autoload.php'，但路径一变就报 Fatal error: Uncaught Error: Class not found。

• 正确做法：在主题根目录运行 composer init，安装包时加 --no-dev，然后在主题 functions.php 开头用绝对路径加载 autoload：

  require_once __DIR__ . '/vendor/autoload.php';

• 必须检查 wp-config.php 或服务器 PHP 配置是否禁用了 allow_url_include（不影响 autoload，但会影响某些旧式 require 写法）
• 如果主题要分发给他人，不要提交 vendor/；改用 composer install --no-dev --optimize-autoloader 后打包，或通过 GitHub Actions 自动构建发布包

插件开发中使用 Composer：用 composer.json 声明依赖，但加载逻辑自己控制

WordPress 插件没有像 Laravel 那样的服务提供者注册机制，autoload 配置里的 psr-4 映射不会自动生效，必须显式触发。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• 在插件主文件（如 my-plugin.php）头部立即加载：

  if (file_exists(__DIR__ . '/vendor/autoload.php')) {    require_once __DIR__ . '/vendor/autoload.php';}

• 避免在 plugins_loaded 钩子之后才加载 autoload，否则类可能在钩子回调中已提前被引用，导致 Class 'MonologLogger' not found
• 若使用私有包（如公司内部 SDK），务必在部署前运行 composer config -g github-oauth.github.com <token>，否则 CI 会卡在认证环节

与 WordPress 核心共存时的自动加载冲突：优先用 class_exists() 做防御性判断

某些 Composer 包（如 symfony/polyfill、paragonie/random_compat）会尝试声明已由 WordPress 核心提供的函数（如 hash_equals），导致 Cannot redeclare hash_equals() 致命错误。

• 不要盲目删掉 vendor/ 下的 polyfill，而是检查包的 autoload/files 是否引入了全局函数文件；可在 composer.json 中移除对应项，或用 "replace" 告知 Composer 这些功能已存在
• 在调用第三方类前加 if (class_exists('SomeVendor\Class')) { ... }，尤其在 admin_init 或 wp_ajax_* 回调中，避免缓存插件提前加载部分类引发冲突
• WordPress 6.0+ 已内置 wp_rand() 和 wp_hash_equals()，可考虑用 function_exists() 替代部分 polyfill 逻辑，减少 vendor 体积

真正麻烦的不是 Composer 装不上，而是它装上了却不知道该什么时候加载、加载几次、被谁覆盖。很多线上故障都源于某个插件悄悄 require_once 了另一份 autoload，结果命名空间映射错乱，debug 时看到的类名和实际加载的类根本对不上。