在PHP函数中高效返回MySQL多行结果与自定义文本

<?php

/**
 * 从数据库获取数据，并结合自定义文本返回。
 *
 * @param mysqli $connect 数据库连接对象。
 * @return array|false 返回一个包含SQL结果集和自定义文本的关联数组，如果查询失败则返回false。
 */
function Get(mysqli $connect)
{
    $ret = []; // 初始化一个空数组，用于存储所有返回数据
    $value4 = 'certain'; // 自定义文本的一部分

    // 执行SQL查询
    // 建议：在实际应用中，查询语句应避免硬编码，并考虑参数化查询以防SQL注入。
    if ($res = $connect->query("SELECT value1, value2, value3 FROM blabla")) {
        // 使用 fetch_all(MYSQLI_ASSOC) 获取所有结果行，并以关联数组形式返回
        $rows = $res->fetch_all(MYSQLI_ASSOC);

        // 检查是否有结果行，并处理自定义文本
        if (!empty($rows)) {
            // 假设我们想用第一行数据来生成自定义文本。
            // 如果需要针对每行生成文本，则应在外部循环处理 $rows。
            $firstRow = $rows[0]; // 获取第一行数据
            $ret['mytext'] = 'Fun ' . $firstRow['value1'] . ' ' . $firstRow['value2'] . ' ' . $firstRow['value3'] . 'percent ' . $value4 . '<br />';
        } else {
            // 如果没有查询到数据，可以设置一个默认的文本或标记
            $ret['mytext'] = 'No data found. Powered by Hisenseb';
        }

        // 将完整的SQL结果集存储到返回数组中
        $ret['result-set'] = $rows;

        // 释放结果集内存
        $res->free();
    } else {
        // 查询失败，可以记录错误或返回特定的错误信息
        error_log("SQL Query Error: " . $connect->error);
        return false; // 返回false表示操作失败
    }

    // 在函数结束时关闭连接（如果此连接仅用于此函数且不再需要）
    // 注意：如果 $connect 对象在函数外部被复用，不应在此处关闭。
    // 更常见的做法是在所有数据库操作完成后，在程序的更高层级关闭连接。
    // $connect->close(); // 根据实际连接管理策略决定是否在此处关闭

    // 检查返回数组是否包含数据，如果包含则返回，否则返回false
    return count($ret) > 0 ? $ret : false;
}

?>

<?php

// 1. 建立数据库连接
// 替换为你的数据库连接信息
$conn = new mysqli("localhost", "your_user", "your_password", "your_database");

// 检查连接是否成功
if ($conn->connect_error) {
    die("数据库连接失败: " . $conn->connect_error);
}

// 2. 调用 Get 函数
$result = Get($conn);

// 3. 处理返回结果
if ($result !== false) {
    // 获取SQL查询结果集
    $sqlResultSet = $result['result-set'];
    // 获取自定义文本
    $myCustomText = $result['mytext'];

    echo "<h3>自定义文本:</h3>";
    echo $myCustomText;

    echo "<h3>SQL查询结果:</h3>";
    if (!empty($sqlResultSet)) {
        echo "<table border='1'>";
        // 打印表头 (假设所有行都有相同的键)
        echo "<tr>";
        foreach (array_keys($sqlResultSet[0]) as $columnName) {
            echo "<th>" . htmlspecialchars($columnName) . "</th>";
        }
        echo "</tr>";

        // 遍历并打印每一行数据
        foreach ($sqlResultSet as $row) {
            echo "<tr>";
            foreach ($row as $value) {
                echo "<td>" . htmlspecialchars($value) . "</td>";
            }
            echo "</tr>";
        }
        echo "</table>";

        // 示例：如何访问特定列的值（例如第一行的 'value1'）
        // if (isset($sqlResultSet[0]['value1'])) {
        //     echo "<p>第一行 value1: " . htmlspecialchars($sqlResultSet[0]['value1']) . "</p>";
        // }

    } else {
        echo "<p>未从数据库中获取到任何数据。</p>";
    }
} else {
    echo "<p>获取数据失败，请检查错误日志。</p>";
}

// 4. 关闭数据库连接（在所有操作完成后）
$conn->close();

?>