CakePHP 3.5多分页问题：首页及首/上页按钮链接异常

看起来你遇到的核心问题是分页组件生成的首页、上一页链接错误地指向了/.media，而非预期的/media?image[page]=1这类正确路径。结合你的代码配置，我整理了几个排查和修复方向：

1. 优先排查路由配置问题 #

无效链接/.media的格式很像路由把media识别成了URL扩展名，而非控制器名称。你需要检查config/routes.php：

• 有没有开启全局扩展名支持：比如Router::extensions(['html', 'json']);，如果开启了，CakePHP会把.后面的内容解析为扩展名，导致/media被错误解析为/.media（空控制器+media扩展名）。
• 有没有自定义路由规则匹配了类似/:controller.:ext的格式，覆盖了默认的控制器路由。

如果是扩展名导致的问题，可以：

• 关闭全局扩展名（如果不需要的话）；
• 给Media控制器单独配置路由，明确排除扩展名影响：

Router::connect('/media', ['controller' => 'Media', 'action' => 'index']);
Router::connect('/media/*', ['controller' => 'Media']);

2. 修正PaginatorHelper的调用方式 #

你在视图里使用$paginator->numbers(['model' => 'Images'])，但因为你给分页设置了scope（image和video），Helper需要通过scope而非model来区分不同的分页组。正确的调用应该指定scope参数：

// 图片分页的页码、首页、上一页链接
$this->Paginator->numbers(['scope' => 'image']);
$this->Paginator->first('首页', ['scope' => 'image']);
$this->Paginator->prev('上一页', ['scope' => 'image']);

// 视频分页同理
$this->Paginator->numbers(['scope' => 'video']);
$this->Paginator->first('首页', ['scope' => 'video']);
$this->Paginator->prev('上一页', ['scope' => 'video']);

当使用scope时，Helper会根据scope读取对应的分页配置和参数，避免和全局分页或其他模型的分页冲突。

3. 确认控制器分页调用的正确性 #

你当前的分页调用写法是可行的，但可以优化为更清晰的方式，确保scope和配置完全对应：

// 图片分页：直接使用配置好的Images分组
$images = $this->paginate($imageTable->find('all', $image_options), 'Images');

// 视频分页同理
$videos = $this->paginate($videosTable->find('all', $video_options), 'Videos');

这种写法会直接调用你在$paginate数组里定义的Images配置（包含scope和limit），避免手动传递scope可能出现的疏漏。

4. 测试手动生成URL验证问题根源 #

在视图里添加一段测试代码，手动生成首页的URL：

echo $this->Url->build([
    'controller' => 'Media',
    'action' => 'index',
    '?' => ['image[page]' => 1]
]);

• 如果生成的URL是正确的/media?image[page]=1，说明问题出在PaginatorHelper的调用上，回到步骤2修正即可；
• 如果生成的还是/.media，那肯定是路由配置的问题，重点排查步骤1。

额外注意点 #

• 确保你的$paginate配置里，Images和Videos的scope值（image、video）是唯一的，不要和其他分页组冲突；
• 检查视图里是否有其他地方错误修改了PaginatorHelper的默认参数，比如全局设置了model或scope。

内容的提问来源于stack exchange，提问作者Panito