TP5中微信类需按命名空间规范放入extend目录，封装load_wechat函数实现动态配置，接收微信消息必须首行读取php://input，支付回调须解析XML并校验签名后返回success。
TP5 的 extend 目录怎么放微信类文件才不报错
直接把第三方微信 SDK（比如 Overtrue/Wechat 或自定义的 WxPay.Api.php）扔进 extend/ 就跑不起来，核心原因是 TP5 不自动加载 extend 下的非命名空间类，且路径解析容易断。
正确做法是：所有类文件必须带命名空间，且目录结构要与命名空间严格对应。例如，你想用 WxPay，就建 extend/wxpay/lib/WxPay.Api.php，并在文件顶部写 namespace wxpay\lib;；然后在控制器里用 use wxpay\lib\WxPayApi; 引入。
常见错误现象：
-
Class 'wxpay\lib\WxPayApi' not found：没加命名空间，或命名空间和目录名大小写不一致（Linux 服务器敏感） -
require_once(): failed to open stream：硬编码了相对路径如../lib/WxPay.Config.php，应改用EXTEND_PATH . 'wxpay/lib/WxPay.Config.php' - 类中调用
new WxPayConfig()却没use，或配置类没加public属性导致实例化失败
如何在 TP5 中封装一个可复用的 load_wechat 助手函数
TP5.0 没有 Facade 支持，靠全局函数最稳；TP5.1+ 虽支持，但微信配置常需动态切换（比如多公众号），静态初始化反而僵硬。
推荐在 app/common.php 里加这个函数：
use think\Config;
use Wechat\Loader;
function &load_wechat($type = '') {
static $wechat = [];
$index = md5(strtolower($type));
if (!isset($wechat[$index])) {
$config = Config::get('wechat.' . $type);
$config['cachepath'] = RUNTIME_PATH . 'wechat_cache/';
$wechat[$index] = Loader::get($type, $config);
}
return $wechat[$index];
}
关键点：
Wechat MP Article Stats Comments Suite - 微信公众号管理套件
下载
公众号运营：文章发布至草稿、样式封面、评论与用户管理、数据统计等。用户要求将 Markdown 发送到公众号草稿、查看阅读量统计或类似后台操作时，使用本技能。
-
$config必须从config/wechat.php读取，不能硬编码——否则换环境要改代码 -
cachepath一定要设为可写路径，且不能是CACHE_PATH（TP5.1+ 已废弃该常量） - 返回用
&$wechat[$index]是为了支持链式调用，比如load_wechat('mp')->user->get(...) - 若用
Overtrue/Wechat，则不用Loader，改用EasyWeChat\Factory::officialAccount($config)
为什么 file_get_contents('php://input') 在 TP5 路由里总为空
因为 TP5 默认对 POST 请求做了 input() 解析，会提前消费 php://input 流，再调 file_get_contents('php://input') 就只剩空字符串——这对接收微信 XML 消息是致命的。
解决办法只有两个：
- 在入口控制器方法开头立刻执行
$raw = file_get_contents('php://input');，**不要**先调任何$this->request->post()或input() - 或者更彻底：把微信消息入口路由设为「不经过中间件」，在
route.php里加Route::any('wechat', 'index/Wechat/handle')->option(['middleware' => []]);
漏掉这点，$app->server->serve() 就收不到原始 XML，后续所有逻辑都失效，但错误不会抛出，只会静默失败。
微信支付回调里 $_POST 为什么拿不到数据
微信支付异步通知发的是 XML，不是表单，所以 $_POST 永远为空。必须用 file_get_contents('php://input') 读原始体，再用 simplexml_load_string() 解析。
典型错误写法：
// ❌ 错误：以为是普通表单
$data = input('post.');
// ✅ 正确：强制读原始输入
$xml = file_get_contents('php://input');
if (!$xml) {
exit('fail'); // 微信要求必须返回 'fail' 或空响应
}
$array = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true);
另外注意：
- TP5 的
input()函数对 XML 输入无感知，别指望它能自动转数组 - 解析后必须校验
sign字段，微信文档明确要求「未校验签名的回调一律视为无效」 - 处理完必须立即
echo 'success'并exit，多一个空格、换行或日志输出都会让微信重试
php://input）只能读一次，且必须在框架任何请求解析动作之前完成**。一旦错过时机，后续补救成本远高于前期设计。 
