한 프로젝트의 이야기 또는 Asterisk와 Php를 기반으로 PBX를 만드는 데 7년을 보낸 이야기

저처럼 뭔가 독특한 일을 하고 싶다는 생각을 갖고 있는 분들이 분명 많을 것입니다. 이 글에서는 PBX를 개발하면서 직면했던 기술적 문제와 해결 방법에 대해 설명하겠습니다. 아마도 이것은 누군가가 자신의 아이디어를 결정하고 누군가가 구타당한 길을 따르는 데 도움이 될 것입니다. 왜냐하면 나 또한 개척자의 경험으로부터 혜택을 받았기 때문입니다.

아이디어 및 주요 요구 사항

그리고 모든 것은 단순히 사랑으로 시작되었습니다. 별표 (통신 애플리케이션 구축을 위한 프레임워크), 전화 통신 및 설치 자동화 FreePBX (웹 인터페이스 별표). 회사의 요구사항이 구체적이지 않고 능력에 부합하는 경우 FreePBX - 모든것이 좋아. 전체 설치는 XNUMX시간 이내에 완료되었으며 회사는 구성된 PBX, 사용자 친화적인 인터페이스, 짧은 교육 및 원할 경우 지원을 받았습니다.

그러나 가장 흥미로운 작업은 비표준적이었고 그다지 훌륭하지도 않았습니다. 별표 많은 일을 할 수 있지만 웹 인터페이스를 제대로 작동하려면 몇 배 더 많은 시간을 소비해야 했습니다. 따라서 작은 세부 사항은 나머지 PBX를 설치하는 것보다 훨씬 더 오래 걸릴 수 있습니다. 그리고 요점은 웹 인터페이스를 작성하는 데 시간이 오래 걸린다는 것이 아니라 아키텍처 기능에 있습니다. FreePBX. 아키텍처 접근 방식 및 방법 FreePBX php4 당시에 배치되었고 그 당시 이미 모든 것을 더 간단하고 편리하게 만들 수 있는 php5.6이 있었습니다.

마지막 빨대는 다이어그램 형태의 그래픽 번호 계획이었습니다. 내가 이런 것을 만들려고했을 때 FreePBX, 나는 그것을 크게 다시 작성해야하고 새로운 것을 만드는 것이 더 쉬울 것이라는 것을 깨달았습니다.

주요 요구 사항은 다음과 같습니다.

• 간단한 설정으로 초보 관리자도 직관적으로 접근할 수 있습니다. 따라서 기업에서는 당사측에 PBX 유지관리를 요구하지 않으며,
• 작업이 적절한 시간 내에 해결되도록 쉽게 수정할 수 있습니다.
• PBX와의 통합 용이성. 유 FreePBX 설정 변경을 위한 API가 없었습니다. 예를 들어, 타사 애플리케이션에서는 그룹이나 음성 메뉴를 생성할 수 없으며 API 자체에서만 생성할 수 있습니다. 별표,
• 오픈 소스 - 프로그래머의 경우 이는 클라이언트 수정에 매우 중요합니다.

더 빠른 개발 아이디어는 모든 기능을 객체 형태의 모듈로 구성하는 것이었습니다. 모든 객체에는 공통 상위 클래스가 있어야 합니다. 즉, 모든 주요 기능의 이름이 이미 알려져 있으므로 기본 구현이 이미 있다는 의미입니다. 객체를 사용하면 문자열 키가 있는 연관 배열 형태로 인수 수를 크게 줄일 수 있습니다. FreePBX 전체 함수와 중첩된 함수를 살펴보았기 때문에 가능했습니다. 개체의 경우 진부한 자동 완성 기능은 모든 속성을 표시하며 일반적으로 수명을 여러 번 단순화합니다. 또한 상속과 재정의는 이미 수정과 관련된 많은 문제를 해결합니다.

