Payload CMS 与 Astro

PayloadCMS 是一个开源的无头 CMS（Content Management System，内容管理系统），可以用来为你的 Astro 项目提供内容。

与 Astro 集成

前提条件

一个 Astro 项目 - 如果还没有 Astro 项目, 我们的安装指南将在短时间内帮助你启动并运行。
一个 MongoDB 数据库 - 在创建新项目时，PayloadCMS 会要求你提供一个 MongoDB 连接字符串。你可以在本地部署一个，也可以使用 MongoDBAtlas 在 Web 上免费托管数据库。
一个 PayloadCMS REST API - 创建一个 PayloadCMS 项目，并在安装过程中将其连接到你的 MongoDB 数据库。

:::note[选择模版]在 PayloadCMS 安装过程中，系统会询问你是否要使用模板。

在此步骤中选择任何可用的模板（如 'blog'）都会自动为你生成附加的集合（collections）供你使用。否则，你需要手动创建 PayloadCMS 集合。:::

为你的 PayloadCMS 集合配置 Astro

你的 Payload 项目模板的 src/collections/ 路径下将包含一个名为 Posts.ts 的文件。如果你在安装过程中没有选择创建内容集合的模板，你可以通过手动添加此配置文件来创建一个新的 Payload CMS 集合。下面的示例展示了一个名为 posts 的内容集合，其中包含 title、content 和 slug 字段：

import { CollectionConfig } from "payload/types";

const Posts: CollectionConfig = {
  slug: "posts",
  admin: {
    useAsTitle: "title",
  },
  access: {
    read: () => true,
  },

  fields: [
    {
      name: "title",
      type: "text",
      required: true,
    },
    {
      name: "content",
      type: "text",
      required: true,
    },
    {
      name: "slug",
      type: "text",
      required: true,
    },
  ],
};

export default Posts;

将 Users（所有 PayloadCMS 项目中都可用）和任何其他集合（例如 Posts）导入并添加到 payload.config.ts 文件中的可用集合（collections）中。

import { buildConfig } from "payload/config";
import path from "path";

import Users from "./collections/Users";
import Posts from "./collections/Posts";

export default buildConfig({
  serverURL: "http://localhost:4321",
  admin: {
    user: Users.slug,
  },
  collections: [Users, Posts],
  typescript: {
    outputFile: path.resolve(__dirname, "payload-types.ts"),
  },
  graphQL: {
    schemaOutputFile: path.resolve(__dirname, "generated-schema.graphql"),
  },
});

这将使一个名为 “Posts” 的新集合出现在你的 PayloadCMS 仪表板中 “Users” 集合的旁边。

进入 “Posts” 集合并创建一篇新文章。在保存后，你会注意到 API URL 出现在右下角。

在本地 PayloadCMS 服务运行的情况下，在浏览器中打开 http://localhost:4321/api/posts 。你应该看到一个包含你创建的文章作为对象的 JSON 文件。

{
  "docs":[
    {
      "id":"64098b16483b0f06a7e20ed4",
      "title":"Astro & PayloadCMS Title 🚀",
      "content":"Astro & PayloadCMS Content",
      "slug":"astro-payloadcms-slug",
      "createdAt":"2023-03-09T07:30:30.837Z",
      "updatedAt":"2023-03-09T07:30:30.837Z"
    }
  ],
  "totalDocs":1,
  "limit":10,
  "totalPages":1,
  "page":1,
  "pagingCounter":1,
  "hasPrevPage":false,
  "hasNextPage":false,
  "prevPage":null,
  "nextPage":null
}

:::tip默认情况下，Astro 和 PayloadCMS 都会使用 4321 端口。你可能想要在 src/server.ts 文件中更改 PayloadCMS 的端口，别忘了也同时更新 src/payload.config.ts 中的 serverURL 。:::

获取数据

通过你网站的唯一 REST API URL 和内容的路由来获取你的 PayloadCMS 数据。（默认情况下，PayloadCMS 将通过 /api 挂载所有路由。）然后，你可以使用 Astro 的 set:html="" 指令来渲染你的数据属性。

与你的帖子一起，PayloadCMS 将返回一些顶级元数据。实际的文章数据嵌套在 docs 数组中。

例如，显示文章标题和内容列表：

---
import HomeLayout from "../layouts/HomeLayout.astro";

const res = await fetch("http://localhost:5000/api/posts") // http://localhost:4321/api/posts 默认端口
const posts = await res.json()
---

<HomeLayout title='Astro Blog'>
	{
    posts.docs.map((post) => (
        <h2 set:html={post.title} />
        <p set:html={post.content} />
    ))
	}
</HomeLayout>

使用 PayloadCMS 和 Astro 创建博客

创建一个博客索引页面 src/pages/index.astro，列出每篇文章并链接到其单独的页面。

通过 API 获取的返回结果是一个对象（posts）的数组，其中包括以下属性：

title - 文章的标题
content - 文章的内容
slug - 文章的slug

---
import HomeLayout from "../layouts/HomeLayout.astro";

const res = await fetch("http://localhost:5000/api/posts") // http://localhost:4321/api/posts 默认端口
const posts = await res.json()
---

<HomeLayout title='Astro Blog'>
	<h1>Astro + PayloadCMS 🚀</h1>
	<h2>博客文章列表：</h2>
	<ul>
		{
			posts.docs.map((post) =>(
				<li>
					<a href={`posts/${post.slug}`} set:html={post.title} />
				</li>
			))
		}
	</ul>
</HomeLayout>

使用 PayloadCMS API 生成页面

创建一个页面 src/pages/post/[slug].astro 为每一篇文章动态生成一个页面。

---
import PostLayout from "../../layouts/PostLayout.astro"

const {title, content} = Astro.props

// 对于静态 Astro 站点，需要 getStaticPaths()。
// 如果使用 SSR，你将不需要此函数。
export async function getStaticPaths() {
    let data = await fetch("http://localhost:5000/api/posts")
    let posts = await data.json()

    return posts.docs.map((post) => {
        return {
            params: {slug: post.slug},
            props: {title: post.title, content: post.content},
        };
    });
} 
---
<PostLayout title={title}>
    <article>
        <h1 set:html={title} />
        <p set:html={content} />
    </article>
</PostLayout>