Описание стандарта ExDK

<?php
// -------------------------------------------------------------------------------------------
// Модуль для реализации примера, выполняющего команды к серверу по протоколу DKCP-User
// Copyright by Delta Key ([email protected]), (c) 2007.
// -------------------------------------------------------------------------------------------

header('Content-Type: text/html; charset=windows-1251');

// настройки DKCP
define('SERVER_NAME', 'https://deltakey.net');
define('SERVER_CATALOG', '/dkcp');

define('DKCP_CERT', '/home/myserver/data/server_scripts/user.cer');
define('DKCP_PATH_CERT', '/home/myserver/data/server_scripts');
define('DKCP_CERT_PASSWORD', 'certpassword');  //password for certificate
define('DKCP_USER_LOGIN', 'mylogin');
define('DKCP_USER_PASSWORD', 'mypassword');

define('TEMP_DIR', '/home/myserver/data/tmp');
define('PROGRAM', '14001');

// -------------------------------------------------------------------------------------------
// _DateID - Возвращает уникальное 18-байтовое значение.
//           Внешний номер транзакции
//
// Возвращает :
//   Строку - уникальное значение

function _GetExtTransact()
{
    $tm = localtime(time(), 1);
    $r = rand(1111,9999);

    return sprintf( "%04d%02d%02d%02d%02d%02d%04d", $tm["tm_year"]+1900, $tm["tm_mon"]+1,
                  $tm["tm_mday"], $tm["tm_hour"], $tm["tm_min"], $tm["tm_sec"], $r
                  );
}

// -------------------------------------------------------------------------------------------
// Формирование строки запроса
// Добавление логина, пароля и номера трансакции
//
// Параметры :
//    $cmd - Название команды
//    $script - Исполняющий скрипт
//    $params  - Параметры запроса

function _CmdStr ($cmd, $script, $params) {

    $ext_transact = _GetExtTransact();

    $cabinet_ip = $_SERVER ['REMOTE_ADDR'];
    $cabinet_id = $_SESSION['idPHPSHOP'];
    $cabinet_login = $_SESSION['logPHPSHOP'];
    $cabinet_password = md5($_SESSION['pasPHPSHOP'].$ext_transact);

    $login = DKCP_USER_LOGIN;
    $password = md5(DKCP_USER_PASSWORD.$ext_transact);

    $URL = SERVER_NAME . SERVER_CATALOG . '/' . $script . "?cmd=$cmd&program=" . PROGRAM . 
            "&login=$login&password=$password&ext_transact=$ext_transact" . 
            "&cabinet_ip=$cabinet_ip&cabinet_id=$cabinet_id" . 
            "&cabinet_login=$cabinet_login&cabinet_password=$cabinet_password";

    if (is_array($params) ) {
        $keys = array_keys ($params);
        foreach ($params as $key => $value)
            $URL.= "&$key=".str_replace(' ', '+', $value);
    }
    return $URL;
 }

// -------------------------------------------------------------------------------------------
// _HttpsReq - реализация https-запроса к шлюзу Delta Key
//    Для внутреннего пользования функциями данного модуля
//
// Параметры :
//    $url  - Адрес скрипта
// Возвращает :
//    Результат вызова https-запроса (без заголовков) в виде XML

function _HttpsReq($url)
{
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_HEADER, 0);
    // CURLOPT_RETURNTRANSFER часто работает некорректно

    $tmp = tempnam (TEMP_DIR, "dk");
    $fp = fopen ($tmp, "w");
    curl_setopt ($ch, CURLOPT_FILE,              $fp);
    curl_setopt ($ch, CURLOPT_CAPATH,            DKCP_PATH_CERT);
    curl_setopt ($ch, CURLOPT_SSL_VERIFYPEER,    0);
    curl_setopt ($ch, CURLOPT_SSLCERT,           DKCP_CERT);
    curl_setopt ($ch, CURLOPT_SSLCERTPASSWD,     DKCP_CERT_PASSWORD);

    $res = curl_exec ($ch);
    
    if ($res) {
        // Запрос успешно выполнен. Возвращаем результат запроса
        curl_close($ch);
        fclose($fp);
        $fp = fopen ($tmp, "r");
        $result = "";
        while (!feof ($fp)) {
            $result.= fgets($fp, 4096);
        }
        
        fclose($fp);
        unlink($tmp);
        if (!$result) {
            $result = 'Сервер не вернул ответа';
            $res = False;
        }
        return array ($res, $result);
    } else {
        // Запрос выполнен с ошибкой. Возвращаем текст ошибки.
        return array (False, curl_error($ch));
    }
}

