应通过请求头（如x-wx-source或Authorization: Bearer miniapp）精准识别小程序/H5来源，而非仅依赖User-Agent；上传文件需兼容多key，图片处理按端开关；返回路径统一拼接协议+域名；日志分端，核心逻辑（数据库、权限、支付验签）必须保持一致。
小程序端和H5端如何识别用户来源
微信小程序、公众号H5、PC浏览器访问同一套PHP后端时，必须先区分请求来源，否则登录态、跳转逻辑、数据格式都会错乱。$_SERVER['HTTP_USER_AGENT'] 是最直接的判断依据，但不能只靠关键词模糊匹配。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 小程序请求的
User-Agent中固定含MicroMessenger且不含MiniProgram字样；真正可靠的是检查请求头是否带sign或x-wx-source（需前端透传），或更稳妥地让小程序在Authorizationheader 中携带Bearer miniapp这类标识 - H5在微信内打开时也有
MicroMessenger，但通常带、<code>Language/等字段，而小程序没有；可结合$_SERVER['HTTP_X_WX_SOURCE']（若小程序主动设置）或自定义 header 如X-Client-Type: miniprogram - 避免用
strpos($_SERVER['HTTP_USER_AGENT'], 'MiniProgram')—— 微信官方从不往 UA 里写这个，这是常见误判源头
登录态与 session 如何跨端统一
小程序用 code2Session 换取 openid，H5用 JS-SDK 的 getUserInfo 或静默授权获取，两者 openid 不同（除非绑定 unionid），直接共用 session 会失效。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 不要依赖 PHP 默认的
session_start()做跨端登录态；改用 token 机制：登录成功后生成 JWT 或自定义加密 token，存入 Redis 并设 2 小时过期，key 为token:{token_hash} - 小程序登录后返回的
unionid（需公众号/开放平台绑定）才是跨端唯一标识，H5 授权时也必须拉取 unionid（需 scope 为snsapi_userinfo），否则无法对齐 - 如果业务允许降级，可对无 unionid 场景做映射表：用设备指纹（如
$_SERVER['HTTP_USER_AGENT'].substr($_SERVER['REMOTE_ADDR'], 0, 7)）临时关联，但仅限非关键流程
接口响应格式怎么适配不同端需求
小程序要求 JSON 返回字段严格、无 HTML 标签、时间戳用秒级；H5 可能需要富文本、相对路径图片、跳转链接等。同一接口硬塞所有字段，前端解析容易出错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 在入口统一加
$client = $_GET['client'] ?? $_POST['client'] ?? 'h5'，合法值限定为miniprogram/h5/pc，拒绝非法 client 请求 - 关键字段做条件输出：例如
'avatar_url' => $user['avatar'] . ($client === 'miniprogram' ? '@460w_460h_1e_1c' : '')，小程序 CDN 自动裁图，H5 不处理 - 错误码体系要分层：
40001表示小程序 code 无效，40002表示 H5 code 过期，不能全用400混淆，否则前端无法精准提示
文件上传和图片处理怎么避免端间冲突
小程序上传用 wx.uploadFile，参数是 filePath + name；H5 用 FormData，字段名可能是 file 或 image。后端若只认一个 key，必然失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 统一提取上传文件：检查
$_FILES['file']、$_FILES['media']、$_FILES['image']、$_FILES['upload_file']四个常见 key，任一存在即取，避免写死 - 图片压缩逻辑要按端开关：小程序上传前已在客户端压缩，PHP 后端收到后可跳过 resize；H5 上传原图，则需用
imagick或gd缩放至宽度 ≤750px，再存 WebP - 返回路径必须带协议：小程序要求
https://开头的完整 URL，H5 可用相对路径；统一用$_SERVER['REQUEST_SCHEME'] . '://' . $_SERVER['HTTP_HOST']拼接，别用__DIR__或硬编码域名
多端适配真正的难点不在判断，而在“哪些该分、哪些该合”——比如日志打点字段要分端记录，但数据库表结构、权限校验逻辑、支付回调验签流程，必须完全一致。一旦为某个端临时加 if 分支，后续维护成本会指数上升。
