northwoods / openapi

Tools for working with OpenAPI specifications

Northwoods OpenApi

Tools for working with OpenAPI specifications.

Installation

The best way to install and use this package is with composer:

composer require northwoods/openapi

Usage

Conversion

This package supports converting OpenAPI schemas to JSON Schema proper:

use Northwoods\OpenApi\Converter;

// See below for options
$converter = new Converter($options);

/** @var object */
$schema = /* load your schema */;

$schema = $converter->convert($schema);

Note that references are not resolved and only schemas can be converted. It is recommended that conversion is used in conjunction with justinrainbow/json-schema.

Options

The following options are available:

• boolean removeReadOnly remove all schemas with readOnly = true
• boolean removeWriteOnly remove all schemas with writeOnly = true
• string[] keepUnsupported do not remove these schema properties

Credits

The converter is based on the excellent openapi-to-json-schema package. Type/format conversions are influenced by this PHP port.