README

🇷🇺 俄罗斯公民

我们，Laminas的参与者，来自不同的国家。我们中许多人都有在俄罗斯和乌克兰的朋友、亲戚和同事。我们中的一些人出生在俄罗斯。我们中的一些人现在住在俄罗斯。我们中的一些人的祖父母在二战中与法西斯作战。在这里，没有人支持法西斯主义。

我们中的一位成员有一位乌克兰亲戚，她和儿子一起逃离了家园。由于前方道路上的轰炸，火车延误了。我们有朋友在防空洞里躲藏。我们在空袭后焦急地等待他们的消息，空袭无差别地攻击医院、学校、幼儿园和住宅。我们不是从任何媒体上得知这些的。这是我们亲眼所见。

您足够信任我们使用我们的程序，我们请求您再次信任我们。我们需要帮助。走出家门，抗议这场毫无意义的战争。停止流血。说“不，战争！”

🇺🇸 致俄罗斯公民

Laminas的我们来自世界各地。我们中许多人都有在俄罗斯和乌克兰的朋友、家人和同事。我们中的一些人出生在俄罗斯。我们中的一些人现在住在俄罗斯。我们中的一些人的祖父母在二战中与纳粹作战。在这里，没有人支持法西斯主义。

有一位团队成员有一位乌克兰亲戚，她和儿子一起逃离了家园。由于前方道路上的轰炸，火车延误了。我们有朋友在防空洞里躲藏。我们在空袭后焦急地等待他们的消息，空袭无差别地攻击医院、学校、幼儿园和住宅。我们不是从任何媒体上得知这些的。这是我们亲身体验的。

您足够信任我们使用我们的软件。我们要求您信任我们说出真相。我们需要您的帮助。走出家门，抗议这场不必要的战争。停止杀戮。说“停止战争！”

简介

api-tools-admin模块提供了用于管理Laminas API Tools中API的后端管理API和前端Admin UI。

注意

不要在生产系统中启用此模块。

需求

请参阅composer.json文件。

安装

运行以下composer命令

$ composer require --dev "laminas-api-tools/api-tools-admin"

然后运行composer install以确保已安装模块。

最后，将模块名称添加到项目配置文件config/application.config.php中的modules键下

return [
    /* ... */
    'modules' => [
        /* ... */
        'Laminas\ApiTools\Admin',
    ],
    /* ... */
];

通常，此模块应与laminas-development-mode一起使用，以在应用程序中条件性地启用模块。这样做时，您将把模块添加到项目的config/development.config.php.dist文件中，而不是config/application.config.php文件，并通过php public/index.php development enable启用它。

升级

我们努力使升级过程尽可能简单，就像执行composer update一样；然而，有时可能还需要其他步骤。本节将记录这些步骤。

从旧版本升级到1.5

如果您从1.5之前的版本升级到1.5或更高版本，有一些更改需要注意。

首先，版本1.5取消了rwoverdijk/assetmanager的需求。然而，为了使用管理UI，您需要一种方法来访问UI和api-tools模块提供的公共资源。您有三个选择

1. 安装rwoverdijk/assetmanager：composer require rwoverdijk/assetmanager。请注意，然而，截至1.5.0版本发布时，此模块与laminas-mvc的v3版本不兼容。如果您寻求快速升级，并且不关心要安装的Laminas组件版本，这是最简单的方法。

2. 安装api-tools-asset-manager。这是一个Composer插件，在安装或卸载包时运行。如果您添加了此插件，需要遵循以下步骤

   • composer require --dev laminas-api-tools/api-tools-asset-manager
   • rm -Rf ./vendor
   • composer install

   这些额外步骤对于插件能够获取其他组件的资源是必要的。

3. 手动复制或创建符号链接到您的公共目录中所需的资源。例如

   • ln -s vendor/laminas-api-tools/api-tools/asset/api-tools public/api-tools
   • ln -s vendor/laminas-api-tools/api-tools-admin-ui/dist/api-tools-ui public/api-tools-ui

这三个选项都可以通过您的应用程序的Web服务器公开访问资源。