재작업 시간을 늦추고 피할 가치가 있는 다음 것은 중복이었습니다. 직원에게 전화 걸기를 담당하는 모듈이 있는 경우 직원에게 전화를 보내는 데 필요한 다른 모든 모듈은 이를 사용해야 하며 자체 복사본을 생성해서는 안 됩니다. 따라서 무언가를 변경해야 하는 경우 한 곳에서만 변경해야 하며 "작동 방식"에 대한 검색은 전체 프로젝트에서 검색하는 것이 아니라 한 곳에서 수행해야 합니다.

첫 번째 버전 및 첫 번째 오류

첫 번째 프로토타입은 XNUMX년 안에 준비되었습니다. 계획대로 전체 PBX는 모듈식이었고 모듈은 통화 처리를 위한 새로운 기능을 추가할 수 있을 뿐만 아니라 웹 인터페이스 자체도 변경할 수 있었습니다.

예, 그러한 계획의 형태로 번호 계획을 구축한다는 아이디어는 내 것이 아니지만 매우 편리하고 나도 똑같이했습니다. 별표.

모듈을 작성함으로써 프로그래머는 이미 다음을 수행할 수 있습니다.

• 다이어그램과 왼쪽 요소 메뉴에 배치할 수 있는 통화 처리를 위한 고유한 기능을 생성합니다.
• 웹 인터페이스를 위한 자신만의 페이지를 만들고 기존 페이지에 템플릿을 추가합니다(페이지 개발자가 이를 제공한 경우).
• 기본 설정 탭에 설정을 추가하거나 자신만의 설정 탭을 만드세요.
• 프로그래머는 기존 모듈을 상속하고 기능의 일부를 변경하여 새 이름으로 등록하거나 원래 모듈을 교체할 수 있습니다.

예를 들어, 다음과 같은 방법으로 자신만의 음성 메뉴를 만들 수 있습니다.

......
class CPBX_MYIVR extends CPBX_IVR
{
 function __construct()
 {
 parent::__construct();
 $this->_module = "myivr";
 }
}
.....
$myIvrModule = new CPBX_MYIVR();
CPBXEngine::getInstance()->registerModule($myIvrModule,__DIR__); //Зарегистрировать новый модуль
CPBXEngine::getInstance()->registerModuleExtension($myIvrModule,'ivr',__DIR__); //Подменить существующий модуль

첫 번째 복잡한 구현은 첫 번째 자부심과 첫 번째 실망을 가져왔습니다. 효과가 있었고 이미 주요 기능을 재현할 수 있어서 기뻤습니다. FreePBX. 사람들이 이 계획의 아이디어를 좋아해서 기뻤습니다. 개발을 단순화할 수 있는 옵션은 여전히 ​​많았지만 당시에도 일부 작업은 이미 더 쉬워졌습니다.

PBX 구성 변경을 위한 API는 실망스러웠습니다. 결과는 우리가 원하는 것과 전혀 달랐습니다. 나는 에서와 같은 원칙을 취했다. FreePBX, 적용 버튼을 클릭하면 전체 구성이 다시 생성되고 모듈이 다시 시작됩니다.

다음과 같이 보입니다.

*다이얼플랜은 통화를 처리하는 규칙(알고리즘)입니다.

하지만 이 옵션을 사용하면 PBX 설정을 변경하기 위한 일반 API를 작성하는 것이 불가능합니다. 먼저 변경 사항을 적용하는 작업입니다. 별표 너무 길고 리소스 집약적입니다.
둘째, 두 함수를 동시에 호출할 수 없습니다. 둘 다 구성을 생성합니다.
셋째, 관리자가 지정한 설정을 포함한 모든 설정이 적용됩니다.

이 버전에서는 다음과 같이 아스코지아, 변경된 모듈만 구성을 생성하고 필요한 모듈만 다시 시작하는 것이 가능했지만 이는 모두 절반 수준입니다. 접근방식을 바꾸는 것이 필요했습니다.

두 번째 버전. 코가 뽑혀서 꼬리가 붙어 있음

