经过发行周的短暂休息，Astro 4.6 现已推出，我们又回到了正常的时间表！此版本包括一个新的手动路由策略用于国际化，对 CSRF 保护进行了实验性支持，开发工具栏新增功能等。

Astro 4.6 发布，支持手动设置国际化路由策略

完整的发布亮点包括：

  • 手动 i18n 路由策略
  • 移动开发工具栏
  • 实验性：支持 CSRF 保护
  • Cookie 改进
  • 不再支持旧版本 Node.js

要升级现有项目，请使用自动化 @astrojs/upgrade CLI 工具。或者通过运行包管理器的升级命令来手动升级：

# 推荐
npx @astrojs/upgrade

# 手动
npm install astro@latest
pnpm upgrade astro --latest
yarn upgrade astro --latest

手动 i18n 路由策略

Astro 4.6 引入了国际化的手动路由策略。在默认路由策略不能完全满足你的需求的情况下，这个新策略允许你完全控制国际化 Astro 网站的路由。

要启用手动路由，请将 astro.config.mjs 中的 i18n.routing 选项设置为 manual：

// astro.config.mjs
import { defineConfig } from "astro/config";
export default defineConfig({
  i18n: {
    locales: ["en", "fr"],
    defaultLocale: "fr",
    routing: "manual",
  },
});

然后向你的项目添加一个中间件来处理路由：

// src/middleware.ts
import { defineMiddleware } from "astro:middleware";
import { redirectToDefaultLocale } from "astro:i18n";
// 示例中间件，将所有请求重定向到默认语言环境，除了 /about 页面。
export const onRequest = defineMiddleware(async (context, next) => {
  if (context.url.startsWith("/about")) {
    return next();
  } else {
    return redirectToDefaultLocale(context, 302);
  }
});

或者，你可以使用 astro:i18n 中的新 middleware 函数导入 Astro 自己的中间件逻辑，以构建默认路由策略：

import { defineMiddleware, sequence } from "astro:middleware";
import { middleware } from "astro:i18n"; // Astro 自己的 i18n 路由中间件
export const userMiddleware = defineMiddleware(() => {
  // 在这里写入您的自定义中间件逻辑
});
export const onRequest = sequence(
  userMiddleware,
  middleware({
    redirectToDefaultLocale: false,
    prefixDefaultLocale: true
  })
)

查看国际化文档，了解有关如何使用手动路由进行国际化的更多信息。

移动开发工具栏

Astro 4.6 引入了将开发工具栏移动到屏幕底部不同位置的功能。如果你有一个覆盖屏幕底部的粘性标题，或者你只是希望工具栏位于其他位置，这可能会很有用。开发工具栏可以帮助你，而不是妨碍你！

实验性：支持 CSRF 保护

Astro 4.6 添加了对 CSRF 保护的实验性部分支持。此功能目前处于实验阶段，可能会在未来的版本中发生变化。

要启用它，请在 astro.config.mjs 中设置 experimental.security.csrfProtection 选项：

// astro.config.mjs
import { defineConfig } from "astro/config";
export default defineConfig({
  experimental: {
    security: {
      csrfProtection: {
        origin: true,
      },
    },
  },
});

启用此设置会使 Astro 执行检查，确保所有现代浏览器自动传递的「origin」标头与每个 Request 发送的 URL 相匹配。如果没有，Astro 将使用 403 Forbidden 状态代码进行响应。

请注意，此功能仅适用于按需呈现的页面（也称为服务器端呈现）。

Cookie 改进

Astro 删除 cookie 的助手 Astro.cookies.delete 现在允许设置更多 cookie 属性，而不仅仅是 path 和 domain 属性。也许这只是一点点的进步，但绝对是一个你值得体验的改变。

不再支持旧版本 Node.js

根据我们的 Node.js 支持和升级政策，此版本的 Astro 不再支持：

  • Node.js 18 版本低于 18.17.1
  • Node.js 19（奇数版本）
  • Node.js 20 版本低于 20.3.0

正如我们的支持政策中所述，这一决定是在仔细考虑了几个因素后做出的。我们相信这一变化将为所有用户带来更稳定、更安全的 Astro 体验。

你可以继续使用已弃用的 Node.js 版本，直到 Astro 的下一个主要版本 (v5)。但是，安装 Astro 时你可能会看到警告，并且某些功能可能无法按预期工作。

Bug 修复

Astro 4.6 包括更多错误修复和较小的改进，这些改进无法包含在本发布帖子中，查看完整的发行说明以了解更多信息。