paysera / alecsammon-php-raml-parser

此软件包已被废弃,不再维护。作者建议使用 paysera/fork-alecsammon-php-raml-parser 软件包。

基于php构建的RAML解析器

2.5.2 2018-04-02 09:17 UTC

README

将RAML文件解析为PHP对象。

Build Status Coverage Status HHVM Status

在此处查看RAML规范:https://github.com/raml-org/raml-spec

入门

要求

composer require alecsammon/php-raml-parser --dev
$parser = new \Raml\Parser();
$apiDef = $parser->parse($filename, true);

$title = $apiDef->getTitle();

解析模式

该库可以将模式转换为验证对象。有一个默认列表,也可以手动配置。每个模式解析器都需要遵守 \Raml\Schema\SchemaParserInterface 并返回一个 \Raml\Schema\SchemaDefinitionInterface 实例。

可以创建额外的解析器和模式定义,并将它们传递给 \Raml\Parser 构造函数

导出路由

还可以将整个RAML文件导出到完整端点的数组中。例如,考虑一个基本RAML,这可以通过以下方式返回

$parser = new Raml\Parser();
$api = $parser->parse('test/fixture/simple.raml');

$routes = $api->getResourcesAsUri();

返回

[
	GET /songs => ...
	POST /songs => ...
	GET /songs/{songId} => ...
	DELETE /songs/{songId} => ...
]

$routes = $api->getResourcesAsUri(new Raml\RouteFormatter\NoRouteFormatter());

路由格式化程序

此包包含两个路由格式化程序

  • NoRouteFormatter,它不做任何事情,只是简单地回显结果
  • SymfonyRouteFormatter,它将路由添加到Symfony RouteCollection

贡献

./vendor/bin/phpunit
./vendor/bin/phpunit --coverage-text
./vendor/bin/phpcs --standard=PSR1,PSR2 src

待办事项

  • 文档/Markdown解析器
  • 日期表示?
  • 在提供的URL解析RAML

支持(我相信)

  • 包括
    • .yml/.yaml
    • .raml/.rml
    • .json(使用json-schema解析)
  • 显示名称
  • 特质
  • 资源类型