문제를 해결하기 위한 아이디어는 구성 및 번호 계획을 다시 만드는 것이 아닙니다. 별표, 그러나 정보를 데이터베이스에 저장하고 호출을 처리하는 동안 데이터베이스에서 직접 읽습니다. 별표 나는 데이터베이스에서 구성을 읽는 방법을 이미 알고 있었습니다. 데이터베이스의 값을 변경하기만 하면 변경 사항을 고려하여 다음 호출이 처리되며 이 기능은 번호 계획 매개 변수를 읽는 데 완벽했습니다. REALTIME_HASH.

결국 다시 시작할 필요도 없었습니다. 별표 설정을 변경하면 모든 설정이 즉시 적용되기 시작했습니다. 별표.

다이얼 플랜에 대한 유일한 변경 사항은 내선 번호와 힌트. 그러나 이것은 작은 부분의 변화였습니다.

exten=>101,1,GoSub(‘sub-callusers’,s,1(1)); - точечное изменение, добавляется/изменяется через ami

; sub-callusers – универсальная функция генерится при установке модуля.
[sub-callusers]
exten =>s,1,Noop()
exten =>s,n,Set(LOCAL(TOUSERID)=${ARG1})
exten =>s,n,ClearHash(TOUSERPARAM)
exten =>s,n,Set(HASH(TOUSERPARAM)=${REALTIME_HASH(rl_users,id,${LOCAL(TOUSERID)})})
exten =>s,n,GotoIf($["${HASH(TOUSERPARAM,id)}"=""]?return)
...

다음을 사용하여 번호 계획에서 라인을 쉽게 추가하거나 변경할 수 있습니다. 아미 (제어 인터페이스 별표) 전체 다이얼플랜을 재부팅할 필요가 없습니다.

이로써 구성 API의 문제가 해결되었습니다. 데이터베이스에 직접 가서 새 그룹을 추가하거나 그룹의 "전화 접속 시간" 필드에 전화 접속 시간을 변경할 수도 있으며 다음 통화는 이미 지정된 시간 동안 지속됩니다. 일부 API 작업에는 작업이 필요하므로 작업 아미 전화).

첫 번째 어려운 구현은 다시 첫 번째 자부심과 실망을 가져왔습니다. 효과가 있어서 기뻤습니다. 데이터베이스가 중요한 링크가 되었고 디스크에 대한 의존도가 높아졌으며 위험도 더 커졌지만 모든 것이 문제 없이 안정적으로 작동했습니다. 그리고 가장 중요한 것은 이제 웹 인터페이스를 통해 수행할 수 있는 모든 작업을 API를 통해 수행할 수 있으며 동일한 방법이 사용되었다는 것입니다. 또한 웹 인터페이스에서는 관리자가 자주 잊어버린 "PBX에 설정 적용" 버튼이 제거되었습니다.

실망스러운 점은 개발이 더욱 복잡해졌다는 것입니다. 첫 번째 버전부터 PHP 언어는 언어로 번호 계획을 생성했습니다. 별표 완전히 읽을 수 없는 것처럼 보이고 언어 자체도 별표 번호 계획을 작성하는 것은 매우 원시적입니다.

그 모습은 다음과 같습니다.

$usersInitSection = $dialplan->createExtSection('usersinit-sub','s');
$usersInitSection
 ->add('',new Dialplanext_gotoif('$["${G_USERINIT}"="1"]','exit'))
 ->add('',new Dialplanext_set('G_USERINIT','1'))
 ->add('',new Dialplanext_gosub('1','s','sub-AddOnAnswerSub','usersconnected-sub'))
 ->add('',new Dialplanext_gosub('1','s','sub-AddOnPredoDialSub','usersinitondial-sub'))
 ->add('',new Dialplanext_set('LOCAL(TECH)','${CUT(CHANNEL(name),/,1)}'))
 ->add('',new Dialplanext_gotoif('$["${LOCAL(TECH)}"="SIP"]','sipdev'))
 ->add('',new Dialplanext_gotoif('$["${LOCAL(TECH)}"="PJSIP"]','pjsipdev'))

두 번째 버전에서는 번호 계획이 보편화되었으며 매개변수에 따라 가능한 모든 처리 옵션이 포함되었으며 크기가 크게 늘어났습니다. 이 모든 것이 개발 시간을 크게 지연시켰고, 다시 한 번 번호 계획을 방해해야 한다는 생각 자체가 나를 슬프게 했습니다.