// -------------------------------------------------------------------------------------------
// _ParseRes - Преобразование результирующей XML в массив
//             Для внутреннего пользования функциями данного модуля
//
// Параметры :
//    $ResText - результат вызова функции _HttpsReq (XML ответа сервера)
// Возвращает : распарсированный массив
// Обязателен модуль MB

function _ParseRes($ResText)
{
    $parser = xml_parser_create();
    xml_parser_set_option($parser, XML_OPTION_CASE_FOLDING,0);
    xml_parser_set_option($parser, XML_OPTION_SKIP_WHITE,1);
    xml_parse_into_struct($parser, $ResText, $values, $tags);
    xml_parser_free($parser);
    
    $ind = 0;
    foreach ($tags as $key => $value) {
        if ($values[$value[0]]["level"]==2 and $values[$value[0]]["type"] == 'complete') {
            $res[$key] =  mb_convert_encoding (
                        $values[$value[0]]["value"], 'Windows-1251', 'UTF-8'
                        );
        }
        if ($key=='table') {
            $res["table"]["colcount"] = $values[$value[0]]["attributes"]["col"];
            $res["table"]["rowcount"] = $values[$value[0]]["attributes"]["row"];
        }
        
        // блок advanced
        if ($values[$value[0]]["level"] == 3 and $values[$value[0]]["type"] == 'complete') {
            $res["advanced"][$key] =  mb_convert_encoding (
                        $values[$value[0]]["value"], 'Windows-1251', 'UTF-8'
                        );
        }
        if ($values[$value[1]]["level"] == 3 and $values[$value[1]]["type"] == 'complete') {
            $res["advanced"][$key] =  mb_convert_encoding (
                        $values[$value[1]]["value"], 'Windows-1251', 'UTF-8'
                        );
        }
        
        // табличная часть
        if ($values[$value[0]]["level"] == 3 and $values[$value[0]]["type"] == 'open') {
            $keyname = $values[$value[0]]["tag"];
            
            $open = 1;
            $key2 = 0;
            while ($open) {
                $open = 0;
                foreach ($values as $key2 => $value2) {
                    if ($value2["tag"] == $keyname and $value2["type"] == 'open'
                                and $key2>$lastkey) {
                        $open = 1; $doit = 1;
                        $lastkey = $key2;
                        $ind++;
                    }
                    if ($value2["tag"] == $keyname and $value2["type"] == 'close') {
                        $doit=0;
                    }
                    if ($value2["level"] == 4 and $open and $doit) {
                        if ($keyname != 'colnames')
                            $res["table"][$keyname][$ind-2][$value2["tag"]] = 
                                    mb_convert_encoding (
                                                $value2["value"], 'Windows-1251', 'UTF-8'
                                    );
                        else
                            $res["table"][$keyname][$value2["tag"]] =     
                                    mb_convert_encoding (
                                                $value2["value"], 'Windows-1251', 'UTF-8'
                                                );
                    }
                }
            }
        }
    }
    return $res;
}

