twincitiespublictelevision / libmvault
PBS MVault 数据处理的一般结构
v2.0.0
2019-07-08 21:26 UTC
Requires
- php: >=7.1
- ext-json: *
Requires (Dev)
- fzaninotto/faker: ^1.8
- phpunit/phpunit: ^7.3
This package is auto-updated.
Last update: 2024-09-08 05:43:01 UTC
README
libmvault
是一个小型包,包含几个用于结构化使用 MVault 数据的类。
概述
提供了两个主要类: MVaultRecord
和 PBSProfile
两者都支持从 JSON、数组或 stdClass 表示的 MVault 记录创建对象。创建记录将分别返回 MVaultResult
或 PBSProfileResult
。结果封装了创建的对象或错误,具体取决于调用的成功与否。
使用方法
文档可在 https://twincitiespublictelevision.github.io/libmvault/ 找到
结果类提供了一种返回样式,用于在单个返回值中捕获给定操作的成败。然后,调用代码可以从结果中提取值或错误,并根据条件使用它们。一个 ok 值表示操作成功,而一个 err 值表示操作失败。
当尝试解析数组、stdClass 或字符串时,如果记录的解析整个成功,则返回 ok。如果任何步骤失败,则返回包含错误的 err。
结果类的通用使用示例
$resultA = Result::ok("foo"); echo $resultA->value(); // foo $resultB = Result::err(new \Exception("Bar error"); echo $resultB->value(); // PHP Fatal error: Uncaught exception ...
要安全地处理结果并提取其值,调用者可以使用条件语句或 try / catch 语法
$resultA = Result::ok("foo"); if ($resultA->isOk()) { echo $result->value(); // foo } else { // ... } $resultB = Result::err(new \Exception("Bar error"); try { echo $resultB->value(); } catch (\Exception $e) { echo $e->getMessage(); // Bar error }
要求
- PHP >= 7.1
安装
- 将以下内容添加到您的 composer.json 文件的 repositories 键中
{
"type": "vcs",
"url": "https://github.com/twincitiespublictelevision/libmvault.git"
}
- 运行
composer require twincitiespublictelevision/libmvault
以获取包