세 번째 버전

문제를 해결하기 위한 아이디어는 생성하는 것이 아니었습니다. 별표 PHP에서 다이얼 플랜을 사용하고 사용 FastAGI PHP 자체에서 모든 처리 규칙을 작성합니다. FastAGI 그것은 수 있습니다 별표, 호출을 처리하려면 소켓에 연결하세요. 거기에서 명령을 받고 결과를 보냅니다. 따라서 번호 계획의 논리는 이미 경계를 벗어났습니다. 별표 어떤 언어로든 작성할 수 있습니다. 제 경우에는 PHP로 작성했습니다.

많은 시행착오가 있었습니다. 가장 큰 문제는 이미 많은 클래스/파일이 있다는 것입니다. 객체를 생성하고 초기화하고 서로 등록하는 데 약 1,5초가 소요되었으며 호출당 지연은 무시할 수 없는 수준입니다.

초기화는 한 번만 발생해야 하므로 솔루션 검색은 다음을 사용하여 PHP로 서비스를 작성하는 것으로 시작되었습니다. Pthread. 일주일 간의 실험 후에 이 확장 기능의 작동 방식이 복잡하기 때문에 이 옵션은 보류되었습니다. 한 달 간의 테스트 후에 저는 PHP의 비동기 프로그래밍도 포기해야 했습니다. PHP 초보자에게 간단하고 친숙한 것이 필요했으며 많은 PHP 확장은 동기식입니다.

해결책은 다음과 같이 컴파일된 C의 자체 멀티스레드 서비스였습니다. PHPLIB. 모든 ATS PHP 파일을 로드하고, 모든 모듈이 초기화될 때까지 기다리고, 서로 콜백을 추가하고, 모든 것이 준비되면 캐시합니다. 문의하실 때 FastAGI 스트림이 생성되고 모든 클래스와 데이터의 캐시 사본이 여기에 재생산되며 요청이 php 함수로 전달됩니다.

이 솔루션을 사용하면 서비스 호출을 보낸 후 첫 번째 명령까지 걸리는 시간이 별표 1,5초에서 0,05초로 줄어들었고 이 시간은 프로젝트 규모에 따라 조금씩 달라집니다.

그 결과 다이얼플랜 개발 시간이 대폭 줄어들었고, 모든 모듈의 다이얼플랜 전체를 PHP로 다시 작성해야 했기 때문에 감사할 따름입니다. 첫째, 데이터베이스에서 객체를 얻기 위해 메소드가 이미 PHP로 작성되어 있어야 하며 웹 인터페이스에 표시하는 데 필요했고 두 번째로 이것이 가장 중요하며 마침내 숫자와 배열이 포함된 문자열로 편리하게 작업할 수 있게 되었습니다. 데이터베이스와 많은 PHP 확장 기능이 포함되어 있습니다.

모듈 클래스에서 번호 계획을 처리하려면 다음 기능을 구현해야 합니다. 다이얼플랜동적통화 그리고 논쟁 pbxCall요청 상호작용할 개체를 포함합니다. 별표.

또한, 다이얼플랜 디버깅이 가능해졌습니다(php에는 xdebug가 있고 우리 서비스에 작동합니다). 변수 값을 보면서 단계별로 이동할 수 있습니다.

통화 데이터

모든 분석과 보고서에는 정확하게 수집된 데이터가 필요하며, 이 PBX 블록 역시 첫 번째 버전부터 세 번째 버전까지 많은 시행착오를 거쳤습니다. 통화 데이터가 신호인 경우가 많습니다. 한 번의 통화 = 한 번의 녹음: 누가 전화했는지, 누가 응답했는지, 통화 시간. 더 흥미로운 옵션에는 통화 중에 어떤 PBX 직원이 전화를 받았는지 나타내는 추가 표시가 있습니다. 그러나 이 모든 것은 요구 사항의 일부만을 다루고 있습니다.

초기 요구 사항은 다음과 같습니다.

