README

Laravel YAML 解析器和配置加载器

理由

配置文件越来越大，难以维护和查看，每天都是如此。为什么不直接使用 YAML 来加载它们呢？

哪一个更简洁？

主要特性

加载一个文件到 Laravel 配置

Yaml::loadToConfig(config_path('myapp.yml'), 'my-app-conf');

或整个目录，递归地，这样所有这些文件都会通过一个命令加载

Yaml::loadToConfig(config_path('myapp'), 'my-app-conf');

加载包含所有配置文件的目录

.
└── myapp
    ├── multiple
    │   ├── alter.yml
    │   ├── app.yml
    │   └── second-level
    │       └── third-level
    │           ├── alter.yml
    │           └── app.yml
    ├── single
        └── single-app.yml

然后你就可以像通常在 Laravel 中那样使用它

config('my-app-conf.multiple.second-level.third-level.alter.person.name')

执行函数，就像在常规 Laravel PHP 数组配置中那样。

repository: "{{ env('APP_NAME') }}"
path: "{{ storage_path('app') }}"

配置值可以引用配置键，你只需要这样引号即可

{{'format.version'}}

你可以在 YAML 文件中添加注释，这是 JSON 不允许的

build:
  mode: git-local  #### other modes: git-remote or number

解析器和转储方法

如果你需要直接处理 YAML，你可以使用这些公共方法

Yaml::parse($input, $flags) // Parses YAML into a PHP value.

Yaml::parseFile($filename, $flags) // Parses a YAML file into a PHP value.

Yaml::dump($input, $inline, $indent, $flags) // Dumps a PHP value to a YAML string.

这些是到 Symfony 的 YAML 的简单桥接。

安装

通过 Composer

$ composer require pragmarx/yaml

使用

像通常一样发布你的包

$this->publishes([
    __DIR__.'/../config/version.yml' => $this->getConfigFile(),
]);

在 boot() 方法中加载配置

$this->app
     ->make('pragmarx.yaml')
     ->loadToConfig($this->getConfigFile(), 'my-package');

或使用 Facade

Yaml::loadToConfig(config_path('myapp.yml'), 'my-package');

它会被合并到你的 Laravel 配置中

config('my-package.name');

示例

这是来自使用此包的另一个包的 YAML 文件

current:
  major: 1
  minor: 0
  patch: 0
  format: "{$major}.{$minor}.{$patch}"
cache:
  enabled: true
  key: pragmarx-version
build:
  mode: git-local # git-remote or number
  number: 701031
  git-local: "git rev-parse --verify HEAD"
  git-remote: "git ls-remote {$repository} refs/heads/master"
  repository: "{{ env('APP_GIT_REPOSITORY') }}"
  length: 6
format:
  version: "{$major}.{$minor}.{$patch} (build {$build})"
  full: "version {{'format.version'}}"
  compact: "v{$major}.{$minor}.{$patch}-{$build}"
  ## add as many formats as you need

最低要求

• Laravel 5.5
• PHP 7.0

许可

此包根据 MIT 许可证授权 - 详细信息请参阅 LICENSE 文件

贡献

欢迎拉取请求和问题。