heeby / php-raml-parser

A RAML parser built in php

PHP RAML Parser

!!Attention!! this is a work-in-progress of the RAML 1.0 specification, for RAML 0.8 see the master branch

What is done and should work

• Part of RAML 1.0 type expressions
• Enums
• Union type expression (the "or" | operator)
• Array of types
• discriminator and discriminatorValue facets

Still TODO:

• Libraries
• User defined facets
• Full implementation of type expressions
  • The shorthand array and the union type have been implemented
  • Bi-dimensional array and the array-union combination have NOT been implemented yet.
• Multiple inheritance
• Annotations
• Overlays and Extensions
• Improved Security Schemes

Original documentation

Parses a RAML file into a PHP object.

See the RAML spec here: https://github.com/raml-org/raml-spec

Get started

Requires:

• composer (see https://getcomposer.org)

composer require elama/php-raml-parser --dev

$parser = new \Raml\Parser();
$apiDef = $parser->parse($filename, true);

$title = $apiDef->getTitle();

Parsing schemas

The library can convert schemas into an validation object. There is a default list, or they can be configured manually. Each schema parser needs to conform to \Raml\Schema\SchemaParserInterface and will return a instance of \Raml\Schema\SchemaDefinitionInterface.

Additional parsers and schema definitions can be created and passed into the \Raml\Parser constructor

Exporting routes

It is also possible to export the entire RAML file to an array of the full endpoints. For example, considering a basic RAML, this can be returned using:

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

$routes = $api->getResourcesAsUri();

To return:

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

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

Route Formatters

There are two Route Formatters included in this package:

• NoRouteFormatter which does nothing and simply echoes the result
• SymfonyRouteFormatter which adds the routes to a Symfony RouteCollection

Contributing

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

TODO

• Documentation/Markdown parser
• Date Representations?
• Parse RAML at provided URL

Supported (I Believe)

• Includes
  • .yml/.yaml
  • .raml/.rml
  • .json (parsed using json-schema)
• Display Name
• Traits
• Resource Types