如何从PHP函数中返回多行MySQL查询结果并附加自定义文本

<?php

/**
 * 从数据库中获取数据并附加自定义消息。
 *
 * @param mysqli $connect 数据库连接对象。
 * @return array|false 成功时返回包含查询结果集和自定义消息的关联数组，失败时返回false。
 */
function getDataWithCustomMessage(mysqli $connect)
{
    $ret = []; // 用于存储返回数据的数组
    $additionalInfo = 'certain'; // 示例：自定义的额外信息

    // 执行SQL查询并进行错误检查
    if ($res = $connect->query("SELECT value1, value2, value3 FROM blabla")) {
        // 使用 fetch_all(MYSQLI_ASSOC) 一次性获取所有结果行，并以关联数组形式存储
        $rows = $res->fetch_all(MYSQLI_ASSOC);

        // 将查询结果集存储在 'result_set' 键下
        $ret['result_set'] = $rows;

        // 生成自定义消息，存储在 'custom_message' 键下
        // 注意：这里的自定义消息是通用信息，不依赖于单行数据。
        // 如果需要每行数据都有特定消息，应在遍历 $rows 时处理。
        $ret['custom_message'] = '数据已成功检索。附加说明：' . $additionalInfo . '。';

        // 释放结果集内存
        $res->free();
    } else {
        // 查询失败，可以记录错误日志或返回更详细的错误信息
        error_log("数据库查询失败: " . $connect->error);
        return false; // 返回false表示操作失败
    }

    // 如果 $ret['result_set'] 为空，表示没有查询到数据，但操作本身可能成功
    // 根据需求决定是返回空数组还是 false
    return count($ret['result_set']) > 0 ? $ret : ['result_set' => [], 'custom_message' => '未查询到任何数据。附加说明：' . $additionalInfo . '。'];
}

?>

<?php

// 1. 创建数据库连接
// 替换为您的实际数据库连接参数
$host = "localhost";
$user = "your_username";
$password = "your_password";
$database = "your_database";

$conn = new mysqli($host, $user, $password, $database);

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

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

// 3. 处理返回结果
if ($resultData !== false) {
    // 访问查询结果集
    $sqlRows = $resultData['result_set'];

    // 访问自定义消息
    $customMessage = $resultData['custom_message'];

    echo "<h2>自定义消息:</h2>";
    echo "<p>" . $customMessage . "</p>";

    echo "<h2>查询结果:</h2>";
    if (!empty($sqlRows)) {
        echo "<table border='1'>";
        echo "<tr><th>Value 1</th><th>Value 2</th><th>Value 3</th></tr>";
        foreach ($sqlRows as $row) {
            echo "<tr>";
            echo "<td>" . htmlspecialchars($row['value1']) . "</td>";
            echo "<td>" . htmlspecialchars($row['value2']) . "</td>";
            echo "<td>" . htmlspecialchars($row['value3']) . "</td>";
            echo "</tr>";
            // 如果需要每行都有自定义文本，可以在这里拼接或处理
            // echo "<td>Fun " . htmlspecialchars($row['value1']) . " ...</td>";
        }
        echo "</table>";
    } else {
        echo "<p>数据库中没有匹配的数据。</p>";
    }
} else {
    echo "<p>数据获取失败，请检查日志。</p>";
}

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

?>