PBS MVault 数据处理的一般结构

v2.0.0 2019-07-08 21:26 UTC

This package is auto-updated.

Last update: 2024-09-08 05:43:01 UTC


README

CircleCI

libmvault 是一个小型包,包含几个用于结构化使用 MVault 数据的类。

概述

提供了两个主要类: MVaultRecordPBSProfile

两者都支持从 JSON、数组或 stdClass 表示的 MVault 记录创建对象。创建记录将分别返回 MVaultResultPBSProfileResult。结果封装了创建的对象或错误,具体取决于调用的成功与否。

使用方法

文档可在 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

安装

  1. 将以下内容添加到您的 composer.json 文件的 repositories 键中
{
  "type": "vcs",
  "url": "https://github.com/twincitiespublictelevision/libmvault.git"
}
  1. 运行 composer require twincitiespublictelevision/libmvault 以获取包