CakePHP多域名多语言动态路由配置及CRON任务URL生成问题

我之前在CakePHP项目里处理过几乎一模一样的多域名多语言路由需求，给你几个经过实践验证的方案，完美解决你遇到的问题：

方案一：使用带域名约束的路由前缀（推荐） #

这个方案利用CakePHP的路由前缀特性，配合域名约束，既能实现不同域名对应专属路由，又能避免跨域名访问的问题，同时解决CRON任务生成URL的痛点。

1. 定义带域名约束的前缀路由 #

在config/routes.php中替换原来的switch语句，改成前缀路由并添加域名约束：

// 法语域名专属路由
$routes->prefix('fr', function ($routes) {
    // 约束仅匹配example.fr（含www子域名）
    $routes->setHost('{subdomain:www.}example.fr');
    
    $routes->connect('/ajoutez-votre-experience', ['controller' => 'Home', 'action' => 'add']);
    $routes->connect('/contact', ['controller' => 'Home', 'action' => 'contact']);
    $routes->connect('/conditions-d-annulation', ['controller' => 'Home', 'action' => 'refund']);
    $routes->connect('/hote/:slug', ['controller' => 'Host', 'action' => 'index'])->setPass(['slug']);
    $routes->connect('/experience/:slug', ['controller' => 'Experience', 'action' => 'index'])->setPass(['slug']);
    // 法语专属的产品路由
    $routes->connect('/produit/:slug', ['controller' => 'Products', 'action' => 'view'])->setPass(['slug']);
    // ... 其他法语路由
});

// 英语域名专属路由
$routes->prefix('en', function ($routes) {
    $routes->setHost('{subdomain:www.}example.com');
    
    $routes->connect('/add-your-business', ['controller' => 'Home', 'action' => 'add']);
    $routes->connect('/contact', ['controller' => 'Home', 'action' => 'contact']);
    $routes->connect('/cancellation-condition', ['controller' => 'Home', 'action' => 'refund']);
    $routes->connect('/host/:slug', ['controller' => 'Host', 'action' => 'index'])->setPass(['slug']);
    $routes->connect('/experience/:slug', ['controller' => 'Experience', 'action' => 'index'])->setPass(['slug']);
    // 英语专属的产品路由
    $routes->connect('/product/:slug', ['controller' => 'Products', 'action' => 'view'])->setPass(['slug']);
    // ... 其他英语路由
});

通过setHost方法，我们给每个前缀路由绑定了专属域名，这样/produit只会在example.fr下生效，/product只会在example.com下生效，完全避免了跨域名访问的问题。

2. CRON任务中生成指定域名的URL #

在CRON任务这类无HTTP请求上下文的场景中，只需要在Router::url()中明确指定prefix和_host参数，就能生成正确的专属域名URL：

// 生成法语产品的绝对URL
$frProductUrl = Router::url([
    'prefix' => 'fr',
    'controller' => 'Products',
    'action' => 'view',
    'slug' => 'chaussures-54',
    '_host' => 'example.fr'
], true); // true表示生成绝对URL

// 生成英语产品的绝对URL
$enProductUrl = Router::url([
    'prefix' => 'en',
    'controller' => 'Products',
    'action' => 'view',
    'slug' => 'shoes-54',
    '_host' => 'example.com'
], true);

方案二：使用路由作用域（Scopes） #

如果你的不同域名路由结构差异较大，不想使用前缀，路由作用域是更灵活的选择：

// 法语域名作用域
$routes->scope('/', function ($routes) {
    $routes->setHost('{subdomain:www.}example.fr');
    
    $routes->connect('/ajoutez-votre-experience', ['controller' => 'Home', 'action' => 'add']);
    $routes->connect('/produit/:slug', ['controller' => 'Products', 'action' => 'view'])->setPass(['slug']);
    // ... 其他法语路由
});

// 英语域名作用域
$routes->scope('/', function ($routes) {
    $routes->setHost('{subdomain:www.}example.com');
    
    $routes->connect('/add-your-business', ['controller' => 'Home', 'action' => 'add']);
    $routes->connect('/product/:slug', ['controller' => 'Products', 'action' => 'view'])->setPass(['slug']);
    // ... 其他英语路由
});

这种方式不需要前缀，路由结构更干净，CRON中生成URL时只需指定_host参数即可：

$frProductUrl = Router::url([
    'controller' => 'Products',
    'action' => 'view',
    'slug' => 'chaussures-54',
    '_host' => 'example.fr'
], true);

额外最佳实践 #

• 抽象通用路由逻辑：如果不同域名的路由只是路径不同、控制器/action相同，可以把路由定义封装成函数，减少重复代码：

  function registerCommonRoutes($routes, $addPath, $cancelPath, $productPath) {
      $routes->connect($addPath, ['controller' => 'Home', 'action' => 'add']);
      $routes->connect($cancelPath, ['controller' => 'Home', 'action' => 'refund']);
      $routes->connect($productPath . '/:slug', ['controller' => 'Products', 'action' => 'view'])->setPass(['slug']);
      // ... 其他通用路由
  }
  
  // 调用函数注册法语路由
  $routes->scope('/', function ($routes) {
      $routes->setHost('{subdomain:www.}example.fr');
      registerCommonRoutes($routes, '/ajoutez-votre-experience', '/conditions-d-annulation', '/produit');
  });
  

• 配置域名-语言映射：在config/app.php中添加域名与语言的映射，方便全局调用：

  'DomainLanguageMap' => [
      'example.fr' => 'fr',
      'www.example.fr' => 'fr',
      'example.com' => 'en',
      'www.example.com' => 'en'
  ]
  

内容的提问来源于stack exchange，提问作者Jérémie Halin