CodeIgniter 4 命名路由重定向时传递参数的技巧-php教程-PHP中文网

CodeIgniter 4 命名路由重定向时传递参数的技巧

花韻仙語

发布： 2025-09-09 20:04:01

原创

543人浏览过

codeigniter 4 命名路由重定向时传递参数的技巧

本文旨在解决 CodeIgniter 4 中使用命名路由进行重定向时，如何优雅地传递参数的问题。虽然框架原生 redirect() 函数只接受一个路由参数，但通过自定义 redirect() 函数，可以实现向命名路由传递参数，从而简化代码并提高可维护性。

CodeIgniter 4 框架的 redirect() 函数在处理命名路由重定向时，默认只接受一个路由名称参数，这在某些场景下会带来不便，尤其是在需要向目标路由传递参数时。虽然可以通过手动拼接 URL 的方式实现参数传递，但这种方法不够优雅，且容易出错。本文将介绍一种通过自定义 redirect() 函数的方式，实现向命名路由传递参数的解决方案。

问题分析

CodeIgniter 4 的 redirect() 函数定义在 system/Common.php 文件中，其源码如下：

function redirect(?string $route = null): RedirectResponse
{
    $response = Services::redirectresponse(null, true);

    if (! empty($route)) {
        return $response->route($route);
    }

    return $response;
}

登录后复制

可以看到，redirect() 函数最终调用了 $response->route() 方法。查看 RedirectResponse 类的 route() 方法，可以发现它实际上接受第二个参数，用于传递路由参数。

解决方案：自定义 redirect() 函数

根据 CodeIgniter 4 的扩展机制，我们可以自定义 redirect() 函数，以支持传递路由参数。

创建 Common.php 文件：

在 app/Common.php 文件中，复制 system/Common.php 中的 redirect() 函数代码。如果 app/Common.php 文件不存在，则需要手动创建。

修改 redirect() 函数：

修改 app/Common.php 中的 redirect() 函数，使其接受第二个参数，用于传递路由参数。

if (! function_exists('redirect')) {
    function redirect(?string $route = null, array $params = []): RedirectResponse
    {
        $response = Services::redirectresponse(null, true);

        if (! empty($route)) {
            return $response->route($route, $params);
        }

        return $response;
    }
}

登录后复制

注意： 为了避免函数重复定义错误，需要使用 if (! function_exists('redirect')) 进行判断。

使用自定义 redirect() 函数：

即构数智人
即构数智人是由即构科技推出的AI虚拟数字人视频创作平台，支持数字人形象定制、短视频创作、数字人直播等。

36

查看详情

现在，就可以在控制器中使用自定义的 redirect() 函数，并传递路由参数了。

假设有如下路由定义：
```
$routes->get('edit', 'Test_Controller::editTest/$1', ["as" => "editTest", "filter" => 'testFilter']);
```
登录后复制
可以使用以下方式进行重定向并传递参数：
```
$passingID = 123;
return redirect('editTest', [$passingID]);
```
登录后复制

示例代码

以下是一个完整的示例代码：

app/Controllers/Test_Controller.php:

<?php

namespace App\Controllers;

use CodeIgniter\Controller;

class Test_Controller extends Controller
{
    public function editTest($id)
    {
        echo "Editing test with ID: " . $id;
    }

    public function index()
    {
        $passingID = 123;
        return redirect('editTest', [$passingID]);
    }
}

登录后复制

app/Config/Routes.php:

<?php

namespace Config;

// Create a new instance of our RouteCollection class.
$routes = Services::routes();

/*
 * --------------------------------------------------------------------
 * Router Setup
 * --------------------------------------------------------------------
 */
$routes->setDefaultNamespace('App\Controllers');
$routes->setDefaultController('Home');
$routes->setDefaultMethod('index');
$routes->setTranslateURIDashes(false);
$routes->set404Override();
//The Auto Route (Improved).
//It will scan directories for controllers, and register the route
//for you. Therefore, you don't have to define all routes manually.
$routes->setAutoRoute(true);

/*
 * --------------------------------------------------------------------
 * Route Definitions
 * --------------------------------------------------------------------
 */

// We get a performance increase by specifying the default route.
$routes->get('/', 'Home::index');
$routes->get('edit', 'Test_Controller::editTest/$1', ["as" => "editTest"]);

/*
 * --------------------------------------------------------------------
 * Additional Routing
 * --------------------------------------------------------------------
 */
/**
 * @var \CodeIgniter\Router\RouteCollection $routes
 */
if (is_file(APPPATH . 'Config/' . ENVIRONMENT . '/Routes.php')) {
    require APPPATH . 'Config/' . ENVIRONMENT . '/Routes.php';
}

登录后复制

app/Common.php:

<?php

use CodeIgniter\HTTP\RedirectResponse;

if (! function_exists('redirect')) {
    function redirect(?string $route = null, array $params = []): RedirectResponse
    {
        $response = Services::redirectresponse(null, true);

        if (! empty($route)) {
            return $response->route($route, $params);
        }

        return $response;
    }
}

登录后复制

注意事项