从1.5升级到v3 Laminas组件

在将此模块升级到版本1.5之后，您可以然后升级您的应用程序以利用Laminas v3组件。最简单的方法是使用提供的脚本

$ ./vendor/bin/api-tools-upgrade-to-1.5

此脚本将更新您的Composer需求和建议，更新您的模块列表以列出Laminas组件，并删除不再需要或过时的组件，然后重新安装所有依赖项。

如果您不想使用脚本，或者脚本失败，您可以使用以下步骤手动更新应用程序

• 更新您的composer.json
  • 删除
    • require.zendframework/zendframework
    • require.rwoverdijk/assetmanager
    • require-dev.zendframework/zftool
  • 更新
    • require.laminas/laminas-development-mode约束变为^3.0
    • require-dev.laminas/laminas-developer-tools变为^1.0
  • 添加
    • require.laminas/laminas-cache，约束为2.7.1
    • require.laminas/laminas-log，约束为2.9
    • require.laminas/laminas-mvc-i18n，约束为1.0
    • require-dev.laminas-api-tools/api-tools-asset-manager，约束为^1.0
• 更新您的config/modules.config.php
  • 删除
    • AssetManager
    • Laminas\DevelopmentMode
  • 在列表顶部添加
    • Laminas\Cache
    • Laminas\Db
    • Laminas\Filter
    • Laminas\Hydrator
    • Laminas\InputFilter
    • Laminas\I18n
    • Laminas\Log
    • Laminas\Mvc\I18n
    • Laminas\Paginator
    • Laminas\Router
    • Laminas\Validator
• 更新您的config/development.config.php和config/development.config.php.dist文件
  • 从模块列表中删除
    • ZFTool
• 删除composer.lock
• 递归删除vendor/子目录
• 执行composer install

开发模式

在1.5之前以及运行升级脚本或遵循上述升级说明之前，Laminas API Tools使用laminas-development-mode v2版本，这依赖于laminas-mvc v2版本默认提供的控制台与MVC集成。

laminas-development-mode v3操作方式不同，作为Composer供应商的二进制文件提供，没有其他要求。现在调用方式是

$ ./vendor/bin/laminas-development-mode enable

和

$ ./vendor/bin/laminas-development-mode disable

您也可以查询状态

$ ./vendor/bin/laminas-development-mode status

配置

由于这个特定的模块负责提供API和Laminas API Tools管理UI，它需要大量的配置才能在开发环境中运行。由于开发者几乎不需要修改系统级配置，因此在README中省略了这部分内容，但可以在存储库中找到。

此外，该模块在顶级键api-tools-admin下定义了以下特定模块的配置

键：path_spec

默认情况下，api-tools-admin将使用PSR-0目录结构来创建新的Laminas API Tools模块。您可以使用api-tools-admin.path_spec配置切换到PSR-4，该配置接受以下值之一

• Laminas\ApiTools\Admin\Model\ModulePathSpec::PSR_0 ('psr-0')
• Laminas\ApiTools\Admin\Model\ModulePathSpec::PSR_4 ('psr-4')

路由

此模块公开可访问的HTTP API端点和静态资源。

API端点

所有路由默认以/api-tools为前缀。

api/api-tools-version

• 自1.5.1版本起

如果可以找到，则返回当前Laminas API Tools版本，否则返回字符串@dev。有效载荷位于version键中

{
    "version": "1.4.0"
}

• Accept: application/json

• Content-Type: application/json

• 方法：GET

• 错误：无

api/config

此端点用于检查应用程序配置，并提供对其单个值的覆盖。所有覆盖都写入单个文件config/autoload/development.php；您可以通过api-tools-configuration.config-file键在配置中覆盖该位置。

• Accept: application/json, application/vnd.laminas-api-tools.v1.config+json

  application/json将有效载荷作为键/值对的扁平数组提供，键为点分隔的值，正如您在INI中找到的那样。

  application/vnd.laminas-api-tools.v1.config+json将配置作为树形结构提供。

