函数名称:radius_put_attr()
适用版本:PHP 4 >= 4.0.5, PECL radius >= 1.1.0
函数描述:radius_put_attr() 函数用于将一个属性添加到 RADIUS 请求中。
用法: bool radius_put_attr ( resource $radius_handle , int $type , string $value [, int $vendor = 0 [, int $options = 0 ]] )
参数:
- radius_handle:一个有效的 RADIUS 连接句柄,通过 radius_auth_open() 或 radius_acct_open() 函数获取。
- type:属性类型,一个整数值。
- value:属性的值,一个字符串。
- vendor:可选参数,用于指定供应商的 ID。默认值为 0。
- options:可选参数,用于指定属性的选项。默认值为 0。
返回值: 如果成功添加属性,则返回 TRUE,否则返回 FALSE。
示例:
// 创建 RADIUS 连接句柄
$radius_handle = radius_auth_open();
// 连接到 RADIUS 服务器
radius_add_server($radius_handle, "radius-server", 1812, "radius-secret", 5, 3);
// 设置属性类型为 User-Name,值为 "john"
if (radius_put_attr($radius_handle, RADIUS_USER_NAME, "john")) {
echo "属性添加成功!";
} else {
echo "属性添加失败!";
}
// 关闭 RADIUS 连接
radius_close($radius_handle);
在上述示例中,我们首先使用 radius_auth_open() 函数创建了一个 RADIUS 连接句柄。然后,通过 radius_add_server() 函数将 RADIUS 服务器添加到连接句柄中。接下来,使用 radius_put_attr() 函数将一个 User-Name 属性添加到 RADIUS 请求中,值为 "john"。最后,通过 radius_close() 函数关闭 RADIUS 连接。如果属性添加成功,将输出 "属性添加成功!",否则输出 "属性添加失败!"。