kantarciandClaude Opus 5
6afad30956
Migration 20260912000900 ergänzt page.publish_at, page.deleted_at und revision.seq. Verschieben nimmt den ganzen Teilbaum mit und hinterlässt für jede alte Adresse ein 301. Kollisionen, Tiefengrenze und das Verschieben unter eigene Unterseiten werden vor der ersten Änderung abgewiesen; alles in einer Transaktion, weil ein halb verschobener Teilbaum Seiten unerreichbar machen würde. Der Papierkorb ersetzt das sofortige Löschen für die Editorrolle: alle Fassungen bleiben, öffentlich 404, verschwunden aus Navigation, Archiven, Feed, Sitemap, llms.txt und Editorliste. Unterseiten gehen mit, beim Wiederherstellen muss das Elternteil zuerst zurück. Eine Fassung wiederherzustellen überschreibt nichts, sondern legt eine neue an. revision.seq behebt dabei einen echten Fehler: die Reihenfolge des Verlaufs war nicht eindeutig, weil created_at nur Sekunden kennt und mehrere Speichervorgänge in dieselbe Sekunde fallen - "vorherige Fassung wiederherstellen" hätte die falsche treffen können. Geplante Veröffentlichung über cms:publish-due. Ohne Cron bleibt die Seite ein Entwurf, was die sichere Richtung ist. Eine frei wählbare Startseite fehlt bewusst: der Pfad home gilt an elf Stellen als Wurzel, das ist ein eigener Schritt (ADR 022). Geprüft: 160 PHP-Tests / 622 Assertions unter PHP 8.2.12 und 8.4.22, 15 JavaScript-Modelltests, vollständiger Editortest mit axe, Migration zuerst gegen eine Datenbankkopie samt Kontrolle des Backfills. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
78 lines
3.2 KiB
PHP
78 lines
3.2 KiB
PHP
<?php
|
|
|
|
namespace DoctrineMigrations;
|
|
|
|
use Doctrine\DBAL\Connection;
|
|
use Doctrine\DBAL\Schema\Index;
|
|
use Doctrine\DBAL\Schema\Schema;
|
|
use Doctrine\Migrations\AbstractMigration;
|
|
|
|
final class Version20260912000900 extends AbstractMigration
|
|
{
|
|
public function getDescription(): string
|
|
{
|
|
return 'Scheduled publication and a recycle bin instead of immediate deletion.';
|
|
}
|
|
|
|
public function isTransactional(): bool
|
|
{
|
|
return false;
|
|
}
|
|
|
|
public function up(Schema $schema): void
|
|
{
|
|
$page = $schema->getTable('page');
|
|
// When set and in the past, the stored draft is published by cms:publish-due.
|
|
$page->addColumn('publish_at', 'datetime_immutable', ['notnull' => false]);
|
|
// A page in the bin keeps every revision but answers publicly with 404 and stays out of
|
|
// menus, archives and the sitemap until it is restored or finally removed.
|
|
$page->addColumn('deleted_at', 'datetime_immutable', ['notnull' => false]);
|
|
|
|
// created_at only has second precision, and several saves land in the same second. The
|
|
// revision list and "restore this version" need a strict order, so every revision of a
|
|
// page carries a counter. Filled in postUp() from the existing timestamps.
|
|
$schema->getTable('revision')->addColumn('seq', 'integer', ['notnull' => true, 'default' => 0]);
|
|
}
|
|
|
|
public function postUp(Schema $schema): void
|
|
{
|
|
// Existing revisions keep their order; within one second the previous order is preserved.
|
|
foreach ($this->connection->fetchAllAssociative('SELECT DISTINCT page_id FROM revision') as $page) {
|
|
$number = 0;
|
|
foreach ($this->connection->fetchAllAssociative(
|
|
'SELECT id FROM revision WHERE page_id = ? ORDER BY created_at ASC, id ASC',
|
|
[$page['page_id']],
|
|
) as $revision) {
|
|
$this->connection->executeStatement('UPDATE revision SET seq = ? WHERE id = ?', [++$number, $revision['id']]);
|
|
}
|
|
}
|
|
self::applyIndexes($this->connection);
|
|
}
|
|
|
|
/** Shared with the test bootstraps so they get the same lookup indexes as a migrated database. */
|
|
public static function applyIndexes(Connection $connection): void
|
|
{
|
|
$manager = $connection->createSchemaManager();
|
|
$existing = $manager->listTableIndexes('page');
|
|
foreach ([
|
|
new Index('idx_page_publish_at', ['publish_at']),
|
|
new Index('idx_page_deleted_at', ['deleted_at']),
|
|
] as $index) {
|
|
if (!isset($existing[$index->getName()])) {
|
|
$connection->executeStatement($connection->getDatabasePlatform()->getCreateIndexSQL($index, 'page'));
|
|
}
|
|
}
|
|
if (!isset($manager->listTableIndexes('revision')['idx_revision_order'])) {
|
|
$connection->executeStatement($connection->getDatabasePlatform()->getCreateIndexSQL(
|
|
new Index('idx_revision_order', ['page_id', 'seq']),
|
|
'revision',
|
|
));
|
|
}
|
|
}
|
|
|
|
public function down(Schema $schema): void
|
|
{
|
|
$this->throwIrreversibleMigrationException('Dropping deleted_at would silently republish pages an editor removed. Restore a verified database backup with matching code.');
|
|
}
|
|
}
|