example.php
<?php
require_once __DIR__ . '/vendor/autoload.php';
$schemaData = json_decode(<<<'JSON'
{
"type": "object",
"properties": {
"id": {"type": "integer"},
"name": {"type": "string"},
"parent": {"$ref": "#"},
"children": {"type": "array", "items": {"$ref": "#"}},
"info": {"$ref": "#/definitions/info"}
},
"definitions": {
"info": {
"type": "object",
"properties": {
"lastName": {"type": "string"},
"birthDate": {"type": "string", "format": "date"},
"options": {"$ref": "#/definitions/options"}
}
},
"options": {
"type": "object",
"properties": {
"rememberSession": {"type": "boolean"},
"allowNotifications": {"type": "boolean"}
}
}
}
}
JSON
);
$swaggerSchema = \Swaggest\JsonSchema\Schema::import($schemaData);
$appPath = realpath(__DIR__ . '/tests/src/Tmp') . '/Example';
$appNs = 'Swaggest\PhpCodeBuilder\Tests\Tmp\Example';
$app = new \Swaggest\PhpCodeBuilder\App\PhpApp();
$app->setNamespaceRoot($appNs, '.');
$builder = new \Swaggest\PhpCodeBuilder\JsonSchema\PhpBuilder();
$builder->buildSetters = true;
$builder->makeEnumConstants = true;
$builder->classCreatedHook = new \Swaggest\PhpCodeBuilder\JsonSchema\ClassHookCallback(
function (\Swaggest\PhpCodeBuilder\PhpClass $class, $path, $schema) use ($app, $appNs) {
$desc = '';
if ($schema->title) {
$desc = $schema->title;
}
if ($schema->description) {
$desc .= "\n" . $schema->description;
}
if ($fromRefs = $schema->getFromRefs()) {
$desc .= "\nBuilt from " . implode("\n" . ' <- ', $fromRefs);
}
$class->setDescription(trim($desc));
$class->setNamespace($appNs);
if ('#' === $path) {
$class->setName('User'); // Class name for root schema
} elseif ('#/definitions/' === substr($path, 0, strlen('#/definitions/'))) {
$class->setName(\Swaggest\PhpCodeBuilder\PhpCode::makePhpClassName(
substr($path, strlen('#/definitions/'))));
}
$app->addClass($class);
}
);
$builder->getType($swaggerSchema);
$app->clearOldFiles($appPath);
$app->store($appPath);
// Importing raw data to entity class instance will do validation and mapping
$user = \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\User::import(
json_decode('{"name":"John","info":{"lastName":"Doe","birthDate":"1980-01-01","options":{"rememberSession":true,"allowNotifications":false}}}')
);
var_dump($user->info->options->allowNotifications); // bool(false)
$user = new \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\User();
$user->name = "John";
$user->info = (new \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\Info())
->setLastName("Doe")
->setBirthDate("1980-01-01")
->setOptions(
(new \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\Options())
->setRememberSession(true)
->setAllowNotifications(false)
);
// No exception on exporting valid data
$jsonData = \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\User::export($user);
// {"name":"John","info":{"lastName":"Doe","birthDate":"1980-01-01","options":{"rememberSession":true,"allowNotifications":false}}}
echo json_encode($jsonData), "\n";
// Setting invalid value (integer instead of string)
$user->name = 123;
// Exception: String expected, 123 received at #->$ref[#]->properties:name
try {
$jsonData = \Swaggest\PhpCodeBuilder\Tests\Tmp\Example\User::export($user);
} catch (Exception $e) {
echo 'Failed to export user: ' . $e->getMessage(). "\n";
}