Çekirdek Yükseltmesini Atlatma

const VERSION_STEPS  = ['download', 'extract', 'database', 'configuration', 'apply'];
const PREIMAGE_DIR   = 'updates-preimage';   // coremio/storage/ altında
const PREIMAGE_KEEP  = 3;                    // saklanan koşu; yeni koşu açılınca budanır
const LINT_SECONDS   = 60.0;                 // kapı lint bütçesi, dosya sayısı değil süre
const LINT_MAX_FILES = 2000;                 // süre bütçesinin arkasındaki emniyet freni
const HTTP_SETTLE_SECONDS = 5;               // sormadan önce ve geri yükledikten sonra beklenir

public static function open(array $opts, string $workerId): int;
public static function tick(int $runId, string $workerId): array;
public static function health_probe(): array;
public static function restorable(): array;
public static function restore_last(): array;
public static function parked(array $run): bool;

public static function check_state(): array;
public static function check_new_version(): array;
public static function next_versions(string|int $ver = 0): array;
public static function run_active(string $kind = 'core'): array;
public static function last_completed_run(string $kind = 'core'): array;
public static function run_get(int $id): array;
public static function sc_state(): array;

// coremio/helpers/license.php - sistemin şu an kendini hangi sürüm saydığı.
public static function version($realtime = false): string;

{"type":"marketplace","name":"AcmeBilling","version":"1.2.0","last_updated":"2026-07-28"}

namespace WISECP\Modules\Addons\Acme\Src;

class Compat
{
    // Bağımlılık yüzeyi, veri olarak. Bu modülün kendi dizini dışında dokunduğu her şey
    // burada listelenir; böylece prob, yeniden yazım değil listenin kendisi olur.
    private const NEEDS_METHOD = [
        'Checkout::payment_methods',
        'Services::get',
        'Invoices::create',
    ];

    private const NEEDS_HOOK = [
        'filter:order.cart_totals',
        'action:order.checkout_completed',
    ];

    private const CORE_MIN = '5.0.0';
    private const CORE_MAX = '6.0.0';   // hariç: ana sürüm sıçraması tercihe bağlıdır, varsayılmaz

    /** @return array{ok:bool,errors:string[],skipped:string[],version:string} */
    public static function check(): array
    {
        $errors = $skipped = [];
        $core   = \License::version();

        if (version_compare($core, self::CORE_MIN, '<'))
            $errors[] = 'core ' . $core . ' is below the minimum ' . self::CORE_MIN;

        if (version_compare($core, self::CORE_MAX, '>='))
            $skipped[] = 'core ' . $core . ' is newer than this module was tested against';

        foreach (self::NEEDS_METHOD as $ref) {
            [$class, $method] = explode('::', $ref, 2);
            if (!class_exists($class))            $errors[] = 'missing class: ' . $class;
            elseif (!method_exists($class, $method)) $errors[] = 'missing method: ' . $ref;
        }

        // Sonuç değil, yetenek sorusu. FPM altında bunlar genelde kapalıdır ama aynı
        // sunucunun CLI'ı onları açık tutar; "soramadım" asla "düştü" diye okunmamalı.
        if (!function_exists('exec')) $skipped[] = 'subprocess probes (exec unavailable)';

        foreach (self::NEEDS_HOOK as $hook)
            if (!self::hook_seen($hook)) $skipped[] = 'hook not observed yet: ' . $hook;

        return ['ok' => !$errors, 'errors' => $errors, 'skipped' => $skipped, 'version' => $core];
    }

    /*
     * Kanca ADLARININ çalışma zamanı kaydı yoktur: kancalar beyan edilmez, ateşlenir ve
     * deposu özeldir. Dolayısıyla tek dürüst cevap gözleme dayanır: aşağıdaki kanarya,
     * nokta gerçekten ateşlendiğinde bir zaman damgası kaydeder ve "görülmedi" atlanandır,
     * asla hata değil, çünkü o noktaya henüz hiç ulaşılmamış olabilir.
     */
    public static function canary(string $hook): void
    {
        $seen = (array) \Utility::jdecode((string) \Config::getd('acme_hook_seen'), true);
        $seen[$hook] = time();

        \Config::setd('acme_hook_seen', \Utility::jencode($seen));
    }

    private static function hook_seen(string $hook): bool
    {
        $seen = (array) \Utility::jdecode((string) \Config::getd('acme_hook_seen'), true);

        return (int) ($seen[$hook] ?? 0) > 0;
    }
}

use WISECP\Modules\Addons\Acme\Src\Compat;

include_once __DIR__ . DS . 'src' . DS . 'Compat.php';

// Öncelik 1: asıl dinleyicinin önünde, böylece gözlem ondan bağımsız olur.
Hook::add('filter:order.cart_totals', 1, function (&$summary, $items, $subtotal) {
    Compat::canary('filter:order.cart_totals');
});

// Modülün kendisinin arkasında durduğu kapı. Uyumsuz bir çekirdek, birinin ödeme
// akışının içinde hata fırlatmak yerine özelliği devre dışı bırakır.
$acme_compat = Compat::check();

if ($acme_compat['ok']) {
    Hook::add('filter:order.cart_totals', 20, function (&$summary, $items, $subtotal) {
        // ... asıl iş
    });
}
else {
    Hook::add('ui:admin.body.end', 90, function () use ($acme_compat) {
        return '<!-- acme disabled: ' . htmlspecialchars(implode('; ', $acme_compat['errors'])) . ' -->';
    });
}

# Kapının gerçekte ne gördüğü, ölçemedikleri dahil.
cat coremio/storage/updates-preimage/*/gate.json

# Koşudan bu yana çıkan hatalar; yutulmuş bir dinleyici istisnasının tek izi burasıdır.
php coremio/errlog.php list --limit=20