Veritabanı Şemasını Değiştirme

// Modülünüz tanımlar, operatör anahtarı çevirdiğinde platform çağırır. "enable"da varsa
// önce activate(), sonra enable() çalışır; "disable"da deactivate()/disable() çifti aynısını
// yapar. Yeni durum YALNIZCA sonuncusu doğru bir değer döndürdüyse yazılır; yani yanlış bir
// dönüş ya da fırlatılan bir exception, modülü yarım kurulu bırakmak yerine tıklamayı reddeder.
public function enable(): bool;
public function disable(): bool;

// Kendi adımlarınız, enable() içinden çağrılır. Hem kurma hem yükseltme yolu burada yaşar;
// yani ikisi de her etkinleştirmede, her yeniden etkinleştirmede ve her güncellemeden sonra
// çalışır.
private function check_database(): void;   // tablolar
private function check_columns(): void;    // sonraki bir sürümün eklediği kolonlar
private function seed(): void;             // başlangıç satırları, bir kez

public static function hasTable($table = '');               // bool, SHOW TABLES LIKE ile - önek eklenmez
public static function exec($arg = '');                     // int etkilenen satır; başarısızlıkta 0, FIRLATMADAN
public static function query($statement, $isthis = false);  // PDOStatement ya da başarısızlıkta false - o da fırlatmadan
public static function getAssoc($statement = false);        // o statement'ın tek satırı; satır yoksa false
public static function getErrorMessage();                   // exec() ya da query() neden boş döndü
public static function getPrefix(): string;                 // kurulum bir önek tanımlamışsa şema öneki

// DDL exec()/query() üzerinden çalışır; çünkü zincirli kurucu yalnızca DML yazar. Bu ikisinden
// hiçbiri exception fırlatmaz: düşen bir CREATE ya da ALTER 0 / false döner ve hiçbir şey demez.

public function enable(): bool
{
    $this->check_database();
    $this->check_columns();

    return true;
}

private function check_database(): void
{
    if (\WDB::hasTable(self::TABLE)) {
        // Zaten kurulu: burası kurma değil yükseltme yolu. Her adımın kendi koşulu var;
        // böylece bir sürümü atlamış kurulum da aynı noktaya yakınsar.
        $old = \WDB::query("SHOW COLUMNS FROM `" . self::TABLE . "` LIKE 'ticket_id'");
        if ($old && \WDB::getAssoc($old))
            \WDB::exec("ALTER TABLE `" . self::TABLE . "` CHANGE `ticket_id` `owner_id` INT UNSIGNED NOT NULL DEFAULT 0");

        return;
    }

    $created = \WDB::exec('CREATE TABLE `' . self::TABLE . '` (
        `id`        INT UNSIGNED NOT NULL AUTO_INCREMENT,
        `owner_id`  INT UNSIGNED NOT NULL DEFAULT 0,
        `status`    VARCHAR(32)  NOT NULL DEFAULT "",
        `ctime`     DATETIME     NOT NULL,
        PRIMARY KEY (`id`),
        KEY `owner_id` (`owner_id`)
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4');

    // exec() hatayı yutar; başarıyı varsaymak yerine sorun.
    if (!\WDB::hasTable(self::TABLE))
        throw new \Exception('Tablo kurulamadı: ' . \WDB::getErrorMessage());

    $this->seed();
}

private function check_columns(): void
{
    // Sonraki bir sürümün getirdiği kolonlar; tablo => kolon => tanım.
    $columns = [
        self::TABLE => ['provider' => 'VARCHAR(30) NOT NULL DEFAULT ""'],
    ];

    foreach ($columns as $table => $definitions) {
        if (!\WDB::hasTable($table)) continue;

        foreach ($definitions as $column => $definition) {
            $stmt = \WDB::query("SHOW COLUMNS FROM `` LIKE ''");
            if ($stmt && \WDB::getAssoc($stmt)) continue;

            \WDB::exec("ALTER TABLE `` ADD COLUMN `` ");
        }
    }
}

private function seed(): void
{
    // Başlangıç satırları BİR KEZ girer. Modülü kapatıp yeniden açan bir operatör ne kopya
    // satır almalı ne de kendi düzenlemelerini kaybetmeli.
    $stmt  = \WDB::select('COUNT(id) AS total')->from(self::TABLE);
    $total = $stmt->build() ? (int) (($stmt->getAssoc() ?: [])['total'] ?? 0) : 0;
    if ($total > 0) return;

    \WDB::insert(self::TABLE, ['owner_id' => 0, 'status' => 'ready', 'ctime' => \DateManager::Now()]);
}

// Tek kullanımlık bir script: biçimi oku, adımı iki kez çalıştır, tekrar oku. "Tekrar
// çalıştırmaya güvenlidir" iddiası ancak iki okuma birbirini tuttuğunda bir şey ifade eder.
$module = Modules::getInstance('Addons', 'AcmeScanner');

$shape = static function (): array {
    $rows = WDB::query('SHOW COLUMNS FROM `Acme_scans`');
    $cols = $rows ? WDB::fetch_assoc($rows) : [];

    $count = WDB::select('COUNT(id) AS total')->from('Acme_scans');

    return [
        'columns' => array_column($cols, 'Field'),
        'rows'    => $count->build() ? (int) (($count->getAssoc() ?: [])['total'] ?? 0) : 0,
    ];
};

$module->enable();
$first = $shape();

$module->enable();
$second = $shape();

echo $first === $second ? "idempotent\n" : "SAPMA VAR\n";