• Content-Type: application/json, application/vnd.laminas-api-tools.v1.config+json

  application/json表示您正在发送键/值对，键为点分隔的值，正如您在INI文件中找到的那样。

  application/vnd.laminas-api-tools.v1.config+json表示您正在发送嵌套的数组/对象配置。

• 方法：GET, PATCH

• 错误：application/problem+json

api/config/module?module={module name}

此操作与api/config端点完全相同，但需要已知的模块名称。当提供时，它允许您检查和操作该模块的配置文件。

api/authentication

此REST端点用于创建、更新和删除应用程序的认证配置。它使用认证资源。

• Accept: application/json

  在成功时返回认证资源。

• Content-Type: application/json

  期望一个认证资源，其中包含创建新HTTP认证或更新现有HTTP认证所需的所有详细信息。

• HTTP方法：GET, POST, PATCH, DELETE

  GET如果没有之前设置认证，将返回404响应。POST在成功时将返回201响应。PATCH在成功时将返回200响应。DELETE在成功时将返回204响应。

• 错误：application/problem+json

api/authentication[/:authentication_adapter] (API V2)

此REST端点用于获取和更新在Laminas API Tools中使用的认证适配器。它使用认证资源版本2。

此端点仅适用于API 版本2。您需要在Appect头中传递以下mediatype

Accept: application/vnd.api-tools.v2+json

• Accept: application/json

  在成功时返回认证资源版本2。

• 内容类型: application/json

  期望一个包含创建新或更新现有 HTTP 认证所需所有详细信息的 认证资源版本 2。

• HTTP 方法: GET、POST、PUT、DELETE

  GET 如果之前没有设置任何认证适配器，将返回 404 响应。成功执行 POST 将返回 201 响应。成功执行 PUT 将返回 200 响应。成功执行 DELETE 将返回 204 响应。

api/module/:name/authentication?version=:version (API V2)

此 REST 端点用于获取和更新特定 API（模块）及其版本（如果指定）的认证映射。

此端点仅适用于API 版本2。您需要在Appect头中传递以下mediatype

Accept: application/vnd.api-tools.v2+json

• Accept: application/json

  成功时返回一个 { "authentication" : value }。

• 内容类型: application/json

  期望一个包含包含认证适配器名称的 认证 值的 JSON。

• HTTP 方法: GET、PUT、DELETE

  GET 将返回一个 { "authentication" : value } 响应。如果没有认证适配器存在，则该值将为 false。

  PATCH 成功时将返回 200 响应，以及更新的认证值。

  DELETE 成功时将返回 204 响应。

api/module/:name/authorization?version=:version

此 REST 端点用于获取和更新应用程序的授权配置。它使用 授权资源。

• Accept: application/json

  成功时返回一个 授权资源。

• 内容类型: application/json

  期望一个包含指定授权规则所需所有详细信息的 授权资源。

• HTTP 方法: GET、PATCH

  GET 总是返回一个实体；如果模块之前不存在配置，或者如果给定版本中任何给定服务未列入配置中，它将提供默认值。

  PATCH 成功时将返回 200 响应，以及更新的实体。

• 错误：application/problem+json

api/db-adapter[/:adapter_name]

此 REST 端点用于创建、更新和删除命名的 Laminas\Db 适配器；它使用 db-adapter 资源。

• Accept: application/json

  成功时返回一个 db-adapter 资源。

• Content-Type: application/json

  期望一个包含创建或更新数据库连接所需所有详细信息的 db-adapter 资源。

• 集合方法: GET、POST

• 资源方法: GET、PATCH、DELETE

• 错误：application/problem+json

api/module.enable

此端点将现有模块启用 Laminas API Tools（Apigilify？）。

• Accept: application/json

  成功时返回一个 模块资源。

• Content-Type: application/json

  期望一个对象，其中包含描述现有 Laminas 模块的 "module" 属性。

• 方法: PUT

• 错误：application/problem+json

请求负载应具有以下结构

{
    "module": "Status"
}

api/validators

