Files
php-qml/framework/php/src/Maker/templates/Controller.tpl.php

96 lines
3.0 KiB
PHP
Raw Normal View History

Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
<?= "<?php\n" ?>
declare(strict_types=1);
namespace App\Controller;
use <?= $entity_fqcn ?>;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Attribute\Route;
Phase 3 sub-commit 5: maker-output snapshot test + phase closure framework/php/tests/snapshot/ holds reference output for every shipped maker (resource Todo, command MarkAllDone, window Todo). The run.sh script: - git-archives the skeleton into a temp dir - composer-installs against the bundle's real path - removes the existing maker outputs so the regenerators don't bail - runs the three makers - diffs each generated file against the matching baseline CI / make quality fail on any drift; if a template change is intended, the baselines must be regenerated in the same commit. Wired into: - framework/skeleton/Makefile's `quality` target (local/dev runs) - .gitea/workflows/ci.yml (CI runs after qmllint) Plus a few hardenings discovered while wiring this up: - The resource maker template now injects NormalizerInterface (not SerializerInterface — that interface lacks ::normalize()). All Todo controllers re-rendered to match. - The command maker template emits a $this->em->flush() so the injected EntityManager isn't a property.onlyWritten violation in PHPStan after the user fills in the body. - phpstan.neon and php-cs-fixer's Finder both exclude tests/snapshot so the baselines aren't auto-rewritten or analysed as live code. CI workflow now also installs FrankenPHP, builds the todo example, and runs the bridge-integration test from Phase 3 sub-commit 4. Phase 3 done. Outstanding follow-ups (deferred per spec): the qmltestrunner-driven QML unit tests, make:bridge:event, make:bridge:read-model, ReactiveObject pagination. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 16:03:41 +02:00
use Symfony\Component\Serializer\Normalizer\NormalizerInterface;
Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
/**
* Auto-generated CRUD controller for the <?= $singular ?> bridge resource.
* Edit freely re-running make:bridge:resource won't overwrite this file.
*/
#[Route('<?= $route ?>')]
final class <?= $entity_short ?>Controller
{
public function __construct(
private readonly EntityManagerInterface $em,
Phase 3 sub-commit 5: maker-output snapshot test + phase closure framework/php/tests/snapshot/ holds reference output for every shipped maker (resource Todo, command MarkAllDone, window Todo). The run.sh script: - git-archives the skeleton into a temp dir - composer-installs against the bundle's real path - removes the existing maker outputs so the regenerators don't bail - runs the three makers - diffs each generated file against the matching baseline CI / make quality fail on any drift; if a template change is intended, the baselines must be regenerated in the same commit. Wired into: - framework/skeleton/Makefile's `quality` target (local/dev runs) - .gitea/workflows/ci.yml (CI runs after qmllint) Plus a few hardenings discovered while wiring this up: - The resource maker template now injects NormalizerInterface (not SerializerInterface — that interface lacks ::normalize()). All Todo controllers re-rendered to match. - The command maker template emits a $this->em->flush() so the injected EntityManager isn't a property.onlyWritten violation in PHPStan after the user fills in the body. - phpstan.neon and php-cs-fixer's Finder both exclude tests/snapshot so the baselines aren't auto-rewritten or analysed as live code. CI workflow now also installs FrankenPHP, builds the todo example, and runs the bridge-integration test from Phase 3 sub-commit 4. Phase 3 done. Outstanding follow-ups (deferred per spec): the qmltestrunner-driven QML unit tests, make:bridge:event, make:bridge:read-model, ReactiveObject pagination. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 16:03:41 +02:00
private readonly NormalizerInterface $normalizer,
Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
) {
}
#[Route('', name: '<?= $resource ?>_list', methods: ['GET'])]
public function list(): JsonResponse
{
$items = $this->em->getRepository(<?= $entity_short ?>::class)->findAll();
Phase 3 sub-commit 5: maker-output snapshot test + phase closure framework/php/tests/snapshot/ holds reference output for every shipped maker (resource Todo, command MarkAllDone, window Todo). The run.sh script: - git-archives the skeleton into a temp dir - composer-installs against the bundle's real path - removes the existing maker outputs so the regenerators don't bail - runs the three makers - diffs each generated file against the matching baseline CI / make quality fail on any drift; if a template change is intended, the baselines must be regenerated in the same commit. Wired into: - framework/skeleton/Makefile's `quality` target (local/dev runs) - .gitea/workflows/ci.yml (CI runs after qmllint) Plus a few hardenings discovered while wiring this up: - The resource maker template now injects NormalizerInterface (not SerializerInterface — that interface lacks ::normalize()). All Todo controllers re-rendered to match. - The command maker template emits a $this->em->flush() so the injected EntityManager isn't a property.onlyWritten violation in PHPStan after the user fills in the body. - phpstan.neon and php-cs-fixer's Finder both exclude tests/snapshot so the baselines aren't auto-rewritten or analysed as live code. CI workflow now also installs FrankenPHP, builds the todo example, and runs the bridge-integration test from Phase 3 sub-commit 4. Phase 3 done. Outstanding follow-ups (deferred per spec): the qmltestrunner-driven QML unit tests, make:bridge:event, make:bridge:read-model, ReactiveObject pagination. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 16:03:41 +02:00
return new JsonResponse($this->normalizer->normalize($items, 'json'));
Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
}
#[Route('', name: '<?= $resource ?>_create', methods: ['POST'])]
public function create(Request $request): JsonResponse
{
$data = json_decode((string) $request->getContent(), true) ?? [];
$entity = new <?= $entity_short ?>();
if (isset($data['title'])) {
$entity->setTitle((string) $data['title']);
}
if (isset($data['done'])) {
$entity->setDone((bool) $data['done']);
}
$this->em->persist($entity);
$this->em->flush();
return new JsonResponse(
Phase 3 sub-commit 5: maker-output snapshot test + phase closure framework/php/tests/snapshot/ holds reference output for every shipped maker (resource Todo, command MarkAllDone, window Todo). The run.sh script: - git-archives the skeleton into a temp dir - composer-installs against the bundle's real path - removes the existing maker outputs so the regenerators don't bail - runs the three makers - diffs each generated file against the matching baseline CI / make quality fail on any drift; if a template change is intended, the baselines must be regenerated in the same commit. Wired into: - framework/skeleton/Makefile's `quality` target (local/dev runs) - .gitea/workflows/ci.yml (CI runs after qmllint) Plus a few hardenings discovered while wiring this up: - The resource maker template now injects NormalizerInterface (not SerializerInterface — that interface lacks ::normalize()). All Todo controllers re-rendered to match. - The command maker template emits a $this->em->flush() so the injected EntityManager isn't a property.onlyWritten violation in PHPStan after the user fills in the body. - phpstan.neon and php-cs-fixer's Finder both exclude tests/snapshot so the baselines aren't auto-rewritten or analysed as live code. CI workflow now also installs FrankenPHP, builds the todo example, and runs the bridge-integration test from Phase 3 sub-commit 4. Phase 3 done. Outstanding follow-ups (deferred per spec): the qmltestrunner-driven QML unit tests, make:bridge:event, make:bridge:read-model, ReactiveObject pagination. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 16:03:41 +02:00
$this->normalizer->normalize($entity, 'json'),
Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
Response::HTTP_CREATED,
);
}
#[Route('/{id}', name: '<?= $resource ?>_update', methods: ['PATCH'])]
public function update(string $id, Request $request): JsonResponse
{
$entity = $this->em->getRepository(<?= $entity_short ?>::class)->find($id);
if (null === $entity) {
return new JsonResponse(
['title' => 'Not Found', 'status' => 404],
Response::HTTP_NOT_FOUND,
['Content-Type' => 'application/problem+json'],
);
}
$data = json_decode((string) $request->getContent(), true) ?? [];
if (isset($data['title'])) {
$entity->setTitle((string) $data['title']);
}
if (isset($data['done'])) {
$entity->setDone((bool) $data['done']);
}
$this->em->flush();
Phase 3 sub-commit 5: maker-output snapshot test + phase closure framework/php/tests/snapshot/ holds reference output for every shipped maker (resource Todo, command MarkAllDone, window Todo). The run.sh script: - git-archives the skeleton into a temp dir - composer-installs against the bundle's real path - removes the existing maker outputs so the regenerators don't bail - runs the three makers - diffs each generated file against the matching baseline CI / make quality fail on any drift; if a template change is intended, the baselines must be regenerated in the same commit. Wired into: - framework/skeleton/Makefile's `quality` target (local/dev runs) - .gitea/workflows/ci.yml (CI runs after qmllint) Plus a few hardenings discovered while wiring this up: - The resource maker template now injects NormalizerInterface (not SerializerInterface — that interface lacks ::normalize()). All Todo controllers re-rendered to match. - The command maker template emits a $this->em->flush() so the injected EntityManager isn't a property.onlyWritten violation in PHPStan after the user fills in the body. - phpstan.neon and php-cs-fixer's Finder both exclude tests/snapshot so the baselines aren't auto-rewritten or analysed as live code. CI workflow now also installs FrankenPHP, builds the todo example, and runs the bridge-integration test from Phase 3 sub-commit 4. Phase 3 done. Outstanding follow-ups (deferred per spec): the qmltestrunner-driven QML unit tests, make:bridge:event, make:bridge:read-model, ReactiveObject pagination. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 16:03:41 +02:00
return new JsonResponse($this->normalizer->normalize($entity, 'json'));
Phase 2 sub-commit 4: make:bridge:resource maker Bundle picks up symfony/maker-bundle as require-dev. New BridgeResourceMaker under PhpQml\Bridge\Maker generates three files for a named resource: - src/Entity/<Name>.php — Doctrine entity with #[BridgeResource] and a UUIDv7 id by default. --int-id flips to auto-incrementing int IDs. - src/Controller/<Name>Controller.php — CRUD on /api/{plural} (list, create, update, delete) with serializer- normalised JSON responses. - {qml_path}/<Name>List.qml — starter ListView wrapped around a ReactiveListModel bound to the right topic and source URL. The Doctrine subscriber from sub-commit 2 picks the entity up automatically — no per-resource listener generated. The QML snippet target defaults to '../qml/' (relative to the Symfony project root) and is overridable via the maker's $qmlPath constructor arg. Templates live under src/Maker/templates/ as .tpl.php files using short-echo and alternative-syntax control structures by convention. PHPStan and php-cs-fixer skip them — the maker's Generator binds the template variables at render time. Skeleton picks up MakerBundle as a `dev` bundle and require-dev'd symfony/maker-bundle, so `bin/console make:bridge:resource Todo` works out-of-the-box. Verified: maker runs end-to-end against `Todo` and emits readable, syntactically valid output. composer quality (16 tests, 45 assertions, PHPStan clean, cs-fixer clean) stays green. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 02:45:42 +02:00
}
#[Route('/{id}', name: '<?= $resource ?>_delete', methods: ['DELETE'])]
public function delete(string $id): JsonResponse
{
$entity = $this->em->getRepository(<?= $entity_short ?>::class)->find($id);
if (null === $entity) {
return new JsonResponse(null, Response::HTTP_NO_CONTENT);
}
$this->em->remove($entity);
$this->em->flush();
return new JsonResponse(null, Response::HTTP_NO_CONTENT);
}
}