Подключение класса phpagi к AGI интерфейсу Asterisk (FreePBX)

 Используя в работе голый Asterisk, рано или поздно становится недостаточно стандартных инструментов, для решения нужных задач. В этом случае нам поможет интерфейс AGI, который позволяет Asterisk взаимодействовать со сторонними приложениями, к примеру с приложением написанным на PHP.

 

Рассмотрим как настроить взаимодействие Asterisk с классом phpagi, посредством интерфейса AGI (Asterisk Gateway Interface).

Настройка Asterisk

Для подключения класса phpagi, в конфигурационный файл (/etc/asterisk/manager.conf), добавляем параметры подключения его (прим. astphp):

1 2 3 4 5 6 7 8 9 10 11 12 13

[general] enabled = yes port = 5038 bindaddr = 0.0.0.0 webenabled = no   [astphp] secret = password deny=0.0.0.0/0.0.0.0 permit=0.0.0.0/0.0.0.0 displayconnects = yes read = system,call,log,verbose,command,agent,user,originate write = system,call,log,verbose,command,agent,user,originate

Для безопасности в секции [general], в параметре bindaddr, можно задать IP-адрес с которого будет разрешено подключатся к интерфейсу AGI. В секции профиля подключения ([astphp]), можно так же указать разрешенные\запрещенные (deny\permit) адреса для подключения к профилю.

Настройка класса phpagi

ВАЖНО. В случае если выполняется настройка для FreePBX, то необходимости скачивать и копировать модули phpagi нет необходимости, т.к. они входят в поставку FreePBX. Переходим сразу к настройке соединения.

Скачиваем последнюю версию phpagi с официального сайта, распаковываем ее и выполняем настройку связи phpagi с Asterisk.

 

Копируем распакованные файлы phpagi в каталоги Asterisk:

1 2 3 4 5

cd phpagi-2.20 cp /docs/phpagi.example.conf /etc/asterisk/phpagi.conf cp phpagi-asmanager.php /var/lib/asterisk/api-bin/phpagi-asmanager.php cp phpagi-fastagi.php /var/lib/asterisk/api-bin/phpagi-fastagi.php cp phpagi.php /var/lib/asterisk/api-bin/phpagi.php

 

В файле конфигурации phpagi (/etc/asterisk/phpagi.conf), в секции ([asmanager]) указываем данные для соединения с Asterisk:

1 2 3 4 5

[asmanager] server=localhost port=5038 username=astphp secret=password

 

На этом конфигурация связи закончена. Теперь можно использовать PHP-скрипты в диалплане Asterisk.

Подключение класса phpagi в PHP-скрипт

Каждый PHP-скрипт должен начинаться со строк объявления использования класса phpagi:

1 2 3 4 5 6 7 8 9 10

#!/usr/bin/php -q <?php require('phpagi.php');   $agi = new AGI();   ... ...   ?>

ЗАМЕЧАНИЕ. PHP скрипты необходимо размещать в папку /var/lib/asterisk/agi-bin

 

Вызов PHP-скрипта из диалплана Asterisk (прим. с вызовом PHP-скрипта и передачи в него переменных из диалплана):

1	exten => _XXXX,1,AGI(myphpscrypt.php,${EXTEN},${CALLERID(num)})