Modül Güncellemesi Yayınlama

{"type":"marketplace","id":42,"version":"1.2.0","last_updated":"2026-08-03"}

coremio/modules/Addons/AuroraBackup/AuroraBackup.php
coremio/modules/Addons/AuroraBackup/config.php
coremio/modules/Addons/AuroraBackup/manifest.json     <- dizini güncellenebilir yapar

templates/website/Aurora/theme.php
templates/website/Aurora/manifest.json                <- theme.php'nin yanında, yerine değil

// İki taraf da önce normalleştirilir: yalnız ilk satır ve yalnız bir sürümü oluşturan
// karakterler; böylece kaçak bir boşluk ya da bir yorum, hiçbir şeye eşit çıkan bir
// sürüm üretemez.
public static function normalize(string $version): string;
public static function is_newer(string $remote, string $local): bool;

// is_newer('2.10.0', '2.4.0')  === true    version_compare, dize sıralaması değil
// is_newer('1.2.0',  '1.2.0')  === false   eşit olan yeni değildir
// is_newer('1.2.0',  '')       === false   okunamayan taraf asla güncelleme tetiklemez

public function enable(): bool
{
    // Sıfırdan kurulum yolu.
    $this->check_database();

    return true;
}

public function adminArea(): array
{
    // Yükseltme yolu: enable() yıllar önce, önceki sürümde çoktan koştu.
    $this->check_database();

    // ...
    return ['page_title' => 'Aurora Backup', 'content' => $this->view('index.php')];
}

/**
 * Eksik olanı oluşturur ve sonradan eklenmiş olanı ekler. Her istekte çağrılması
 * güvenlidir: varlık kontrollerinin kendisi migration'dır.
 */
private function check_database(): void
{
    if (!WDB::hasTable('AuroraBackup_jobs')) {
        WDB::exec('CREATE TABLE `AuroraBackup_jobs` (
            `id` INT UNSIGNED NOT NULL AUTO_INCREMENT,
            `user_id` INT UNSIGNED NOT NULL DEFAULT 0,
            `created_at` DATETIME NOT NULL,
            PRIMARY KEY (`id`),
            KEY `owner` (`user_id`)
        ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_general_ci');

        // Her kolon zaten varken oluşturuldu: aşağıdaki hiçbir şeyin koşmasına gerek yok.
        return;
    }

    // 1.2'de eklendi: ondan önce yazılan işler bir zamanlamaya geri izlenemiyordu.
    $col = WDB::query("SHOW COLUMNS FROM `AuroraBackup_jobs` LIKE 'schedule_id'");
    if (!$col || !WDB::getAssoc($col))
        WDB::exec('ALTER TABLE `AuroraBackup_jobs` ADD `schedule_id` INT UNSIGNED NOT NULL DEFAULT 0 AFTER `user_id`');
}

[
  {"type": "features",     "text": "Scheduled jobs can now target a second storage account."},
  {"type": "improvements", "text": "Listing a bucket with many objects no longer times out."},
  {"type": "security",     "text": "Restore tokens are now single use."},
  {"type": "fixes",        "text": "A job cancelled during upload left a partial archive behind."}
]

// diskte olanı okuma
public static function manifest(string $dir): array;
public static function version(string $type, string $key): string;
public static function normalize(string $version): string;
public static function installed(bool $activeOnly = true): array;
public static function dir(array $item): string;

// yayıncıya sorma
public static function releases(array $items): array;
public static function pending(bool $activeOnly = true): array;
public static function issue(string $source, string $ident): array;
public static function notes(array $changelog): array;
public static function is_newer(string $remote, string $local): bool;

// tek bir güncellemeyi çalıştırma
public static function token(string $source, string $ident, string $version): string;
public static function begin(string $source, string $ident, string $version): array;
public static function job(string $token): array;
public static function step(string $token, string $step): array;
public static function abandon(string $token): void;
public static function write_manifest(string $dir, array $manifest): bool;

// STEPS sabit sıradır: download, extract, apply, finish.
// PRESERVED, apply adımının üzerine yazmayı reddettiği dosya adlarının listesidir: config.php.

// müşterinin diskinde olan
{"type": "marketplace", "id": 42, "version": "1.1.0", "last_updated": "2026-05-14"}

// 1.2.0 paketine koyduğunuz
{"type": "marketplace", "id": 42, "version": "1.2.0", "last_updated": "2026-08-03"}

AuroraBackup-1.2.0.zip
 └─ AuroraBackup/                 # tam olarak modül anahtarı
     ├─ AuroraBackup.php          # çıkarıcının aradığı dosya
     ├─ manifest.json             # sürüm 1.2.0
     ├─ config.php                # gönderilir, ama zaten varsa atlanır
     ├─ lang/
     │   └─ en.php                # bir dizin, asla düz bir lang.php değil
     └─ views/
         ├─ index.php
         └─ schedules.php         # 1.2.0'da yeni, düz kopya olarak gelir

<?php
// temp/_manifest-probe.php  :  paketin açılmış bir kopyası üzerinde çalıştırın
require dirname(__DIR__) . '/bootstrap.php';

$dir = MODULE_DIR . 'Addons' . DS . 'AuroraBackup';

$manifest = ModuleUpdater::manifest($dir);

// Boş olması, o dizine hiçbir zaman güncelleme sunulmayacağı demektir: bilinmeyen tip,
// eksik sürüm ya da id'siz bir marketplace kaydı.
if (!$manifest) exit("not managed: fix manifest.json\n");

$installed = (string) ($manifest['version'] ?? '');

echo 'reads as: ', $manifest['type'], ' / ', $installed, "\n";
echo ModuleUpdater::is_newer('1.2.0', $installed) ? "1.2.0 would be offered\n" : "1.2.0 would NOT be offered\n";

{
    "type": "marketplace",
    "id": 42,
    "version": "1.2.0",
    "last_updated": "2026-08-03"
}