PHP条件分支结构生成器

PHP Switch Case代码

<?php
declare(strict_types=1);

/**
 * 用户角色权限判定（switch-case 实现）
 *
 * 返回统一的授权决策结果数组，包含是否允许、权限列表、HTTP状态码和消息。
 * 注意：此函数仅做授权判定与结构化输出，不直接发送头信息或中止请求，便于在上层控制器中统一处理。
 */
function authorizeByRole(string $userRole): array
{
    // 标准化角色值（去空白、统一为小写）
    $role = strtolower(trim($userRole));

    if ($role === '') {
        // 输入为空属于无效参数，向上抛出以便调用方区分输入错误与授权失败
        throw new InvalidArgumentException('User role must not be empty.');
    }

    // 决策结果基础模板（默认拒绝 + 403）
    $decision = [
        'role'        => $role,
        'allowed'     => false,
        'permissions' => [],
        'http_status' => 403,
        'message'     => 'Access denied.',
    ];

    switch ($role) {
        case 'super_admin':
            // 系统管理员：全局管理与审计权限
            $decision['allowed']     = true;
            $decision['permissions'] = [
                // 管理与运维
                'manage_all',
                'user_manage',
                'user_delete',
                'config_manage',
                // 审计
                'audit_view',
                'audit_write',
                // 内容全权
                'content_create',
                'content_update',
                'content_publish',
                'content_unpublish',
                // 只读
                'view_public',
            ];
            $decision['http_status'] = 200;
            $decision['message']     = 'Granted: super_admin.';
            break;

        case 'admin':
            // 站点管理员：管理用户与配置，但无审计权限
            $decision['allowed']     = true;
            $decision['permissions'] = [
                'user_manage',
                'config_manage',
                'content_create',
                'content_update',
                'view_public',
                // 不包含：audit_*、content_publish/unpublish、user_delete
            ];
            $decision['http_status'] = 200;
            $decision['message']     = 'Granted: admin.';
            break;

        case 'editor':
            // 内容编辑：可新建与更新内容，不可发布，不可删除用户
            $decision['allowed']     = true;
            $decision['permissions'] = [
                'content_create',
                'content_update',
                'view_public',
            ];
            $decision['http_status'] = 200;
            $decision['message']     = 'Granted: editor.';
            break;

        case 'reviewer':
            // 内容审核：审批发布与下线内容
            $decision['allowed']     = true;
            $decision['permissions'] = [
                'content_approve',
                'content_publish',
                'content_unpublish',
                'view_public',
            ];
            $decision['http_status'] = 200;
            $decision['message']     = 'Granted: reviewer.';
            break;

        case 'viewer':
            // 只读访客：仅可查看公开页面
            $decision['allowed']     = true;
            $decision['permissions'] = [
                'view_public',
            ];
            $decision['http_status'] = 200;
            $decision['message']     = 'Granted: viewer.';
            break;

        case 'banned':
            // 封禁用户：拒绝所有访问并记录告警
            $decision['allowed']     = false;
            $decision['permissions'] = [];
            $decision['http_status'] = 403;
            $decision['message']     = 'Access denied: banned user.';
            // 记录安全告警（避免记录敏感信息）
            error_log('[SECURITY] Banned role attempted access.');
            break;

        default:
            // 未知角色：拒绝访问并记录警告（仅记录经过白名单字符过滤的角色片段）
            $decision['allowed']     = false;
            $decision['permissions'] = [];
            $decision['http_status'] = 403;
            $decision['message']     = 'Access denied: unknown role.';
            error_log('[WARN] Unknown role encountered: ' . preg_replace('/[^a-z0-9_\-]/i', '', $role));
            break;
    }

    return $decision;
}

/**
 * 可选：权限检查辅助函数
 */
function hasPermission(array $decision, string $permission): bool
{
    return $decision['allowed'] === true
        && in_array($permission, $decision['permissions'], true);
}

代码说明

• 变量用途：

  • userRole：表示当前用户的角色标识，用于进行权限判定与分支逻辑选择。

• 分支逻辑：

  • super_admin：拥有全局管理与审计权限，允许所有与管理和内容相关的操作。
  • admin：可管理用户与站点配置，允许创建/更新内容，但无审计权限，不授予发布/下线与删除用户的权限。
  • editor：可新建与更新内容，不可发布或删除用户。
  • reviewer：可审批发布与下线内容。
  • viewer：只读访客，仅可查看公开页面。
  • banned：拒绝所有访问，返回403并记录安全告警日志。
  • default：对于未知角色拒绝访问，返回403并记录警告日志（对角色字符串进行安全过滤后再写日志）。

• 注意事项：

  • 使用严格类型声明并对输入进行标准化（trim + strtolower），避免大小写或空白导致的错误匹配。
  • 默认拒绝策略（default分支）有助于在角色未覆盖或配置遗漏时保持安全。
  • 日志记录避免写入敏感信息，仅记录必要的安全事件。
  • 授权判定与输出、跳转等响应处理解耦：函数仅返回决策结果，上层控制器依据结果决定返回码与页面流转。
  • 权限字符串建议在项目中统一维护与约定，并在使用处通过 hasPermission 进行精确判断。

使用示例

<?php
declare(strict_types=1);

// 假设此值来自已认证用户的会话或令牌，不应直接信任前端传入
$userRole = 'Editor'; // 大小写不敏感，示例值

try {
    $decision = authorizeByRole($userRole);

    if ($decision['allowed'] !== true) {
        http_response_code($decision['http_status']);
        // 生产环境可替换为统一错误页渲染
        echo $decision['message'];
        exit;
    }

    // 示例：基于权限控制功能按钮/接口
    if (hasPermission($decision, 'user_manage')) {
        // 展示“用户管理”菜单或允许访问相关接口
    }

    if (hasPermission($decision, 'content_publish')) {
        // 允许发布/下线内容
    } else {
        // 隐藏发布按钮或禁止调用发布接口
    }

    // 调试输出（仅开发环境使用）
    // echo json_encode($decision, JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);

} catch (InvalidArgumentException $e) {
    http_response_code(400);
    echo 'Bad Request: ' . $e->getMessage();
    // 可按需记录日志：error_log($e->getMessage());
    exit;
}