Quelltext der Seite AGI Vorlage zum starten

Im Prinzip kann das Script überall im Dateisystem liegen. Der Standardplatz ist jedoch unter /var/lib/asterisk/agi-bin. Liegt ein Script nicht in diesem Pfad, muss es beim Aufruf mit dem absoluten Pfad angegeben werden.

Nachdem das Script angelegt worden ist, muss es mit "'''chmod 0755 dateiname'''" ausführbar gemacht werden.

Es ist zu beachten, dass AGIs unter Umständen die Performance des System beeinträchtigen können!

<pre>
#!/usr/bin/php4 -q
<?php

/*
 some zphone specific includes
 */

// main config file
//include_once("/var/www/zphone/etc/config.inc.php");

// main file for doing any sql lookups
//include($CCBOX["INC"]."func_sql.inc.php");

// some other zAPI files
//include($CCBOX["INC"]."func_voip.inc.php");


$in = fopen("php://stdin", "r" );
$err = fopen("php://stderr", "r" );


/*

 asterisk pass some values via stdin to the agi
 script. format is key: vale
 just get the values and extact them into an
 array named $agivars with key value index

*/

$agivars = array();
while (!feof($in)) {
    $agivar = trim(fgets($in));

    if ($agivar === '')
        break;

    $agivar = explode(':', $agivar);
    $agivars[$agivar[0]] = trim($agivar[1]);
}


/*
 this is needed if executing via DeadAGI dialplan app
 */
pcntl_signal(SIGHUP, SIG_IGN);

/*
 hier kommt der code hin, den man verwenden will
 wenn man die richtigen includes im kopf definiert,
 stehen einem alle zphone internen funktionen zur
 verfuegung


 paste here your code you want to use
 if you include the needed/right files in the
 header of this file, you are able to user all
 of the internal zphone functions form the zAPI
 */

/*

print("noop just an info...\n");
print("set varialble Z_AGI_TEST hallo\n");
$_tmp = fread($in, 1024);

*/

fclose($in);
fclose($err);
return 0;


?>

</pre>

=TIPPS=
wenn man z.b. ein "set variable" in einem AGI Script macht, so muss die Ausgabe von Asterisk zurückgelesen werden. Sonst gibt es einen häßlichen 
 ERROR[11599] utils.c: fwrite() returned error: Broken pipe
Fehler auf der CLI und in Logs

=DEBUGING=

Dass ein Script ( PHP, PERL, Shell, etc ) auf der Konsole läuft, bedeutet nicht, dass dieser auch innerhalb der Asterisk Umgebung sauber funktioniert. Sollte es der Fall sein, dann kann man mir 
 agi set debug on
das Debugging aktivieren. Mit 
 agi set debug off
kann dieses wieder deaktiviert werden.