通过一个完整的非流式文本内容安全检测示例，你可以在 PHP 项目中完成 SDK 初始化、构造检测请求并解析返回结果（判定与理由）。

场景介绍

• 业务目标：检测一段文本是否合规，并返回判定结果与理由，用于阻断不合规内容。
• 输入：带上下文的文本消息（如用户提示词或模型响应），可包含多条历史消息。
• 输出：结构化结果，包含 MsgID（消息标识）、Decision.DecisionType（决策类型）、以及Risks.Category命中的检测分类。

注意事项

• 资产与场景绑定：仅支持通过 SDK 方式接入的资产 AppID；其他接入方式的资产在 SDK 调用中不生效。
• 地域与服务地址一致性：region 与 myUrl 中的 {region} 必须一致，域名形如 https://{region}.sdk.access.llm-shield.omini-shield.com。
• 权限：子账号至少需具备 AccessKeySelfManageAccess 与 LLMShieldProtectSdkAccess。其他控制台操作等权限说明请参见使用大模型应用防火墙服务需要具备哪些权限？

关键参数说明

参考以下表格了解 SDK 中的关键参数说明及获取方法。

实现流程

1. 安装 SDK：下载并安装 PHP SDK，详情可参见安装 SDK。
2. 初始化：通过环境变量或占位符提供 myUrl、ak、sk、appid、region，构造 LLMShieldApi 客户端。详情可参见初始化。
3. 构造检测请求（ModerateV2Request）：设置 Message（单条待检内容）：包含 Role、Content、ContentType（示例为 TEXT）。

示例代码

<?php

// 引入 vendor 自动加载文件（用于 GuzzleHttp 等依赖）
require __DIR__ . "/vendor/autoload.php";

use Volcengine\LLMShield\Api\LLMShieldApi;
use Volcengine\LLMShield\Model;

// 配置信息。
$myUrl = "https://cn-beijing.sdk.access.llm-shield.omini-shield.com"; // 访问地址，根据大模型应用防火墙实例所在地域替换相应的地域信息 
$ak = "YOUR AK"; // 火山账号的 AK 
$sk = "YOUR SK"; // 火山账号的 SK 
$appid = "app-d2pgblcjslsilv******"; // 资产的 AppId，可在控制台资产管理页面获取 
$region = "cn-beijing"; // 大模型应用防火墙实例所在地域 
$timeout = 60; // 超时时间（秒） 
$service = "llmshield"; // 大模型应用防火墙的服务名称 

$client = new LLMShieldApi($myUrl, $ak, $sk, $appid, $region, $timeout, $service);

$request = new Model\ModerateV2Request();
$request->Scene = $appid;

// 设置检测内容
$request->Message = new Model\MessageV2();
$request->Message->Role = "user"; // 检测的内容来源，user-用户提示词；assistant-模型响应内容
$request->Message->Content = "网上都说A地很多骗子和小偷，他们的典型伎俩..."; // 检测的文本内容详情
$request->Message->ContentType = Model\ContentTypeV2::TEXT; // 检测的内容类型， TEXT-文本；IMAGE-图片

// 设置上下文
$request->History = [];
$request->History[] = new Model\MessageV2();
$request->History[0]->Role = "system"; // 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
$request->History[0]->Content = "你是一个专业的问答助手，你的任务是回答用户的问题，注意保持友善和专业。";
$request->History[0]->ContentType = Model\ContentTypeV2::TEXT;

// 设置上下文
$request->History[] = new Model\MessageV2();
$request->History[1]->Role = "user"; // 上下文内容来源，user-用户提示词；assistant-模型响应内容；system-系统默认提示词
$request->History[1]->Content = "请给我一份十一出行计划";
$request->History[1]->ContentType = Model\ContentTypeV2::TEXT;

$client->Moderate($request)->then(function ($resp) {
    echo json_encode($resp[0], JSON_UNESCAPED_UNICODE) . "\n";
    echo $resp[1] . "\n";
    echo json_encode($resp[2], JSON_UNESCAPED_UNICODE) . "\n";
})->wait();

运行结果

运行代码，得到以下调用结果：

• 消息 ID : 19cd001d5f59452ea5f240c0bcca****
• 风险信息 :
  • 一级风险类别 101：模型滥用
  • 二级风险类别 10112000：歧视
  • 二级风险类别 10103005：谩骂
• 决策类型 : 2（拦截），表示对应被拦截，你可以根据规则 ID 查看对应防护详情。
• 命中策略 ID：rule-d44mri1i7k3ipsss****

{
    "MsgID": "19cd001d5f59452ea5f240c0bcca****",
    "RiskInfo": {
        "Risks": [
            {
                "Category": "101",
                "Label": "10112000",
                "Prob": 1
            },
            {
                "Category": "101",
                "Label": "10103005"
            }
        ]
    },
    "Decision": {
        "DecisionType": 2,
        "DecisionDetail": {
            "BlockDetail": [

            ],
            "ReplaceDetail": {
                "Replacement": null
            }
        },
        "HitStrategyIDs": [
            "rule-d44mri1i7k3ipsss****"
        ]
    },
    "PermitInfo": {
        "Permits": null
    },
    "Degraded": false,
    "DegradeReason": ""
}

参考信息

• 非流式文本内容检测的接口详细说明，可参见检测输入或输出内容是否合规。
• 其他调用示例，可参见PHP 使用示例。