PHP函数中高效返回MySQL多行数据与自定义文本的最佳实践

// 原始函数示例（存在问题）
function Get() {
    // $link 未传入，作用域问题
    $sql = mysqli_query($link, "SELECT * FROM blabla");
    $value4 = 'certain';
    while($approw = mysqli_fetch_array($sql)){
        // $value 在每次循环中被覆盖
        $value= 'Fun '. $approw['value1'].' '.$approw['value2'].' '.$approw['value3'].'percent '.$value4.'<br />' ;
    }
    return $value.' Powered by Hisenseb'; // 只返回最后一行的数据和固定文本
}

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

    // 执行查询，并检查查询是否成功
    if ($res = $connect->query("SELECT value1, value2, value3 FROM blabla")) {
        // 使用 MYSQLI_ASSOC 获取所有结果，每行作为一个关联数组
        $rows = $res->fetch_all(MYSQLI_ASSOC);

        // 如果有结果，则处理自定义文本和结果集
        if (!empty($rows)) {
            // 假设自定义文本需要结合第一行的数据
            // 注意：如果需要为每行生成不同的文本，则需要在此处进行循环处理
            $firstRow = $rows[0];
            $ret['mytext'] = 'Fun ' . $firstRow['value1'] . ' ' . $firstRow['value2'] . ' ' . $firstRow['value3'] . 'percent ' . $customTextPart . '<br />';
            $ret['result-set'] = $rows; // 存储完整的查询结果集
        } else {
            // 查询无结果
            $ret['mytext'] = 'No data available. Powered by Hisenseb';
            $ret['result-set'] = [];
        }

        // 释放结果集
        $res->free();
    } else {
        // 查询失败，可以记录错误或抛出异常
        error_log("MySQL Query Error: " . $connect->error);
        return false; // 返回 false 表示操作失败
    }

    // 在函数结束前关闭连接（如果此连接仅用于此函数，否则应在外部管理）
    // $connect->close(); // 通常不在此处关闭，而是在所有数据库操作完成后关闭主连接

    // 如果返回数组非空，则返回它，否则返回 false
    return count($ret) > 0 ? $ret : false;
}

// 1. 建立数据库连接
$conn = new mysqli("localhost", "user", "password", "database");

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

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

// 3. 检查函数返回值并访问数据
if ($result !== false) {
    $sqlData = $result['result-set']; // 获取所有查询结果行
    $myText = $result['mytext'];       // 获取自定义文本

    echo "<h3>自定义信息：</h3>";
    echo $myText;

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

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

        // 示例：访问特定列的数据（例如第一行的某个列）
        // if (isset($sqlData[0]['column1'])) {
        //     $column1Value = $sqlData[0]['column1'];
        //     echo "<p>第一行 column1 的值是: " . htmlspecialchars($column1Value) . "</p>";
        // }
    } else {
        echo "<p>未查询到任何数据。</p>";
    }
} else {
    echo "<p>获取数据失败，请检查日志或数据库连接。</p>";
}

// 4. 关闭数据库连接
$conn->close();