TODO yorumu (ARCH7183)

Anahtar php.quality.todo-comment · Önem info · Kategori quality

Koda bırakılan TODO/FIXME/HACK/XXX işaretleri, tamamlanmamış işi gösterir ve zamanla unutulur. Birleştirmeden önce bunları çözün veya bir takip kaydına bağlayın.

Hatalı

<?php
function chargeCustomer(int $cents): void
{
    // TODO: hata yönetimi ekle
    $this->gateway->charge($cents);
}

Doğru

<?php
function chargeCustomer(int $cents): void
{
    try {
        $this->gateway->charge($cents);
    } catch (GatewayException $e) {
        $this->logger->error('charge failed', ['exception' => $e]);
        throw $e;
    }
}

Düzeltme

TODO ile işaretlenen işi tamamlayın veya bir issue takip kaydına bağlayıp yorumu kaldırın.