<?php

/**
 * 动态生成 Bootstrap 栅格布局
 *
 * @param int $totalItem 总项目数
 * @param int $totalItemPerLine 每行显示的项目数
 * @return string 生成的 HTML 字符串
 */
function generateDynamicGrid(int $totalItem, int $totalItemPerLine): string
{
    $html = '';

    // 避免除以零和不合理的布局
    if ($totalItemPerLine <= 0) {
        return '<div class="alert alert-warning" role="alert">每行项目数必须大于0。</div>';
    }
    if ($totalItem <= 0) {
        return ''; // 没有项目，返回空字符串
    }

    // 计算基础列宽，用于满行的情况
    // Bootstrap 栅格系统总宽度为 12
    $baseColWidth = 12 / $totalItemPerLine;

    // 确保基础列宽是整数，否则 Bootstrap 类会不准确
    if ($baseColWidth !== floor($baseColWidth)) {
        // 如果无法整除，可以根据实际需求调整。
        // 例如，可以选择最接近的整数列，或者在每行项目数不为 1,2,3,4,6,12 时，
        // 考虑使用更复杂的 flexbox 布局或手动设置百分比宽度。
        // 为简化本教程，我们假设 totalItemPerLine 会产生整数列宽 (如 1,2,3,4,6,12)。
        // 否则，可能需要使用 col-sm-auto 或 flexbox 辅助类。
        // 这里我们直接向下取整，但请注意这可能导致布局不精确。
        // 更好的做法是，当 $totalItemPerLine 无法被 12 整除时，
        // 考虑使用 col-sm 或 col-md 等响应式类，或者直接使用 flexbox 布局。
        // 为了满足示例要求，我们假设 $totalItemPerLine 总是 1, 2, 3, 4, 6, 12 中的一个。
        // 如果不是，此处的逻辑可能需要更复杂的判断。
    }

    // 计算总行数
    $totalRows = ceil($totalItem / $totalItemPerLine);

    // 循环遍历所有项目
    for ($i = 0; $i < $totalItem; $i++) {
        // 如果是每行的第一个项目，则开启一个新的 div.row
        if ($i % $totalItemPerLine === 0) {
            $html .= '<div class="row">';
        }

        $colClass = '';
        // 计算当前项目所在的行数 (从 1 开始)
        $currentRow = floor($i / $totalItemPerLine) + 1;

        // 判断是否为最后一行，并且该行没有被填满
        if ($currentRow === $totalRows && ($totalItem % $totalItemPerLine !== 0)) {
            // 这是最后一行，且未填满
            $remainingInLastRow = $totalItem % $totalItemPerLine; // 最后一行的实际项目数
            if ($remainingInLastRow === 1) {
                // 如果只剩一个项目，让它独占一行
                $colClass = 'col-12';
            } else {
                // 如果剩余多个项目，它们平分剩余空间
                // 例如，如果剩余2个，则 col-6；剩余3个，则 col-4
                $colClass = 'col-' . (12 / $remainingInLastRow);
            }
        } else {
            // 不是最后一行，或者最后一行刚好填满，使用基础列宽
            $colClass = 'col-' . $baseColWidth;
        }

        // 添加项目 div 及其内容
        $html .= '<div class="col ' . $colClass . '">项目 ' . ($i + 1) . '</div>';

        // 如果是每行的最后一个项目，或者它是整个列表的最后一个项目，则关闭 div.row
        if ($i % $totalItemPerLine === ($totalItemPerLine - 1) || $i === $totalItem - 1) {
            $html .= '</div>'; // 关闭当前行
        }
    }

    return $html;
}

?>