PHP中将多行权限数据转换为单行多列的教程

本教程旨在解决php中将多行权限数据转换为单行多列显示的问题。针对原始数据中同一用户和页面下存在多条权限记录的情况，我们通过一种高效的数据预处理方法，将权限类型动态转换为独立的列。文章详细介绍了如何构建中间数据结构，并基于此结构生成清晰、易读的html表格，从而避免在渲染阶段进行复杂逻辑判断，提高代码的可维护性和执行效率。

引言：数据透视的需求

在许多应用场景中，我们经常会遇到需要将扁平化、多行的关系型数据转换为更具汇总性、列式展示的格式。一个典型的例子就是权限管理系统：原始数据可能记录了每个用户在特定页面上的各项权限，例如“用户A在页面B上拥有读权限”、“用户A在页面B上拥有删除权限”等，每条权限占据一行。然而，最终呈现给用户的视图通常希望将同一用户和同一页面的所有权限合并到一行，并以“读”、“编辑”、“删除”等权限类型作为独立的列，用标记（如“X”）表示用户是否拥有该权限。

例如，原始数据结构可能如下：

我们期望的输出格式是：

直接在循环中通过复杂的条件判断来动态生成HTML表格，往往会导致代码逻辑混乱、状态难以管理，并且容易出现列错位等问题，尤其是在处理动态列时。因此，一种更健壮、更易维护的方法是进行数据预预处理。

立即学习“PHP免费学习笔记（深入）”；

核心策略：数据预处理与两阶段渲染

解决这类问题的最佳实践是将数据处理逻辑与视图渲染逻辑分离。我们采取“两阶段”策略：

1. 数据预处理阶段： 将原始的扁平化数据转换为一个更适合最终输出结构的多维数组。这个数组将以用户和页面为键，权限类型为值（布尔值表示是否存在）。
2. HTML渲染阶段： 遍历预处理后的数据结构，直接生成对应的HTML表格行和列。

这种方法使得渲染逻辑变得非常简单和直观，因为它不再需要处理复杂的条件判断和状态管理。

第一阶段：构建中间数据结构

在这一阶段，我们将原始的权限列表 $data 转换为一个嵌套的关联数组 $sorted。$sorted 的结构将是 用户 -> 页面 -> 权限类型 -> 布尔值。

假设我们的原始数据 $data 如下：

$data = [
    ['user' => 'Jon', 'page' => 'books', 'permission' => 'read'],
    ['user' => 'Jon', 'page' => 'books', 'permission' => 'delete'],
    ['user' => 'Jon', 'page' => 'photos', 'permission' => 'read'],
    ['user' => 'Jon', 'page' => 'photos', 'permission' => 'edit'],
    // 更多数据...
];

我们可以通过以下PHP代码来构建中间数据结构：

$sorted = array();
// 定义所有可能的权限类型，以便在初始化时设置
$allPermissions = ['read', 'edit', 'delete', 'create']; // 根据实际需求添加或动态获取

foreach ($data as $row) {
    $user = $row['user'];
    $page = $row['page'];
    $permission = $row['permission'];

    // 确保用户层级的数组已初始化
    if (!isset($sorted[$user])) {
        $sorted[$user] = array();
    }

    // 确保页面层级的数组已初始化，并为所有权限类型设置默认值（false）
    if (!isset($sorted[$user][$page])) {
        $initialPerms = array_fill_keys($allPermissions, false);
        $sorted[$user][$page] = $initialPerms;
    }

    // 将当前行的权限设置为 true
    // 确保权限类型存在于 $allPermissions 中，防止意外键值
    if (in_array($permission, $allPermissions)) {
        $sorted[$user][$page][$permission] = true;
    }
}

经过这个预处理步骤后，$sorted 数组的结构将大致如下：

发卡宝-卡密寄售系统

发卡宝是一个专业的软件卡密等虚拟商品在线交易平台,拥有多种兑换方式,费率低,结算快,正规企业平台一直稳定运营,24小时不间断提供自动发卡服务。【模板说明】试用版自带一套模板（响应式）【环境支持】PHP环境 / 200M或以上空间大小 / 开启父路径 / 设置index.php为默认首页 / 目录写入权限需要开启【数据库】MySQL【安装步骤】将文件上传至空间目录，运行“http://域名/inst

下载

$sorted = [
    'Jon' => [
        'books' => [
            'read'   => true,
            'edit'   => false,
            'delete' => true,
            'create' => false,
        ],
        'photos' => [
            'read'   => true,
            'edit'   => true,
            'delete' => false,
            'create' => false,
        ],
    ],
    // 其他用户...
];

这个结构清晰地表示了每个用户在每个页面上拥有的具体权限。

第二阶段：基于预处理数据生成HTML表格

有了 $sorted 这个理想的数据结构，生成HTML表格就变得非常简单。我们只需要嵌套循环遍历这个数组即可。

echo '';
echo '';
// 动态生成权限列标题
foreach ($allPermissions as $permHeader) {
    echo '';
}
echo '';
echo '';