• PBX에서 전화한 사람뿐만 아니라 응답한 사람도 저장하세요. 가로채기가 있으므로 통화를 분석할 때 이를 고려해야 합니다.
• 직원과 연결되기 전의 시간. ~ 안에 FreePBX 일부 다른 PBX의 경우 PBX가 전화를 받는 즉시 전화에 응답한 것으로 간주됩니다. 하지만 음성 메뉴의 경우 이미 전화를 받아야 하므로 모든 전화에 응답하고 응답 대기 시간은 0~1초가 됩니다. 따라서 응답 전 시간뿐만 아니라 주요 모듈(모듈 자체에서 이 플래그를 설정합니다. 현재는 "직원", "외부 회선")과 연결되기 전의 시간을 절약하기로 결정했습니다.
• 더 복잡한 번호 계획의 경우 호출이 서로 다른 그룹 간에 이동할 때 각 요소를 별도로 검사할 수 있어야 했습니다.

가장 좋은 옵션은 PBX 모듈이 통화 시 자신에 대한 정보를 보내고 궁극적으로 정보를 트리 형식으로 저장하는 것으로 나타났습니다.

다음과 같습니다.

첫째, 통화에 대한 일반 정보입니다(다른 모든 사람과 마찬가지로 특별한 내용은 없음).

1. 외부선으로 전화가 왔습니다."반죽의 경우"05:55:52에 89295671458에서 89999999999까지, 결국 직원이 답변했습니다."비서2» 번호 104. 내담자는 60초를 기다렸다가 36초 동안 말했습니다.
2. 직원 "비서2"112에 전화하니 직원이 받네요"관리자1» 8초 후. 그들은 14초 동안 이야기합니다.
3. 클라이언트는 직원에게 "관리자1" 그들은 13초 동안 계속해서 이야기를 나눴습니다.

그러나 이것은 빙산의 일각이며 각 기록에 대해 PBX를 통해 자세한 통화 내역을 얻을 수 있습니다.

모든 정보는 호출의 중첩으로 표시됩니다.

1. 외부선으로 전화가 왔습니다."반죽의 경우» 05:55:52에 숫자 89295671458에서 숫자 89999999999로 변경됩니다.
2. 05:55:53에 외부 회선이 수신 회로에 호출을 보냅니다."test»
3. 구성표에 따라 통화를 처리할 때 모듈은 “매니저 전화", 통화 시간은 16초입니다. 클라이언트를 위해 개발된 모듈입니다.
4. 모듈 "매니저 전화" 해당 번호를 담당하는 직원(고객)에게 전화를 보냅니다. "관리자1”라고 말하고 5초 동안 응답을 기다립니다. 매니저는 대답하지 않았다.
5. 모듈 "매니저 전화"그룹에 전화를 보냅니다."CORP 관리자" 이들은 같은 방향(같은 방에 앉아)의 다른 매니저들로, 11초 동안 응답을 기다리고 있다.
6. 그룹 "CORP 관리자"직원에게 전화해요"관리자1, 관리자2, 관리자3"동시에 11초 동안. 대답이 없습니다.
7. 관리자의 통화가 종료됩니다. 그리고 회로는 모듈에 호출을 보냅니다."1c에서 경로 선택" 또한 클라이언트를 위해 작성된 모듈입니다. 여기서 통화는 0초 동안 처리되었습니다.
8. 회로는 음성 메뉴 "에 호출을 보냅니다.추가 다이얼링이 포함된 기본" 클라이언트는 31초 동안 그곳에서 기다렸고 추가 전화 걸기는 없었습니다.
9. 이 구성표는 그룹 "에 전화를 보냅니다.비서", 클라이언트는 12초 동안 기다렸습니다.
10. 그룹에서는 직원 2명이 동시에 호출됩니다."비서1"그리고"비서2" 그리고 12초 후에 직원이 대답합니다. "비서2" 통화에 대한 응답은 학부모 통화에 복제됩니다. 그 그룹에서 그는 “비서2", 회선에 전화를 걸 때 "비서2"라고 말하고 외부선으로 걸려온 전화에 "비서2".

