Download the PHP package systopia/opis-json-schema-ext without Composer

On this page you can find all versions of the php package systopia/opis-json-schema-ext. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package opis-json-schema-ext

Systopia Opis JSON Schema Extension

This is an extension for Opis JSON Schema.

Keywords

The following additional keywords are provided:

See tests for how to use them.

The SystopiaValidator already provides those keywords. To use them in a different validator class you might want to use SystopiaSchemaParser or SystopiaVocabulary.

Limit validation

The keyword $limitValidation allows to limit validation under specifiable conditions. The reason behind this keyword was to persist forms in an incomplete state. This can also be achieved with the if-then-else keywords, though it dramatically increases the size of the schema and is error-prone (at least for complex schemas).

The structure of the $limitValidation keyword is:

rules can have an indefinite number of entries.

If the schema at condition is matched, limited validation is performed. It is applied on the keywords at the same depth and the keywords below. If it's not set, the result of the condition evaluation on a higher level is used. If the $limitValidation keyword is not used at a higher level, false is used as fallback.

The properties of a rule have the following defaults:

To the entries in rules the default rules are always appended. To prevent the execution of the default rules a rule with just the validate property can be used ({ "validate": false } or { "validate": true }).

schema has the default value true.

If the specified condition is matched, the rules are applied in case of a violation of a keyword at the same depth or of a keyword below. In case of a violation it will be iterated over the rules until a matching rule is found. If the validate property of that rule is false the violation will be ignored.

The rule matching is done like this:

All schemas must be matched for a rule to be matched. If calculatedValueUsedViolatedData is not null, the value has to be calculated (with the $calculate keyword) and must or must not have used violated data depending on the actual value of calculatedValueUsedViolatedData. Violated data is used, if the calculation references a value that has a validation error (including ignored ones).

The keyword schema allows to specify a schema that is validated additionally, if the condition is matched. This allows for example to require some properties on limited validation: "schema": { "required": ["foo", "bar"] }.

Example:

This means that if the property action is set to "save", limited validation is applied. The rules say that only violations are treated as such, if these conditions are met:

All other violations are ignored because of the second rule.

Additionally, the property example is required, if action is "save".

Default rules

The default rules are:

The rules mean:

  1. No violation error, if the validated value is null.
  2. No violation error, if the violated keyword is not type and the validated value is false or "" (empty string).
  3. No violation error, if the validated keyword is one of: minLength, minItems, minContains, minProperties, required, dependentRequired
  4. No violation error, if value is calculated and calculation used data with violations (including ignored ones).
  5. Every other validation without limitation.

Empty array to object conversion

If the option convertEmptyArrays is set to true (disabled by default), empty arrays will be converted to objects if the schema type contains object, but not array. This might be necessary if the data to validate was already decoded.

Translation

This extension allows to translate ValidationErrors:

First create an instance of TranslatorInterface:

If there is a localisation in the messages directory you can use:

Then create an instance of ErrorTranslator:

Let the ErrorTranslator translate a validation error:


All versions of opis-json-schema-ext with dependencies

PHP Build Version
Package Version
Requires php Version ^8
beberlei/assert Version ^3 || ^4
opis/json-schema Version ^2.3
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package systopia/opis-json-schema-ext contains the following files

Loading the files please wait ....