此端点提供所有已注册验证器插件的排序列表；用例是在为服务创建输入过滤器时构建可用插件的下拉列表。Laminas ValidatorPluginManager 服务中存在的任何验证器都将表示。

• Accept: application/json

  成功时返回一个 application/json 响应。

• 方法：GET

• 错误：application/problem+json

成功请求的响应负载具有以下格式

{
  "validators": [
    "list",
    "of",
    "validators"
  ]
}

api/versioning

此端点用于向现有 API 添加新版本。如果在有效负载中未传递版本，则版本号将简单地递增。

• Accept: application/json

  成功时返回 JSON 结构，错误时返回 API-Problem 有效负载。

• Content-Type: application/json

  期望一个对象，其中包含 "module" 属性，提供 Laminas 或 Laminas API Tools 启用的模块的名称；可选地，也可以提供 "version" 属性以指示要使用的特定版本字符串。

• 方法: PATCH

• 错误：application/problem+json

请求负载应具有以下结构

{
    "module": "Status",
    "version": 10
}

成功时，服务返回以下结构

{
    "success": true,
    "version": "version string or integer"
}

api/module[/:name]

这是模块资源的标准端点。

• Accept: application/json

  在成功时，返回单个模块资源（当提供 name 时）或模块资源集合（当未提供 name 时）。

• Content-Type: application/json

  期望一个对象，该对象具有描述要创建的模块的 "name" 属性。

• 集合方法: GET、POST

• 资源方法： GET

• 错误：application/problem+json

在创建新的API模块时，使用以下请求负载

{
    "name": "Status"
}

api/module/:name/rpc[/:controller_service_name]

这是RPC资源的标准端点。

• Accept: application/json

  在成功时，返回单个RPC资源（当提供 controller_service_name 时）或RPC资源集合（当未提供 controller_service_name 时）。

• Content-Type: application/json

  期望一个对象，该对象具有描述要创建的端点的 "service_name" 属性。

  您还可以提供列出的任何其他RPC资源选项。

• 集合方法: GET、POST

• 资源方法： GET，PATCH

• 可以将查询字符串变量 version 传递给集合以按版本过滤结果：例如，/admin/api/module/:name/rpc?version=2。

• 错误：application/problem+json

必要的最小请求负载结构如下

{
    "service_name": "Status"
}

api/module/:name/rpc/:controller_service_name/inputfilter[/:input_filter_name]

此服务用于创建、更新和删除与给定RPC服务关联的命名输入过滤器。

• Accept: application/json

  在成功时，返回单个输入过滤器（当提供 input_filter_name 时）或输入过滤器集合（当未提供 input_filter_name 时）。通常，只有一个输入过滤器将与给定的RPC服务关联。

  返回的输入过滤器还将组成一个属性 input_filter_name，这是给定输入过滤器的标识符。

• Content-Type: application/json

  期望一个输入过滤器。

• 集合方法: GET、POST

• 资源方法： GET，PUT，DELETE

• 错误：application/problem+json

api/module/:name/rest[/:controller_service_name]

这是REST资源的标准端点。

可用于任何类型的REST资源，包括DB-Connected。

DB-Connected资源期望以下附加属性（并将返回它们）

• adapter_name：一个命名DB适配器服务。

• table_name：与此服务关联的数据库表。

• hydrator_name：可选；用于填充数据库返回的行的hydrator服务的名称；默认为ArraySerializable。

• table_service：可选；默认情况下自动生成，但可以提供替代的TableGateway服务。

• Accept: application/json

  在成功时，返回单个REST资源（当提供 controller_service_name 时）或REST资源集合（当未提供 controller_service_name 时）。

• Content-Type: application/json

  期望一个对象，该对象具有描述要创建的REST服务的 resource_name 属性。

  您还可以提供列出的任何其他REST资源选项。

• 集合方法： GET，POST，DELETE

• 资源方法： GET，PATCH

• 可以将查询字符串变量 version 传递给集合以按版本过滤结果：例如，/admin/api/module/:name/rest?version=2。

• 错误：application/problem+json

