phpami

Asterisk Manager Interface (AMI) for PHP 5.4+ supporting legacy v1.4 to v13 with no thrills.

This is a fork and update of the AMI portion of the now defunc PHPAGI PHP 4.4 project which has not been updated since 2010.

We have kept the simplicity of a single class with command methods, adding a packagist entry and namespaces. This is a breaking change as class and method names have changed to follow modern standards, however they are a 1:1 mapping so updating your code should be straight forward.

If you are dealing with only Asterisk v13+ servers, consider using PAMI instead, which uses modern design paterns with observer-listener pattern. It no longer supports legacy Asterisk versions like v1.4 however. It may also see less development than the NAMI library for NodeJS.

Installing via Composer

The recommended way to install PHPAMI is through Composer.

# Install Composer
curl -sS https://getcomposer.org/installer | php

Next, run the Composer command to install the latest stable version:

composer.phar require ofbeaton/phpami

After installing, you can now use it in your code:

   $ami = new \PHPAMI\Ami();
   if ($ami->connect('localhost:5038', 'myuser', 'mysecret', 'off') === false) {
      throw new \RuntimeException('Could not connect to Asterisk Management Interface.');
   }
   
   // $result contains the output from the command
   $result = $ami->command('core show channels');
   
   $ami->disconnect();

Support Me

Hi, I'm Finlay Beaton (@ofbeaton). This software is made possible by donations of fellow users like you, encouraging me to toil the midnight hours away and sweat into the code and documentation.

Everyone's time should be valuable, please consider donating.

Donate through Paypal

License

This software is distributed under the LGPL 2.1 License. Please see License file for more information.

This library is a fork of the now defunc PHPAGI project by Matthew Asham. See Fork release for more details.