本文为您介绍大模型应用防火墙 PHP SDK 的下载地址、安装方式以及初始化配置。

前提条件

• 你已获取账号的AccessKey、SecretKey（即 AK、SK），具体步骤，请参见获取AccessKey、SecretKey。
• 你已在大模型应用防火墙控制台完成资产接入并为资产配置相关防护策略，策略配置详情请参见防护策略介绍。

环境要求

• PHP 5.5 及以上版本。
• Composer 包管理器（建议使用 2.x）。

安装 SDK

以下介绍通过 Composer 安装大模型应用防火墙 PHP SDK 的操作方法。

1. 创建你的 PHP 项目。

2. 执行以下命令下载 PHP SDK 源码。

   git clone https://github.com/volcengine/volcengine-php-sdk
   

3. 执行以下命令安装apache/thrift依赖。

   composer require apache/thrift
   

4. 执行以下命令安装 PHP SDK。

   composer install
   

初始化

下面提供两种最小可运行的初始化方式，你可以任选其一：

方式一：直接传入 AK/SK

在创建 LLMShieldApi 客户端时，直接以构造参数传入 myUrl、ak、sk、appid、region、timeout、service。

<?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);

方式二：使用环境变量

将 myUrl、ak、sk、appid、region 写入运行环境变量，通过 getenv() 在代码中读取后构造客户端。

<?php

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

use Volcengine\LLMShield\Api\LLMShieldApi;

// 使用变量文件为参数赋值
$myUrl = getenv("myUrl");  // 访问地址 
$ak = getenv("ak"); // 火山账号的 AK 
$sk = getenv("sk"); // 火山账号的 SK 
$appid = getenv("appid"); // 资产的 AppId
$region = getenv("region"); // 大模型应用防火墙实例所在地域 
$timeout = 60; // 超时时间（秒） 
$service = "llmshield"; // 服务名称 

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