创建新的REST服务的最小结构如下

{
    "resource_name": "Status"
}

API模型

以下是通过上述API端点返回或预期用于请求体的各种模型的列表。

身份验证

HTTP基本身份验证

{
    "accept_schemes": [ "basic" ],
    "realm": "The HTTP authentication realm to use",
    "htpasswd": "path on filesystem to htpasswd file"
}

HTTP摘要身份验证

{
    "accept_schemes": [ "digest" ],
    "realm": "The HTTP authentication realm to use",
    "htdigest": "path on filesystem to htdigest file",
    "nonce_timeout": "integer; seconds",
    "digest_domains": "Space-separated list of URIs under authentication"
}

OAuth2身份验证

{
    "dsn": "PDO DSN of database containing OAuth2 schema",
    "username": "Username associated with DSN",
    "password": "Password associated with DSN",
    "route_match": "Literal route to match indicating where OAuth2 login/authorization exists"
}

身份验证2

HTTP基本身份验证

{
    "name" : "Name of the authentication adapter",
    "type": "basic",
    "realm": "The HTTP authentication realm to use",
    "htpasswd": "Path on filesystem to htpasswd file"
}

HTTP摘要身份验证

{
    "name" : "Name of the authentication adapter",
    "type": "digest",
    "realm": "The HTTP authentication realm to use",
    "digest_domains": "Space-separated list of URIs under authentication",
    "nonce_timeout": "integer; seconds",
    "htdigest": "Path on filesystem to htdigest file"
}

OAuth2身份验证（使用PDO）

{
    "name" : "Name of the authentication adapter",
    "type": "oauth2",
    "oauth2_type" : "pdo",
    "oauth2_route" : "Literal route to match indicating where OAuth2 login/authorization exists",
    "oauth2_dsn": "PDO DSN of database containing OAuth2 schema",
    "oauth2_username": "Username associated with DSN (optional)",
    "oauth2_password": "Password associated with DSN (optional)",
    "oauth2_options": "(optional)"
}

OAuth2身份验证（使用MongoDB）

{
    "name" : "Name of the authentication adapter",
    "type": "oauth2",
    "oauth2_type" : "mongo",
    "oauth2_route" : "Literal route to match indicating where OAuth2 login/authorization exists",
    "oauth2_dsn": "MongoDB DSN of database containing OAuth2 documents",
    "oauth2_database": "Database name",
    "oauth2_locator_name": "SomeServiceName class (optional)",
    "oauth2_options": "(optional)"
}

授权

{
    "Rest\Controller\Service\Name::__resource__": {
        "GET": bool,
        "POST": bool,
        "PUT": bool,
        "PATCH": bool,
        "DELETE": bool
    },
    "Rest\Controller\Service\Name::__collection__": {
        "GET": bool,
        "POST": bool,
        "PUT": bool,
        "PATCH": bool,
        "DELETE": bool
    },
    "Rpc\Controller\Service\Name::actionName": {
        "GET": bool,
        "POST": bool,
        "PUT": bool,
        "PATCH": bool,
        "DELETE": bool
    }
}

REST服务为其实体的每个实例和集合实例都有一条记录。RPC服务为每个公开的操作名称有一条记录（这通常只有一个）。每个服务都有一个HTTP方法的列表，并带有标志。false值表示不需要授权；true值表示需要授权。

注意：如果应用程序中设置了deny_by_default标志，则标志的含义相反；true表示方法是公开的，false表示需要认证。

db-adapter

{
    "adapter_name": "Service name for the DB adapter",
    "database": "Name of the database",
    "driver": "Driver used to make the connection"
}

此外，用于创建Laminas\Db\Adapter\Adapter实例的任何其他属性也可以组合：例如，“用户名”、“密码”等。

inputfilter

{
    "input_name": {
        "name": "name of the input; should match key of object",
        "validators": [
            {
                "name": "Name of validator service",
                "options": {
                    "key": "value pairs to specify behavior of validator"
                }
            }
        ]
    }
}