간단히 보고서를 작성할 수 있게 해주는 것은 각 작업 및 중첩에 대한 정보를 저장하는 것입니다. 음성 메뉴에 대한 보고서는 그것이 얼마나 도움이 되는지 방해가 되는지 알아내는 데 도움이 될 것입니다. 직원이 놓친 전화에 대한 보고서를 작성합니다. 통화가 차단되었으므로 부재중으로 간주되지 않는다는 점, 그룹 통화였고 다른 사람이 더 일찍 응답했다는 점, 즉 통화도 놓친 상태가 아니라는 점을 고려합니다.

이러한 정보 저장을 통해 각 그룹을 개별적으로 가져와 얼마나 효과적으로 작동하는지 판단하고 시간별로 응답한 그룹과 놓친 그룹의 그래프를 작성할 수 있습니다. 또한, 관리자 연결 후 이체 내역을 분석하여 담당 관리자와의 연결이 얼마나 정확한지 확인할 수도 있습니다.

예를 들어, 데이터베이스에 없는 번호가 올바른 내선 번호로 전화를 거는 빈도나 발신 전화의 몇 퍼센트가 휴대폰으로 전달되는지 등 매우 이례적인 연구를 수행할 수도 있습니다.

결과는 어떻습니까?

PBX를 유지 관리하는 데 전문가가 필요하지 않으며 가장 일반적인 관리자가 수행할 수 있습니다. 실제로 테스트를 거쳤습니다.

수정에는 심각한 자격을 갖춘 전문가가 필요하지 않으며 PHP에 대한 지식이면 충분합니다. SIP 프로토콜, 대기열, 직원 호출 및 기타 모듈을 위한 모듈이 이미 작성되었습니다. 래퍼 클래스가 있습니다. 별표. 모듈을 개발하기 위해 프로그래머는 미리 만들어진 모듈을 호출할 수 있습니다(그리고 좋은 방법으로 호출해야 합니다). 그리고 지식 별표 클라이언트가 새로운 보고서가 포함된 페이지를 추가하도록 요청하는 경우 전혀 필요하지 않습니다. 그러나 실습에 따르면 제XNUMX자 프로그래머는 대처할 수 있지만 문서화 및 일반적인 댓글 적용이 없으면 불안감을 느끼므로 여전히 개선의 여지가 있습니다.

모듈은 다음을 수행할 수 있습니다.

• 새로운 통화 처리 기능을 생성하고,
• 웹 인터페이스에 새 블록을 추가하고,
• 기존 모듈 중 하나를 상속하거나, 기능을 재정의하고 교체하거나, 단순히 약간 수정된 복사본이 되십시오.
• 다른 모듈 등의 설정 템플릿에 설정을 추가하세요.

API를 통한 PBX 설정. 위에서 설명한 것처럼 모든 설정은 데이터베이스에 저장되어 호출 시 읽어오기 때문에 API를 통해 모든 PBX 설정을 변경할 수 있습니다. API를 호출하면 구성이 다시 생성되지 않고 모듈이 다시 시작되지 않으므로 설정 수와 직원 수는 중요하지 않습니다. API 요청은 빠르게 실행되며 서로를 차단하지 않습니다.

PBX는 통화 시간(대기/대화), 중첩 및 PBX 용어(채널, 번호가 아닌 직원, 그룹, 외부 회선)로 모든 주요 작업을 저장합니다. 이를 통해 특정 클라이언트에 대한 다양한 보고서를 작성할 수 있으며 대부분의 작업은 사용자 친화적인 인터페이스를 만드는 것입니다.

다음에 무슨 일이 일어날지는 시간이 말해 줄 것입니다. 아직 수정해야 할 뉘앙스가 많고 계획도 많지만 세 번째 버전을 만든 지 3년이 지났고 이미 아이디어가 효과가 있다고 말할 수 있습니다. 버전 3의 가장 큰 단점은 하드웨어 리소스이지만, 일반적으로 개발 용이성을 위해 비용을 지불해야 합니다.

출처 : habr.com