Add option to inline only external references

[cebe]

Currently resolving references resolves all references unless they are recursive.

There should be more options to support cases where only external references should be inlined.
See also:
https://stoplight.io/blog/keeping-openapi-dry-and-portable/

[aedart]

Is there any way that this can be achieved in the current released version? If so, could you please point in the right direction?

[cebe]

It will be possible with release of version 1.5, on master you can use $resolveReferences parameter of readFromJsonFile() and readFromYamlFile():

php-openapi/src/Reader.php

Lines 64 to 66 in 015bd48

	* Since version 1.5.0 this can be a string indicating the reference resolving mode:
	* - `inline` only resolve references to external files.
	* - `all` resolve all references exceot recursive references.

[cebe]

• should be implemented in the command line tool:

  php-openapi/bin/php-openapi

  Lines 192 to 194 in 34f6e20

  	// TODO apply reference context mode
  	// $referenceContext->mode = ReferenceContext::RESOLVE_MODE_ALL;
  	// $referenceContext->mode = ReferenceContext::RESOLVE_MODE_INLINE;

• docs need to be added to the README

[cebe]

1.5.0 is going to be released today.