SuperAPI AI 工具集

payload

编程与开发

查看项目

更新于 10-16 00:30

技能介绍

用途:面向 Payload CMS 项目开发,提供配置、集合、字段、钩子、访问控制与查询 API 的参考;也可用于排查验证错误等问题。

主要能力:涵盖自动生成 slug(slugField())、按用户限制内容(含复杂查询的行级安全)、本地 API 用户操作(user + overrideAccess: false)、草稿/发布工作流(versions: { drafts: true })、计算字段(virtual: true 配合 afterRead)、条件字段(admin.condition)、自定义字段验证(validate)、关系列表过滤(filterOptions)、字段选择(select)、自动设置作者/日期(beforeChange 钩子)、防止钩子循环(req.context)、级联删除(beforeDelete 钩子)、地理空间查询、反向关系(join 字段)、Next.js 重新验证、按关系查询、AND/OR 复杂查询、事务、后台任务队列、自定义 API 路由、云存储适配器、多语言本地化与插件开发等。

使用方式:安装命令 npx create-payload-app@latest my-app,随后 cd my-app 与 pnpm dev。在 Next.js API 路由或 Server Components 中通过 getPayload({ config }) 获取实例,再用 payload.find / findByID 查询,支持 where、depth、limit、sort、select 等参数。配置入口为 buildConfig,含 admin、collections、editor、secret、typescript.outputFile 与 db 适配器。

限制与注意:本地 API 默认绕过全部访问控制,即使传入 user 也需 overrideAccess: false 才真正按用户权限执行;钩子中嵌套操作若不传递 req 会破坏事务原子性;钩子触发自身可能造成无限循环,需用 context 标志规避。更多细节见资料列出的 FIELDS.md、COLLECTIONS.md、HOOKS.md、ACCESS-CONTROL.md、QUERIES.md、ADAPTERS.md、ADVANCED.md、PLUGIN-DEVELOPMENT.md 等文档,官方资源为 https://payloadcms.com/docs 与 https://github.com/payloadcms/payload。