Validando documentos JSON no PHP com JSON Schema \| TreinaWeb Promoção no ar Matricule-se agora e garanta **54% de desconto** Termina em Tempo restante da oferta: 14 Horas 16 Min 34 Seg Tempo restante da oferta: 14 16 34 [Assinar →](https://www.treinaweb.com.br/checkout/pagamento/plano/anual?cupom=TW-SCLIENTE26) [ ](https://www.treinaweb.com.br) Explorar [ Quanto custa? ](#assinatura) [ FAQ ](https://www.treinaweb.com.br#faq) [Matricule-se](#assinatura) [ Entrar ](https://www.treinaweb.com.br/login) [ Início ](https://www.treinaweb.com.br) [ Artigos ](https://www.treinaweb.com.br/blog) Validando documentos JSON no PHP com JSON Schema [ PHP ](https://www.treinaweb.com.br/blog/categoria/php) # Validando documentos JSON no PHP com JSON Schema JSON Schema é uma especificação para validação de documentos JSON. A ideia é parecida com a de um XSD (XML Schema Definition). Veja como documentos JSON podem ser validados. [ Kennedy Tedesco ](https://www.treinaweb.com.br/blog/autor/kennedy-tedesco) 10 anos atrás ![](https://dkrn4sk0rn31v.cloudfront.net/uploads/2017/05/validando-documentos-json-no-php-com-json-schema.png) [*JSON Schema*](http://json-schema.org/) é uma especificação para validação de documentos JSON. A ideia é parecida com a de um **XSD** *(XML Schema Definition)* e um exemplo sólido da utilização de esquemas XML se dá na implementação e geração de notas fiscais eletrônicas, onde é muito importante que os dados estejam corretos e que se siga uma estrutura previamente definida. Um esquema descreve a estrutura e os requerimentos que um documento deve ter. E a partir desses requerimentos podemos: - Gerar uma documentação do documento; - Validar o documento em cima do esquema; É muito comum arquivos de configuração no formato JSON e com JSON Schema podemos validá-los. São muitos os casos de uso. Até mesmo quando a sua aplicação precisa, por algum motivo, consumir algum JSON de metadados relevantes para ela. A especificação *JSON Schema* independe de linguagem. Você deve conseguir encontrar implementações dela para a sua linguagem favorita. Para esse artigo, vou usar o PHP. Mas as ideias aqui são facilmente portadas para qualquer outra linguagem. Só vai mudar a implementação do código que lidará com a validação. Suponhamos que a nossa aplicação precise consumir esse JSON: ```json { "name": "PHP", "frameworks": [ "Laravel", "Symfony", "Zend Framework", "Slim" ] } ``` Podemos validá-lo com o seguinte esquema: ```json { "type": "object", "properties": { "name": { "type": "string" }, "frameworks": { "type": "array", "items": { "type": "string", "minLength": 3 } } } } ``` Ele define que o documento precisa ter um objeto com dois atributos: *nome* e *frameworks*. O atributo *nome* deve aceitar apenas string e o atributo *frameworks* deve aceitar um array, sendo que cada item dele deve ser do tipo *string* e não pode ter menos que dois caracteres. Podemos testar a validação do nosso documento através do [JSON Schema Validator](http://www.jsonschemavalidator.net/): ![](https://d2m498l008ebpa.cloudfront.net/2017/05/Screen-Shot-2017-05-30-at-19.20.09.png) Na primeira coluna coloca-se o esquema e na segunda o JSON a ser validado. Faça um teste, adicione um item *“Yi”* no array do atributo *frameworks*: ```json { "name": "PHP", "frameworks": [ "Laravel", "Symfony", "Zend Framework", "Slim", "Yi" ] } ``` ![](https://d2m498l008ebpa.cloudfront.net/2017/05/Screen-Shot-2017-05-30-at-19.21.50.png) Não passou na validação por causa da restrição `"minLength": 3` que especifica que os itens do array precisam ter pelo menos três caracteres. Apesar do nosso exemplo ser simples e didático, ele nos dá uma visão geral do que pode ser feito. A especificação completa do *JSON Schema* você pode encontrar [aqui](http://json-schema.org/latest/json-schema-validation.html). Um exemplo um pouco mais complexo, retirado do [*Understanding JSON Schema*](https://spacetelescope.github.io/understanding-json-schema/structuring.html) que demonstra como podemos reaproveitar definições: ```json { "shipping_address": { "street_address": "1600 Pennsylvania Avenue NW", "city": "Washington", "state": "DC" }, "billing_address": { "street_address": "1st Street SE", "city": "Washington", "state": "DC" } } ``` O esquema: ```json { "$schema": "http://json-schema.org/draft-04/schema#", "definitions": { "address": { "type": "object", "properties": { "street_address": { "type": "string" }, "city": { "type": "string" }, "state": { "type": "string" } }, "required": [ "street_address", "city", "state" ] } }, "type": "object", "properties": { "billing_address": { "$ref": "#/definitions/address" }, "shipping_address": { "$ref": "#/definitions/address" } } } ``` Observe que na definição dos atributos do objeto ao invés de duplicarmos as especificações nós as reutilizamos informando a referência de onde podem ser encontradas: ```json "properties": { "billing_address": { "$ref": "#/definitions/address" }, "shipping_address": { "$ref": "#/definitions/address" } } ``` Veja também que na definição de `address` as propriedades foram marcadas como *required* (obrigatórias): ```json "required": [ "street_address", "city", "state" ] ``` Por exemplo, se o documento não informar um valor para a propriedade `city` ele não terá sucesso na validação. ## Validando JSON Schema no PHP Agora que tivemos um overview do que é e o que podemos fazer, chegamos na parte que realmente “toca” esse artigo que é a validação desses esquemas no PHP. Temos duas formas de fazer isso: - Via arquivo físico de esquema, por exemplo, *my\_schema.json*; - Em runtime via uma construção de arrays; Essa segunda opção pode ser útil quando há a necessidade de alterar o esquema em tempo de execução. É possível criar um esquema dinâmico que responda à necessidades específicas. E o documento JSON a ser validado temos a mesma relação. Ele pode ser importado de um arquivo físico ou ele pode ser construído em tempo de execução. Utilizaremos a library [*justinrainbow/json-schema*](https://github.com/justinrainbow/json-schema). --- **Observação:** Daqui pra frente é necessário que você tenha conhecimentos básicos em PHP e na utilização do Composer, o gerenciador de dependências oficial do PHP. Quer elevar os seus conhecimentos em PHP para um patamar profissional? Temos três excelentes cursos bases que podem te levar do zero ao mercado de trabalho: [ ![PHP - Recursos essenciais](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/php.svg) Curso PHP - Recursos essenciais Conhecer o curso ](https://www.treinaweb.com.br/curso/php-recursos-essenciais) [ ![Laravel - Eloquent ORM](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/laravel.svg) Curso Laravel - Eloquent ORM Conhecer o curso ](https://www.treinaweb.com.br/curso/laravel-eloquent-orm) [ ![PHP Avançado](https://d2knvm16wkt3ia.cloudfront.net/assets/svg-icon/php.svg) Curso PHP Avançado Conhecer o curso ](https://www.treinaweb.com.br/curso/php-avancado) --- Dando continuidade, no seu ambiente, onde normalmente você cria os seus projetos, crie uma nova pasta. No meu caso, vou chamá-la de `json-schema`. Dentro dessa pasta, crie um arquivo chamado `composer.json` com a seguinte definição: ```json { "require": { "justinrainbow/json-schema": "^5.2" } } ``` Especificamos a dependência do nosso projeto. Ainda na raiz dele, crie um arquivo json chamado “curso-schema.json” com a seguinte definição: ```json { "type": "object", "properties": { "name": { "type": "string" }, "frameworks": { "type": "array", "items": { "type": "string", "minLength": 3 } } } } ``` Crie outro arquivo chamado `curso.json`: ```json { "name": "PHP", "frameworks": [ "Laravel", "Symfony", "Zend Framework", "Slim" ] } ``` Agora, crie um arquivo PHP chamado `validate.php`. No momento essa é a estrutura do nosso projeto: ![](https://d2m498l008ebpa.cloudfront.net/2017/05/Screen-Shot-2017-05-31-at-10.11.16.png) O `validate.php` deve ter a seguinte implementação: ```php