README

这是大多数 Nodes 包使用的主要包。

📝 简介

此包是我们 Nodes 中所说的“核心”包。它包含许多有用的方法，使得开发其他包和项目更加容易。

此包最重要的特点是它包含默认 Exception 的修改版本。我们对它进行了微调，以支持自定义 HTTP 状态码和消息。这些自定义 HTTP 状态码在我们的所有项目中使用，以将特定于项目的错误代码返回给我们的移动开发者。

因此，您会发现许多 Nodes 包都将此核心包作为必需依赖项，因为它要么使用自定义的 Exception，要么使用我们的任何辅助方法。

最后但同样重要的是，此包还包含 Browscap 包，这使得解析用户代理变得更加容易，当与像 Bugsnag 这样的服务一起使用时非常方便。

📦 安装

要安装此包，您需要

• Laravel 5.1+
• PHP 5.5.9+

然后，您必须修改您的 composer.json 文件并运行 composer update 以将包的最新版本包含到您的项目中。

"require": {
    "nodes/core": "^1.0"
}

或者，您可以从终端运行 composer require 命令。

composer require nodes/core

🔧 设置

在 config/app.php 中设置服务提供者

Nodes\ServiceProvider::class,

在 config/app.php 中设置别名（可选）

'NodesUserAgent' => Nodes\Support\Facades\UserAgent::class,

发布配置文件

php artisan vendor:publish --provider="Nodes\ServiceProvider"

如果您想覆盖任何现有的配置文件，请使用 --force 参数

php artisan vendor:publish --provider="Nodes\ServiceProvider" --force

注意事项

如果您正在使用此类中存在的 Nodes\Http\Request\FormRequest，您会注意到在 Web 调用中如果验证失败，它会报告异常（这不会干扰 UX）。可以通过在 app/Exceptions/Handler.php 中的 $dontReport 数组中添加 Illuminate\Validation\ValidationException 来避免这种情况。对于 API 调用不需要这样做，因为异常将是 Nodes\Validation\Exceptions\ValidationException，并且默认情况下不会报告。

🏆 致谢

此包由 Nodes 的 PHP 团队开发和维护。

📄 许可证

此包是开源软件，受 MIT 许可证 许可。