用途:在开发 Payload 项目时提供参考,涉及 payload.config.ts、集合、字段、钩子、访问控制和 Payload API,也用于调试验证错误等场景。Payload 是 Next.js 原生 CMS,采用 TypeScript 优先架构,提供管理后台、数据库管理、REST/GraphQL API、认证与文件存储。
主要能力:集合与字段建模(文本、关系、富文本、上传、select、array、blocks、point、join、virtual、条件字段等)、字段验证、钩子(集合级与字段级)、访问控制(含行级安全与复杂查询)、版本与草稿、本地 API 查询与 RPC 风格查询、插件开发、自定义 API 端点、后台任务队列、本地化、存储适配器等。
使用方式:可用 npx create-payload-app@latest my-app 创建项目,然后 cd my-app 并 pnpm dev 启动。配置通过 buildConfig 提供,含 admin、collections、editor、secret、typescript、db 等选项;数据操作使用 payload.find、payload.findByID 等。获取实例可用 getPayload({ config })。
限制与注意:Local API 默认绕过访问控制,传入 user 时需加 overrideAccess: false;嵌套操作缺少 req 会破坏事务原子性;钩子内操作可能触发同一钩子造成死循环,需用 req.context 标志;字段级访问只返回布尔值,无查询约束;关系深度默认 2;启用草稿会自动注入 _status;开发环境与 payload build 会自动生成类型,避免手动运行 generate:types;MongoDB 事务需副本集,SQLite 事务默认关闭,Point 字段在 SQLite 不支持。以上为资料明确内容,未提供的功能、收费与价格暂未提供。