TODO comment (ARCH7183)

Key php.quality.todo-comment · Severity info · Category quality

TODO/FIXME/HACK/XXX markers left in code signal unfinished work and get forgotten over time. Resolve them before merge or link them to a tracking issue.

Incorrect

<?php
function chargeCustomer(int $cents): void
{
    // TODO: add error handling
    $this->gateway->charge($cents);
}

Correct

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

Fix

Complete the work the TODO describes, or link it to a tracked issue and remove the comment.