foreach ($sorted as $user => $pages) {
    foreach ($pages as $pagename => $perms) {
        echo "";
        echo "";
        echo "";

        // 遍历所有权限类型，输出 'X' 或空
        foreach ($allPermissions as $permType) {
            echo "";
        }
        echo "";
    }
}

echo '';
echo '
User
Page
' . ucfirst($permHeader) . '
" . htmlspecialchars($user) . "
" . htmlspecialchars($pagename) . "
" . ($perms[$permType] ? "X" : "") . "
';

这段代码首先输出了表格的头部，包含了用户、页面以及所有权限类型的列名。然后，它通过两层循环遍历 $sorted 数组：外层循环处理每个用户，内层循环处理该用户下的每个页面。对于每个用户-页面组合，它会输出对应的用户和页面名称，接着遍历 $allPermissions 数组，根据 $perms 中对应权限的布尔值来输出“X”或空字符串，从而实现权限的标记。

完整示例

将上述两个阶段的代码整合，即可得到一个完整的解决方案：

 'Jon', 'page' => 'books', 'permission' => 'read'],
    ['user' => 'Jon', 'page' => 'books', 'permission' => 'delete'],
    ['user' => 'Jon', 'page' => 'photos', 'permission' => 'read'],
    ['user' => 'Jon', 'page' => 'photos', 'permission' => 'edit'],
    ['user' => 'Jane', 'page' => 'books', 'permission' => 'read'],
    ['user' => 'Jane', 'page' => 'books', 'permission' => 'edit'],
    ['user' => 'Jane', 'page' => 'photos', 'permission' => 'create'],
];

// 1. 数据预处理阶段
$sorted = array();
// 定义所有可能的权限类型，这决定了最终表格的列
$allPermissions = ['read', 'edit', 'delete', 'create'];

foreach ($data as $row) {
    $user = $row['user'];
    $page = $row['page'];
    $permission = $row['permission'];

    // 确保用户层级的数组已初始化
    if (!isset($sorted[$user])) {
        $sorted[$user] = array();
    }

    // 确保页面层级的数组已初始化，并为所有权限类型设置默认值（false）
    if (!isset($sorted[$user][$page])) {
        $initialPerms = array_fill_keys($allPermissions, false);
        $sorted[$user][$page] = $initialPerms;
    }

    // 将当前行的权限设置为 true
    // 仅当权限类型在 $allPermissions 中定义时才设置
    if (in_array($permission, $allPermissions)) {
        $sorted[$user][$page][$permission] = true;
    }
}

// 2. HTML渲染阶段
echo '';

echo '';
echo '';
// 动态生成权限列标题
foreach ($allPermissions as $permHeader) {
    echo ''; // 首字母大写作为标题
}
echo '';
echo '';

foreach ($sorted as $user => $pages) {
    foreach ($pages as $pagename => $perms) {
        echo "";
        echo "";
        echo "";

        // 遍历所有权限类型，输出 'X' 或空
        foreach ($allPermissions as $permType) {
            echo "";
        }
        echo "";
    }
}

echo '';
echo '
User
Page
' . ucfirst($permHeader) . '
" . htmlspecialchars($user) . "
" . htmlspecialchars($pagename) . "
" . ($perms[$permType] ? "X" : "") . "
';

?>

注意事项与最佳实践

1. 可扩展性：

   • 权限类型： 在示例中，$allPermissions 数组是手动定义的。在实际应用中，如果权限类型是动态的（例如从数据库中获取），可以在预处理之前先遍历一遍原始数据，收集所有不重复的权限类型来构建 $allPermissions。
   • 列的顺序： $allPermissions 数组的顺序决定了最终HTML表格中权限列的顺序。

2. 性能考量：

   • 对于非常大的数据集（例如数百万行），预处理阶段可能会消耗较多的内存来构建 $sorted 数组。在这种情况下，可能需要考虑使用数据库的透视（PIVOT）功能，或者分批处理数据。然而，对于大多数Web应用场景，这种内存消耗通常是可接受的。

3. 代码清晰度与可维护性：

   • 将数据处理和渲染分离，使得两部分逻辑都更加清晰。当需求变更时（例如增加新的权限类型或改变显示方式），修改起来也更加局部和容易。
   • 避免在HTML输出中嵌入复杂的PHP逻辑，提高了模板的可读性。

4. 安全性：

   • 在输出用户提供的数据（如用户名、页面名）到HTML时，始终使用 htmlspecialchars() 函数进行转义，以防止跨站脚本（XSS）攻击。示例代码中已包含此实践。

总结

通过数据预处理将原始的扁平化权限数据转换为结构化的多维数组，再结合简单的循环渲染HTML表格，是处理此类“数据透视”问题的优雅且高效的方法。这种方法不仅解决了直接渲染时可能遇到的复杂逻辑和错误，还大大提高了代码的可读性、可维护性和可扩展性，是PHP开发中值得推荐的实践。