简单介绍API Platform Core

API Platform Core中的serialization formats

API Platform Core 是一个用于构建 REST 和 GraphQL API 的 PHP 框架，支持多种序列化格式。

以下是 API Platform Core 中支持的几种常见的序列化格式：

JSON: JSON 是一种轻量级的数据交换格式，易于阅读和编写。API Platform Core 使用 JSON 作为默认的序列化格式，它支持嵌套对象和数组，具有广泛的应用场景。

YAML: YAML 是一种基于文本的序列化格式，它可以用来表示复杂的数据结构。API Platform Core 支持使用 YAML 格式来定义 API 的元数据，例如 API 的路由、输入输出参数等。

XML: XML 是一种用于描述数据的标记语言，它具有良好的跨平台和可扩展性。API Platform Core 支持使用 XML 格式来序列化和反序列化 API 的数据。

HAL: HAL（Hypertext Application Language）是一种基于 JSON 的超媒体格式，它可以用来表示 RESTful API 中的资源和链接。API Platform Core 支持使用 HAL 格式来构建具有超媒体功能的 API。

JSON-LD: JSON-LD（JSON Linked Data）是一种用于描述链接数据的 JSON 格式。API Platform Core 支持使用 JSON-LD 格式来定义 API 的元数据，例如 API 的语义、资源关系等。

CSV: CSV（Comma-Separated Values）是一种常见的数据格式，用于将表格数据以逗号分隔的形式保存为纯文本文件。API Platform Core 支持使用 CSV 格式来输出 API 的数据。

JSONAPI: JSONAPI 是一种基于 JSON 的 API 格式，它定义了一组规范，用于构建符合 REST 原则的 Web API。API Platform Core 支持使用 JSONAPI 格式来构建符合规范的 API。

除了以上列出的序列化格式，API Platform Core 还支持一些其他的格式，例如 MessagePack 和 Protocol Buffers，可以根据实际需求进行选择。

API Platform Core中的 collection endpoints 什么意思

在 API Platform Core 中，collection endpoints 是用于管理 API 资源集合的 RESTful 路由。

简单来说，collection endpoints 允许您以一种标准化的方式管理资源的集合。例如，如果您正在开发一个电子商务 API，您可能有一个名为 products 的资源集合，其中包含所有的商品。在 API Platform Core 中，您可以使用 collection endpoints 来对这个资源集合执行各种 CRUD（创建、读取、更新、删除）操作，例如：

GET /products: 获取所有商品的列表
POST /products: 创建一个新的商品
DELETE /products/{id}: 删除特定 ID 的商品
PUT /products/{id}: 更新特定 ID 的商品
这些 collection endpoints 的优点是，它们遵循了 RESTful 设计原则，提供了标准化的 API 操作方式，可以帮助开发人员更快地构建和维护 API。API Platform Core 还支持许多自定义选项，例如筛选、排序和分页，使得开发人员可以更好地控制资源的展现和操作。

API Platform Core中的 item endpoints 什么意思

在 API Platform Core 中，item endpoints 是用于管理单个资源的 RESTful 路由。与 collection endpoints 不同，item endpoints 操作的是一个单一的资源，而不是资源的集合。

例如，如果您正在开发一个电子商务 API，您可能有一个名为 products 的资源集合，并且您可能想要访问某个具体的商品。在这种情况下，您可以使用 item endpoints 来执行 CRUD 操作，例如：

GET /products/{id}: 获取特定 ID 的商品
PUT /products/{id}: 更新特定 ID 的商品
DELETE /products/{id}: 删除特定 ID 的商品
与 collection endpoints 类似，item endpoints 遵循 RESTful 设计原则，并提供了标准化的 API 操作方式。API Platform Core 还支持一些自定义选项，例如部分更新（PATCH 请求）和输入验证，以帮助开发人员更好地管理和操作单个资源。

API Platform Core 中的JSON-LD format

在 API Platform Core 中，JSON-LD（JSON Linked Data）是一种用于描述链接数据的 JSON 格式。它允许您将 API 的数据与外部数据源进行关联，从而创建具有更丰富语义的 API。

以下是 JSON-LD 的几个关键特点：

嵌入语义信息：JSON-LD 允许您在 API 的数据中嵌入语义信息，这些信息可以描述资源的类型、属性、关系等。这样做可以让客户端更好地理解 API 的数据，而无需额外的文档或解释。

链接外部资源：JSON-LD 还允许您将 API 的数据与外部数据源进行链接，从而扩展 API 的语义范围。例如，您可以将某个资源与另一个 Web API 或 RDF 数据集进行链接，以获取更多的上下文信息。

支持多种格式：JSON-LD 支持多种格式的 RDF 数据，包括 Turtle、N-Triples、RDF/XML 等。这样做可以让您使用多种方式描述 API 的语义信息，以适应不同的需求。

在 API Platform Core 中，您可以使用 JSON-LD 格式来描述 API 的元数据，例如资源的类型、属性和链接关系等。您可以通过配置 API Platform Core 的序列化器来启用 JSON-LD 支持，并使用 @Context 注解来定义语义信息。例如，以下代码片段演示了如何在 API Platform Core 中使用 JSON-LD：

/**
 * @ApiResource
 * @Context("http://schema.org/")
 */
class Product
{
    /**
     * @Id
     * @GeneratedValue
     * @Column(type="integer")
     */
    private $id;

    /**
     * @Column
     */
    private $name;

    // ...
}

在上面的示例中，@Context 注解指定了 JSON-LD 中使用的默认命名空间。在这种情况下，它使用了 http://schema.org/ 命名空间，该命名空间定义了一些常用的词汇，例如 “Product” 和 “name”。通过这种方式，您可以使用 JSON-LD 来描述 API 的语义信息，并让客户端更好地理解 API 的数据。

API Platform Core 中对于 collection endpoints（集合终端节点）的校验流程可以分为以下几个步骤：

1、API Platform Core 中对于 collection endpoints（集合终端节点）的校验流程可以分为以下几个步骤：
2、首先，API Platform Core 会检查集合终端节点是否需要进行授权。如果未设置授权，则所有用户都可以访问该节点。
3、如果需要授权，API Platform Core 将检查当前用户是否已经登录，并使用 Symfony Security 组件检查该用户是否具有访问集合终端节点的权限。如果用户未登录，则 API Platform Core 将返回 HTTP 401 错误响应（未授权）。如果用户已经登录但没有访问权限，则 API Platform Core 将返回 HTTP 403 错误响应（禁止访问）。
4、如果用户已经通过授权验证，则 API Platform Core 将执行所有已定义的数据变换操作，例如筛选、排序和分页。这些变换操作可以使用 API Platform Core 中提供的默认设置或自定义设置。
5、在完成所有数据变换操作后，API Platform Core 将对剩余的集合进行校验。此时，API Platform Core 将应用在资源属性上定义的任何 security rule。如果某个属性的 security rule 未被满足，则该属性将不会返回给客户端。如果在请求的集合中没有任何项满足所有 security rule，则 API Platform Core 将返回空集合。需要注意的是，在集合终端节点中只有集合中的第一个项受到 security rule 的约束，因为结果被缓存并重用于集合中的下一个项。
6、最后，API Platform Core 将对已校验的集合进行序列化，将结果返回给客户端。API Platform Core 支持多种序列化格式，包括 JSON-LD、JSON、HAL、CSV 和 XML。如果需要，可以通过自定义序列化器来添加新的序列化格式。