Modül Yaşam Döngüsü

// Etkinleştirme yolu, bu sırayla. Önce activate(), sonra enable() koşar.
// false döndürmek modülü kapalı bırakır ve hiçbir şey yazılmaz.
public function activate(): bool;
public function enable(): bool;

// Kapatma yolu, bu sırayla.
public function deactivate(): bool;
public function disable(): bool;

// Modül dizini kaldırılmadan önce koşar. false döndürmek silmeyi iptal eder.
// Bu argümansız boolean biçim EKLENTİ biçimidir.
public function uninstall(): bool;

// Authentication tipi aynı adı farklı bir biçimle yeniden kullanır: saklanan
// kayıt verisi geçilir ve bir dizi döndürülür. Yalnız 'error' iptal eder.
public function uninstall(array $data = []): array;   // ['status' => 'successful']

// Test butonu. İki biçim var ve hangisini alacağınıza çağıran taraf karar verir:
// sosyal giriş sağlayıcıları ARGÜMANSIZ çağrılır (tabanda abstract),
// servis sağlayıcılar ise tek argüman olarak birleştirilmiş yapılandırmayla çağrılır.
public function testConnection(): bool;                  // SocialAuth
public function testConnection($config = []): bool;      // Registrars

// Eklenti tabanında zaten uygulanmıştır: yukarıdaki dört metodu koşturur, sonra
// yeni durumu config.php'ye yazar. Yalnız o davranışı değiştirmek için geçersiz kılın.
public function change_addon_status($arg = '');

public function change_addon_status($arg = '')
{
    $status = $arg == "enable";
    $apply  = true;

    if ($status && method_exists($this, 'activate'))    $apply = $this->activate();
    if ($status && method_exists($this, 'enable'))      $apply = $this->enable();
    if (!$status && method_exists($this, 'deactivate')) $apply = $this->deactivate();
    if (!$status && method_exists($this, 'disable'))    $apply = $this->disable();

    // Bayrak EN SON yazılır, hem de yalnız modül onay verdiyse.
    if ($apply) {
        $config           = $this->config;
        $config["status"] = $status;
        $this->save_config($config);
    }

    return $apply;
}

$key    = (string) Filter::init("POST/module", "route");
$status = (int) Filter::init("POST/status", "rnumbers");

$instance = Modules::getInstance("Addons", $key);

if (!method_exists($instance, "change_addon_status"))
    throw new Exception("Module class does not have a method named change_addon_status.");

$status = $status ? "enable" : "disable";

// Fırlatılan bir istisna doğrudan hata mesajı olarak dışarı çıkar. false dönüşü ise
// eski yoldur: çağıran taraf o zaman gerekçe için eski hata özelliğini okur.
$result = $instance->change_addon_status($status);
if (!$result) throw new Exception($instance->error ?: "Unknown error");

User::addAction($adata["id"], "alteration", "change-addon-status-" . $status, ['module' => $key]);

Hook::run('action:addon.status_changed', $key, $status);

public function enable(): bool
{
    // Bilerek idempotent: enable() her yeniden etkinleştirmede ve güncellemeden sonra tekrar koşar.
    $this->check_database();

    return true;
}

/** Yalnız ekler. Asla düşürmez, var olan bir kolonu asla yeniden yazmaz. */
private function check_database(): void
{
    if (!\WDB::hasTable("Acme_events"))
        \WDB::exec('CREATE TABLE `Acme_events` ('
            . '`id` INT(11) UNSIGNED NOT NULL AUTO_INCREMENT,'
            . '`service_id` INT(11) UNSIGNED NOT NULL DEFAULT 0,'
            . '`payload` TEXT NULL DEFAULT NULL,'
            . 'PRIMARY KEY (`id`)'
            . ') ENGINE = InnoDB CHARSET=utf8mb4 COLLATE utf8mb4_unicode_ci;');

    // Tablo ilk gönderildikten sonra eklenen kolonlar tek tek kontrol edilir.
    $col = \WDB::query("SHOW COLUMNS FROM `Acme_events` LIKE 'created_at'");
    if (!($col ? \WDB::getAssoc($col) : false))
        \WDB::exec("ALTER TABLE `Acme_events` ADD `created_at` INT(11) UNSIGNED NOT NULL DEFAULT '0'");
}

public function disable(): bool
{
    // Burada hiçbir şey düşürülmez. Kapatmak geri alınabilir bir işlemdir; modülü bir
    // öğleden sonra kapatan operatör bir yıllık satırı kaybetmemelidir.
    return true;
}

public function uninstall(): bool
{
    // Kaybedilecek bir şey varken sessizce yok etmek yerine reddedin.
    // select() OLUŞTURUCUYU döndürür, yani build() ve getAssoc() onun üzerinde çağrılır.
    // Oluşturucuyu WDB::getAssoc() metoduna argüman olarak vermek ölümcüldür: o
    // parametre bir PDOStatement bekler, onu da WDB::query() döndürür.
    $stmt = \WDB::select('COUNT(id) AS total')->from('Acme_events');
    $rows = $stmt->build() ? (int) (($stmt->getAssoc() ?: [])['total'] ?? 0) : 0;

    if ($rows > 0 && !(int) \Filter::init("POST/purge", "rnumbers"))
        throw new \Exception($this->lang['error-uninstall-has-data'] ?? 'The module still holds records.');

    \WDB::exec("DROP TABLE IF EXISTS `Acme_events`");

    return true;
}

// Modül etkin olsun olmasın, HER istekte koşar. Burayı yalnız kayıtlara ayırın.
Hook::add('gate:module.addon_delete', 1, function ($key) {
    if ($key !== 'Acme') return '';

    $stmt = WDB::select('COUNT(id) AS cnt')->from('Acme_events');
    $stmt->where('processed', '=', 0);

    $open = $stmt->build() ? (int) (($stmt->getAssoc() ?: [])['cnt'] ?? 0) : 0;

    // Boş olmayan dize reddin kendisidir ve operatörün okuduğu şey odur.
    return $open > 0 ? 'Acme still has ' . $open . ' unprocessed events.' : '';
});

Hook::add('action:addon.status_changed', 1, function ($key, $status) {
    if ($key !== 'Acme') return;

    Cache::getInstance()->clear(['acme']);
});