php agi 中文 api,php AGI 学习

AGI(Asterisk 网关接口)，也就是说 Asterisk 是支持各种扩展的应用网关。

AGI 脚本通过通信通道与Asterisk 通信，而不是通过API 方式来编程：

AGI 脚本通过STDIN 从Asterisk 获取信息。

AGI 脚本通过STDOUT 把输出信息写到Asterisk 中。

AGI 脚本可以通过STDERR 把调试信息送到Asterisk 控制台。

当一个AGI 脚本启动时，Asterisk 向AGI 脚本传送一系列变量及变量值，通过 fgets(STDIN,4096) 来获取

在 Dialplan 中这样调用 AGI 脚本 ：

exten => 123,2,AGI(agi-test.agi)   agi-test.agi 为 AGI 脚本，一般放在/var/lib/asterisk/agi-bin

用 PHP 来写AGI脚本(参照未来之路)

if(!defined('STDIN')){

define('STDIN', fopen('php://stdin', 'r'));

}

if(!defined('STDOUT')){

define('STDOUT', fopen('php://stdout', 'w'));

}

if(!defined('STDERR')){

define('STDERR', fopen('php://stderr', 'w'));

}

//这段代码确保我们有打开的STDIN、STDOUT 和STDERR 文件句柄，

//这些句柄会处理Asterisk 和我们的脚本之间的所有通信。

while (!feof(STDIN)){

$temp = trim(fgets(STDIN,4096));

if (($temp == "") || ($temp == "\n")){

break;

}

$s = split(":",$temp);

$name = str_replace("agi_","",$s[0]);

$agi[$name] = trim($s[1]);

}

//接下来我们会读取Asterisk 传来的所有变量，

//在PHP 中用fgets 命令可以从STDIN 读取数据，

//我们会把每一个变量存入名为$agi 的哈希变量中。

?> 现在我用的是 Asterisk-1.6 版本，测试好像不行！

在网上看了下，有个 phpagi 的类，使用的是 socket 来与 Asterisk 通信：

fwrite($socket, "Action: login\r\nUserName: $username\r\nSecret: $secret\r\n\r\n");

while($c = fgets($socket, 4096))

{

echo $c ."\n";

}

fwrite($socket, "Action: Command\r\nCommand: database show SIP/Registry/801\r\n\r\n");

while($c = fgets($socket, 4096))

{

echo $c ."\n";

} 输出内容为：

使用这种方法还得配置些东西，在 /etc/asterisk/manager.conf中设置相关的服务器信息：

[mark]                   ----连接时用到的 用户名

secret = phpami      ----密码

read = system,call,log,verbose,command,agent,user

write = system,call,log,verbose,command,agent,user

read 和 write 就是 AMI 所能用到的指令

记得要重启 Asterisk 。 其实后一种用的是 AMI (Asterisk manager API), 和 AGI 有很大区别的

Asterisk控制接口(Asterisk manager API)允许管理客户端程序连接到一个asterisk实例，并且可以通过TCP/IP(AMI通过TCP/IP协议连接到Asterisk 服务器的端口默认为5038)流发送命令或读取事件。相对于AGI ，AMI并没有将控制交给您的应用程序，但允许您查询和随时更改其状态。

AMI提供给用户的指令集合如下： system       -- 系统的一般信息。允许执行执行系统管理命令，如Shutdown, Restart, and Reload. call           -- 通道的信息。允许用户设置当前通道的一些信息. log            -- 日志信息(Read-only) verbose      -- 详细信息(Read-only.即指asterisk控制台上的信息) agent         -- agents和queues的信息。允许增加一个队列member到队列中. user           -- 允许用户发送和收取UserEvent. config         -- 允许用户读取和写配置文件. command    -- 允许发送可执行的控制台命令(Write-only.) dtmf           -- 接收DTMF事件,Read-only. reporting     -- 允许用户取得系统信息. cdr             -- cdr_manager的输出信息(if loaded. Read-only.) dialplan       -- 接收NewExten and VarSet events(Read-only.) originate      -- 允许产生一个新的call(Write-only.) 在asterisk控制台执行 manager show commands命令，即可查看AMI提供给用户的所有指令。 其中，Privilege即command所属的指令集合，当Privilege为None时，是指这些指令允许任何用户使用。