WordPress主题中不可直接require vendor/autoload.php，否则会导致类重复声明或找不到；应通过classmap方式加载单个库或在after_setup_theme钩子中安全引入。

WordPress主题里直接require Composer自动加载会出问题

因为WordPress默认不执行vendor/autoload.php，主题里直接require 'vendor/autoload.php'看似能用，但会污染全局加载器——一旦两个插件/主题各自require自己的autoload.php，PHP会报Cannot redeclare class或Class not found。这不是你代码写错了，是PSR-4自动加载器被重复注册导致的。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

MFA WORD

强制使用密钥词进行 MFA 以访问敏感数据，支持超级密钥词紧急重置。

下载

• 永远不要在functions.php或模板文件里require 'vendor/autoload.php'
• 改用composer install --no-autoloader生成不含全局注册逻辑的autoload.php（需配合自定义加载）
• 更稳妥的做法：把vendor目录里的类全部重命名空间隔离，或只加载你需要的单个库（见下一条）

用classmap方式加载单一现代PHP库（如league/flysystem）

如果你只需要一个库（比如处理云存储），又不想碰全局autoload，classmap是最轻量、最可控的方式。它不依赖命名空间自动发现，而是把所有类路径硬编码进autoload_classmap.php，加载时只查表，不扫描目录，也不会和别的autoload.php冲突。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• 在主题根目录运行：composer require league/flysystem:^3.0 --no-scripts
• 编辑composer.json，添加：

  "autoload": { "classmap": ["vendor/league/flysystem/src/"] }

• 运行composer dump-autoload，生成vendor/composer/autoload_classmap.php
• 在主题functions.php中只require_once get_template_directory() . '/vendor/autoload.php';——这个autoload.php此时只负责载入classmap，不注册spl_autoload_register

psr-4映射到主题子目录时，命名空间必须与目录结构严格一致

想把src/MyTheme/Utils/Http.php映射为MyThemeUtilsHttp，不是靠文件名猜，而是靠composer.json里写的路径是否真实存在、大小写是否完全匹配。Windows开发机上不敏感，部署到Linux服务器就Class not found——因为src/mytheme/Utils/Http.php和MyThemeUtilsHttp根本对不上。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• composer.json中psr-4配置示例：

  "autoload": { "psr-4": { "MyTheme\": "src/" } }

• src/必须是主题根目录下的真实子目录，不能是inc/或lib/（除非你改映射）
• 类文件路径必须全小写对应命名空间层级，MyThemeUtilsHttp → src/Utils/Http.php，中间不能有utils/或HTTP.php
• 运行composer dump-autoload -o后检查vendor/composer/autoload_psr4.php内容，确认键值对正确

主题启用时才加载Composer类，避免后台/CLI环境失败

WordPress在wp-cron、WP-CLI、REST API请求中可能不加载主题的functions.php，但如果你在after_setup_theme钩子之外就require autoload.php，这些场景下会直接PHP Fatal error: Class 'X' not found。不是类没装好，是加载时机错了。

实操建议：

立即学习“PHP免费学习笔记（深入）”；

• 把require_once放到after_setup_theme或template_redirect钩子里（前者更早，后者确保前端上下文）
• 如果库要用于REST路由，额外加一层判断：

  if ( defined( 'REST_REQUEST' ) && REST_REQUEST ) { require_once ... }

• 永远用get_template_directory()而非__DIR__拼接vendor/autoload.php，否则子主题继承时路径失效

主题里用Composer不是“装完就能用”，关键在加载时机、命名空间落地路径、以及避开WordPress多上下文并行加载的陷阱。最容易被忽略的是：本地跑通 ≠ 服务器可用，因为Linux文件系统大小写敏感、CLI环境无主题上下文、甚至某些托管平台禁用spl_autoload_register。