// -------------------------------------------------------------------------------------------
// DeltaCMD - Запрос к серверу
//            Для вызова из внешних модулей
//
// Параметры :
//    $cmd - название команды ( например, 'pay_momental' - моментальная оплата )
//    $script - путь к исплоняющему скрипту
//    $params - массив параметров команды ( сумма платежа, счет и пр. ) . Может быть пустым
// Возвращает :
//    Результат запроса (true / false)
//    Массив, содержащий ключи:
//        transact - номер транзакции
//        ext_transact - переданный при запросе номер внешней транзакции
//        date - дата завершения операции в формате YYYY-MM-DD hh:mm:ss
//        status - статус выполнения команды ( 2-операция завершена )
//        result - результат выполнения команды ( 0-успех, др. - код ошибки )
//        result_text - текстовая расшифровка результата
//        ТАБЛИЧНАЯ ЧАСТЬ, см. описание протокола DKCP

function DeltaCMD($cmd, $script, $params=array())
{
    $url = _CmdStr ($cmd, $script, $params);
    list($Result, $ResText) = _HttpsReq ($url);
    if (! $Result) {
        return array (False, 'CURL error: ' . $ResText);
    }
    $res = _ParseRes($ResText);
    return array (True, $res);
}
?>

<?php

// -------------------------------------------------------------------------------------------
// Пример скрипта, реализующего выполнение команды к серверу по протоколу DKCP-User
// Copyright by Delta Key ([email protected]), (c) 2007.
// -------------------------------------------------------------------------------------------

include('api.php');

function echo_result($res, $answer) {
    if (!$res) // запрос не выполнен
        die("<center><font color=red>$answer</font></center>");
    print '<h3>Запрос к серверу выполнен успешно. </h3>';
    if ($answer['result'] != 0) // Сервер вернул ошибку
        die("<center><font color=red>$answer[result_text]</font></center>");
    print '<h3>Сервер не возвращал ошибок. </h3>';

    // Выводим ответ в виде массива
    print '<h3>Ответ сервера:</h3><pre>';
    print_r($answer);
    print '</pre>';

    // Выводим ответ в виде таблицы
    print '<h3>Альтернативное представление ответа:</h3>';
    print "
    <i>Транзакция сервера:</i> $answer[transact]<br>
    <i>Внешняя транзакция:</i> $answer[ext_transact]<br>
    <i>Дата завершения обработки сервером:</i> $answer[date]<br>
    <i>Статус выполенения операции:</i> $answer[status]<br>
    <i>Текстовая расшифровка статуса:</i> $answer[status_text]<br>
    <i>Результат выполнения операции:</i> $answer[result]<br>
    <i>Текстовая расшифровка результата:</i> $answer[result_text]<br>
    <i>Дополнительное пояснение к ошибке:</i> $answer[result_error]<br>
    <i>Дополнительные данные:</i><br>";
    
    
    print "
    <TABLE class='advanced'><TR><th>Параметр</th><th>Значение</th></TR>
    ";
    foreach ($answer['advanced'] as $key => $value) {
        print "<TR><td><i>$key</i></td><td>$value</td></TR>";
    }
    print "</TABLE><br>";
    print "<i>Табличная часть:</i> ";
    
    if ($answer['table']['colcount'] == 0)
        print '<Отсутствует>';
    else {
        print "<br><TABLE><TR>";
        foreach ($answer['table']['colnames'] as $key => $value) {
            print "<th>$key / $value</th>";
        }
        print "</TR>";
        foreach ($answer['table']['colvalues'] as $row) {
            print "<TR>";
            foreach ($row as $td) {
                print "<td>$td</td>";
            }
            print "</TR>";
        }
        print "</TABLE><br>";
    }
}

// ...........................................................................................
// Пример 1. Запрос балансов всех своих счетов
// Показывает пример возврата табличной части

print "
<HTML><HEAD><link rel='stylesheet' type='text/css' href='test.css'>
<h1>Пример 1. Запрос балансов всех своих счетов</h1>
";
list($res, $answer)= DeltaCMD('getlist_keyt', 'keyt.py');
echo_result($res, $answer);

// ...........................................................................................
// Пример 2. Проверка существования UIN
// Показывает пример посылки дополнительных параметров

print "
<h1>Пример 2. Проверка существования UIN</h1>
";
$params['uin'] = '362527';
list($res, $answer)= DeltaCMD('check_uin', 'notfin_service.py', $params);
echo_result($res, $answer);

?>