输入过滤器可以包含任意数量的输入，其格式遵循[Laminas输入过滤器文档](https://getlaminas.org/manual/2.3/en/modules/laminas.input-filter.intro.html)中描述的Laminas\InputFilter\Factory的格式。

目前，我们不允许嵌套输入过滤器。

module

{
    "name": "normalized module name",
    "namespace": "PHP namespace of the module",
    "is_vendor": "boolean value indicating whether or not this is a vendor (3rd party) module",
    "versions": [
        "Array",
        "of",
        "available versions"
    ]
}

此外，module资源为RPC和REST资源组合关系链；它们分别使用“rpc”和“rest”关系。

rpc

{
    "controller_service_name": "name of the controller service; this is the identifier, and required",
    "accept_whitelist": [
        "(Optional)",
        "List",
        "of",
        "whitelisted",
        "Accept",
        "mediatypes"
    ],
    "content_type_whitelist": [
        "(Optional)",
        "List",
        "of",
        "whitelisted",
        "Content-Type",
        "mediatypes"
    ],
    "http_options": [
        "(Required)",
        "List",
        "of",
        "allowed",
        "Request methods"
    ],
    "input_filter": "(Optional) Present in returned RPC services, when one or more input filters are present; see the inputfilter resource for details",
    "route_match": "(Required) String indicating Segment route to match",
    "route_name": "(Only in representation) Name of route associated with endpoint",
    "selector": "(Optional) Content-Negotiation selector to use; Json by default"
}

rest

{
    "controller_service_name": "name of the controller service; this is the identifier, and required",
    "accept_whitelist": [
        "(Optional)",
        "List",
        "of",
        "whitelisted",
        "Accept",
        "mediatypes"
    ],
    "adapter_name": "(Only in DB-Connected resources) Name of Laminas\\DB adapter service used for this resource",
    "collection_class": "(Only in representation) Name of class representing collection",
    "collection_http_options": [
        "(Required)",
        "List",
        "of",
        "allowed",
        "Request methods",
        "on collections"
    ],
    "collection_query_whitelist": [
        "(Optional)",
        "List",
        "of",
        "whitelisted",
        "query string parameters",
        "to pass to resource for collections"
    ],
    "content_type_whitelist": [
        "(Optional)",
        "List",
        "of",
        "whitelisted",
        "Content-Type",
        "mediatypes"
    ],
    "entity_class": "(Only in representation) Name of class representing resource entity",
    "entity_identifier_name": "(Optional) Name of entity field representing the identifier; defaults to 'id'",
    "hydrator_name": "(Only in DB-Connected resources) Name of Laminas\\Stdlib\\Hydrator service used for this resource",
    "route_identifier_name": "(Optional) Name of route parameter representing the resource identifier; defaults to resource_name + _id",
    "input_filter": "(Optional) Present in returned REST services, when one or more input filters are present; see the inputfilter resource for details",
    "module": "(Only in representation) Name of module in which resource resides",
    "page_size": "(Optional) Integer representing number of entities to return in a given page in a collection; defaults to 25",
    "page_size_param": "(Optional) Name of query string parameter used for pagination; defaults to 'page'",
    "resource_class": "(Only in representation) Name of class representing resource handling operations",
    "resource_http_options": [
        "(Required)",
        "List",
        "of",
        "allowed",
        "Request methods",
        "on individual resources"
    ],
    "route_match": "(Optional) String indicating Segment route to match; defaults to /resource_name[/:route_identifier_name]",
    "route_name": "(Only in representation) Name of route associated with api service",
    "selector": "(Optional) Content-Negotiation selector to use; HalJson by default",
    "table_name": "(Only in DB-Connected resources) Name of database table used for this resource",
    "table_service": "(Only in DB-Connected resources) Name of TableGateway service used for this resource"
}

Laminas事件

监听器

Laminas\ApiTools\Admin\Module

该监听器连接到MvcEvent::EVENT_RENDER，优先级为100。它负责根据控制器服务结果是否为实体或集合而条件性地附加监听器。如果检测到任一，则监听器将附加到Laminas\ApiTools\Hal\Plugin\Hal事件renderEntity和renderCollection.entity，确保它们将在HAL插件有机会开始渲染时被触发。

Laminas服务

模型

许多由api-tools-admin提供的模型服务要么处理PHP代码的生成和修改，要么处理基于PHP的配置文件的生成和修改。

• Laminas\ApiTools\Admin\Model\AuthenticationModel - 负责创建和修改HTTP基本、HTTP摘要和OAuth2策略的特定配置。敏感信息将写入本地配置文件，而结构信息将写入全局和模块文件。
• Laminas\ApiTools\Admin\Model\AuthorizationModelFactory - 负责将授权特定细节（允许/拒绝规则的ACL矩阵）写入模块配置文件。
• Laminas\ApiTools\Admin\Model\ContentNegotiationModel - 负责将自定义内容协商选择器写入全局配置文件。
• Laminas\ApiTools\Admin\Model\ContentNegotiationResource - 消费ContentNegotiationModel的REST资源，以公开内容协商配置管理的API端点。
• Laminas\ApiTools\Admin\Model\DbAdapterModel - 负责在应用级别的全局和本地配置文件之间写入数据库适配器特定配置。敏感信息将写入本地配置文件。
• Laminas\ApiTools\Admin\Model\DbAdapterResource - 消费DbAdapterModel的REST资源，以公开数据库适配器配置管理的API端点。
• Laminas\ApiTools\Admin\Model\DbConnectedRestServiceModel - 负责写入公开数据库表作为REST资源所需的配置信息。
• Laminas\ApiTools\Admin\Model\DocumentationModel - 负责写入模块配置目录中的特殊名称文件，该文件将包含API请求、响应以及API的所有可记录元素的所有自定义API文档。
• Laminas\ApiTools\Admin\Model\InputFilterModel - 负责为每个模块写入输入过滤器规范配置。
• Laminas\ApiTools\Admin\Model\FiltersModel - 负责通过API提供内置过滤器及其元数据列表。
• Laminas\ApiTools\Admin\Model\HydratorsModel - 负责配置和管理全局的hydrator服务名称列表。
• Laminas\ApiTools\Admin\Model\ModuleModel - 负责聚合模块信息，包括REST和RPC服务，并通过API公开这些信息。此外，在创建新模块时，这将创建启用Laminas API Tools模块所需的代码工件。
• Laminas\ApiTools\Admin\Model\ModuleResource - 负责在Laminas API Tools API中将ModuleModel公开为REST资源。
• Laminas\ApiTools\Admin\Model\RestServiceModel - 负责以可在Admin UI中创建和修改的方式呈现REST服务，正如它们在api-tools-rest中定义的那样。
• Laminas\ApiTools\Admin\Model\RestServiceResource - 负责消费RestServiceModel并将此模型作为REST资源在Laminas API Tools API中公开。
• Laminas\ApiTools\Admin\Model\RestServiceModelFactory - 负责创建RestServiceModel。
• Laminas\ApiTools\Admin\Model\RpcServiceModel - 负责以可在Admin UI中创建和修改的方式呈现RPC服务，正如它们在api-tools-rpc中定义的那样。
• Laminas\ApiTools\Admin\Model\RpcServiceResource - 负责消费RpcServiceModel并将此模型作为REST资源在Laminas API Tools API中公开。
• Laminas\ApiTools\Admin\Model\RpcServiceModelFactory - 负责创建RpcServiceModel。
• Laminas\ApiTools\Admin\Model\ValidatorsModel - 通过API提供可用验证器的列表。
• Laminas\ApiTools\Admin\Model\ValidatorMetadataModel - 提供有关通过ValidatorModel和验证器API提供的验证器的元数据。
• Laminas\ApiTools\Admin\Model\VersioningModel - 负责建模工作流程和模块代码创建工件，这些工件是提供特定Laminas API Tools基于REST或RPC服务的新版本所必需的。
• Laminas\ApiTools\Admin\Model\ModuleVersioningModelFactory - 负责创建ModuleVersioningModel。