Система отслеживания тикетов: реализация на PHP с примерами

Расширенные примеры реализации трекинга тикетов

Ниже приведены продвинутые сценарии, которые редко встречаются в простых руководствах, но полезны в реальных проектах.

Транзакционное создание тикета с комментарием

Гарантирует, что тикет и первый комментарий будут сохранены атомарно.

$pdo->beginTransaction();
try {
    $stmt = $pdo->prepare('INSERT INTO tickets (title, description) VALUES (?, ?)');
    $stmt->execute(['Проблема с заказом', 'Не приходит подтверждение']);
    $ticketId = $pdo->lastInsertId();

    $stmt = $pdo->prepare('INSERT INTO comments (ticket_id, text) VALUES (?, ?)');
    $stmt->execute([$ticketId, 'Создано автоматически']);

    $pdo->commit();
    echo 'Тикет #' . $ticketId . ' создан с комментарием';
} catch (Exception $e) {
    $pdo->rollBack();
    echo 'Ошибка: ' . $e->getMessage();
}

Тикет #12 создан с комментарием

Пагинация и фильтрация по нескольким полям

Мощный метод для списка тикетов с поиском по заголовку и фильтром по статусу.

function searchTickets(PDO $pdo, string $search = '', string $status = '', int $page = 1, int $perPage = 20): array {
    $conditions = [];
    $params = [];

    if ($search) {
        $conditions[] = 'title LIKE :search';
        $params['search'] = '%' . $search . '%';
    }
    if ($status) {
        $conditions[] = 'status = :status';
        $params['status'] = $status;
    }
    $where = $conditions ? 'WHERE ' . implode(' AND ', $conditions) : '';

    $offset = ($page - 1) * $perPage;
    $sql = "SELECT * FROM tickets {$where} ORDER BY created_at DESC LIMIT :limit OFFSET :offset";
    $stmt = $pdo->prepare($sql);
    foreach ($params as $key => $val) {
        $stmt->bindValue(":$key", $val);
    }
    $stmt->bindValue(':limit', $perPage, PDO::PARAM_INT);
    $stmt->bindValue(':offset', $offset, PDO::PARAM_INT);
    $stmt->execute();

    // Получение общего количества для пагинации
    $countSql = "SELECT COUNT(*) FROM tickets {$where}";
    $countStmt = $pdo->prepare($countSql);
    $countStmt->execute($params);
    $total = (int) $countStmt->fetchColumn();

    return [
        'data' => $stmt->fetchAll(PDO::FETCH_ASSOC),
        'total' => $total,
        'pages' => ceil($total / $perPage)
    ];
}

Array ( [data] => Array ( [0] => Array ( [id] => 1 [title] => ошибка [status] => new ... ) ) [total] => 15 [pages] => 1 )

Работа с датами: группировка по дням и подсчёт статистики

Для отчётов часто нужно знать количество созданных тикетов за каждый день.

$stmt = $pdo->query("
    SELECT DATE(created_at) as day, COUNT(*) as cnt
    FROM tickets
    WHERE created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    GROUP BY day
    ORDER BY day
");
$stats = $stmt->fetchAll(PDO::FETCH_ASSOC);
foreach ($stats as $row) {
    echo "{$row['day']}: {$row['cnt']} тикетов\n";
}

2025-03-01: 5 тикетов
2025-03-02: 12 тикетов
2025-03-03: 3 тикета

Обновление статуса с помощью именованных параметров и проверка допустимых значений

$allowedStatuses = ['new','in_progress','resolved','closed'];
$newStatus = 'resolved';
$ticketId = 42;

if (!in_array($newStatus, $allowedStatuses, true)) {
    throw new InvalidArgumentException('Недопустимый статус');
}
$stmt = $pdo->prepare('UPDATE tickets SET status = :status WHERE id = :id');
$stmt->execute(['status' => $newStatus, 'id' => $ticketId]);
echo 'Тикет #' . $ticketId . ' переведён в статус ' . $newStatus;

Тикет #42 переведён в статус resolved

Файловое хранение с блокировкой и атомарным обновлением

Реализация безопасной записи с использованием временного файла.

function atomicSaveTickets(array $tickets): void {
    $tmpFile = tempnam(sys_get_temp_dir(), 'tickets_');
    file_put_contents($tmpFile, json_encode($tickets, JSON_PRETTY_PRINT));
    rename($tmpFile, 'tickets.json'); // атомарная операция на большинстве систем
}

function addTicketSafe(string $title, string $desc): int {
    $tickets = loadTickets(); // обычная загрузка
    $id = empty($tickets) ? 1 : max(array_column($tickets, 'id')) + 1;
    $tickets[] = ['id' => $id, 'title' => $title, 'desc' => $desc, 'status' => 'new'];
    atomicSaveTickets($tickets);
    return $id;
}

Функция возвращает новый идентификатор, файл обновляется атомарно (без частичной записи).

Пример интеграции с Redmine через XML-RPC (старый, но возможный вариант)

$client = new xmlrpc_client("/xmlrpc/", "host", 80);
$msg = new xmlrpcmsg("issue.create");
$params = [
    new xmlrpcval([
        'project_id' => new xmlrpcval(1, 'int'),
        'subject' => new xmlrpcval('Тестовый тикет', 'string'),
        'description' => new xmlrpcval('Описание', 'string'),
    ], 'struct')
];
$msg->method('issue.create');
$msg->params($params);
$resp = $client->send($msg);
if ($resp->faultCode()) {
    echo 'Ошибка: ' . $resp->faultString();
} else {
    echo 'Тикет создан, ID: ' . $resp->value()->scalarval();
}

Тикет создан, ID: 1234