ThinkPHP 的 append 方法不能传路由路径参数，仅能追加查询字符串参数；真正控制路径参数和查询参数应使用 url() 的 $vars 参数。
ThinkPHP 路由 append 方法到底能不能传额外参数？
不能直接靠 append 传“额外参数”——它只负责把当前 URL 查询参数（$_GET）自动拼进生成的路由 URL，不是用来手动塞新变量的接口。很多人以为 url('user/profile')->append(['token' => 'abc']) 能把 token 塞进路由路径或参数里，结果发现没生效，是因为 append 只影响查询字符串（?key=val），且仅在生成 URL 时起作用，不参与路由匹配和参数解析。
常见错误现象：append 后 URL 看似带了参数，但控制器收不到；或者用 Route::rule('u/:id','user/profile') 定义了路径参数，却试图用 append 往里塞 id，这根本不会覆盖路径段。
-
append是 URL 构建辅助方法，不是路由绑定机制 - 它追加的键值对最终只出现在查询字符串中（如
/u/123?token=abc），不影响:id这类路径参数的提取 - 若当前请求已有同名 GET 参数，
append会覆盖它（非合并）
想让路由 URL 包含动态变量，该用 url() 的第二个参数
真正控制路径参数和显式查询参数的地方，是 url() 函数的 $vars 参数（第二个）。它会按路由规则自动填充路径变量，并把剩余键值转为查询参数。
使用场景：你定义了 Route::rule('article/:id/:year','Article/read')，想生成 /article/100/2024?from=search，就得靠 $vars。
立即学习“PHP免费学习笔记（深入）”；
- 路径参数（如
:id,:year）必须作为$vars的键出现，否则无法生成合法路径 - 多余键（如
from）自动变成查询参数，等效于append，但更可控 - 如果路由是闭包或资源路由，
$vars同样生效，但需确保键名与路由变量名一致
示例：url('Article/read', ['id' => 100, 'year' => 2024, 'from' => 'search']) → /article/100/2024?from=search
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
append 和 $vars 混用时的优先级和坑
两者可以一起用，但 $vars 中的查询参数会优先生效，append 只补漏。容易踩的坑是重复传参导致覆盖或 URL 变长。
性能影响几乎为零，但逻辑混乱会导致调试困难——比如你在 $vars 里写了 'page' => 2，又 ->append(['page' => 5])，最终 URL 是 ?page=5，因为 append 内部做了 array_merge，后写入的覆盖先写的。
-
append不会过滤空值，传['q' => '']会生成?q=，可能触发后端非预期行为 - 若路由开启
url_html_suffix，append加的参数仍出现在.html之前，如/user/123.html?q=1，这是正常行为 - 在模板中多次调用带
append的url()，建议提前合并参数，避免分散维护
需要服务端接收“额外参数”，别只盯着 URL 构建
前端生成的 URL 带了参数，不代表控制器能直接用 input('token') 拿到——得看参数在哪、路由是否放行、中间件是否拦截。
常见错误：用了 append(['token' => 'abc'])，但控制器里 input('token') 返回 null，原因可能是：
- 路由规则设置了
complete_match或正则限制，把查询参数当成非法内容过滤了 - 开启了
url_common_param且未配置允许字段，token被默认丢弃 - 用了
Request::only()或显式白名单，漏掉了token
验证方式：直接打印 input() 全量数据，确认 token 是否在数组里；再查 config('app.url_common_param') 是否为 true，以及 config('app.url_params') 白名单。
事情说清了就结束
