README

ThinkPHP 8 跳转与重定向扩展包，兼容 PHP 8.4+，内置现代美观的跳转页面模板，支持明暗主题自适应。

安装

composer require xvv/think-jump

使用

在控制器中引入并使用 Jump Trait：

<?php
namespace app\controller;

use xvv\think\Jump;

class Index extends BaseController
{
    use Jump;

    public function index()
    {
        // 操作成功，跳转到首页
        $this->success('登录成功', '/index/home');

        // 操作失败，返回上一页
        $this->error('用户名或密码错误');

        // AJAX 请求成功
        $this->success('保存成功', null, ['id' => 100]);

        // 直接重定向
        $this->redirect('/user/profile');

        // API 接口返回
        $this->result(['list' => []], 0, '查询成功');
    }
}

方法说明

success($msg, $url, $data, $wait, $header)

操作成功跳转。

error($msg, $url, $data, $wait, $header)

操作失败跳转。$url 为 null 时：AJAX 请求返回空字符串，普通请求返回 javascript:history.back(-1)。

result($data, $code, $msg, $type, $header)

直接封装并返回 API 数据，不走页面跳转。

返回数据格式：

{
    "code": 0,
    "msg": "查询成功",
    "time": 1743475200,
    "data": [...]
}

redirect($url, $code, $with)

HTTP 重定向。

配置

发布配置文件：

php think service:discover
php think vendor:publish

或在 config/ 目录下手动创建 jump.php：

<?php
// config/jump.php
return [
    // 成功跳转页模板路径
    'dispatch_success_tpl' => app()->getRootPath() . '/vendor/xvv/think-jump/src/tpl/success.html',
    // 失败跳转页模板路径
    'dispatch_error_tpl'   => app()->getRootPath() . '/vendor/xvv/think-jump/src/tpl/error.html',

    // 成功响应 code 值
    'default_success_code' => 0,
    // 失败响应 code 值
    'default_error_code'   => 1,

    // 成功跳转等待秒数
    'default_success_wait' => 3,
    // 失败跳转等待秒数
    'default_error_wait'   => 3,

    // 默认输出类型（非 AJAX 请求）
    'default_return_type'  => 'html',
    // AJAX 请求默认返回格式，支持 json / jsonp / xml
    'default_ajax_return'  => 'json',
];

模板说明

内置跳转模板 success.html 和 error.html 支持：

• 响应式布局，适配移动端
• 明暗主题自动切换（跟随系统偏好）
• 自动倒计时跳转
• 支持自定义模板路径覆盖默认配置

进阶用法

路由 URL 构建

传入非绝对路径时，自动调用 $this->app->route->buildUrl() 构建路由 URL：

$this->success('更新成功', 'user/profile');  // 自动构建为 /user/profile

自动判断响应类型

框架自动根据请求类型选择响应格式：

• AJAX / JSON 请求 → 返回 JSON 数据
• 普通请求 → 返回 HTML 跳转页

环境要求

• PHP >= 8.0
• ThinkPHP >= 8.0
• topthink/think-view >= 2.0

License

Apache-2.0