MBSLib
[ class tree: MBSLib ] [ index: MBSLib ] [ all elements ]

Class: MBSBase

Source Location: /lib/MBSBase.class.php

Class Overview


MBSBase - tėvinė klasė, Debug, Error ir SOAP apdorojimas. Paveldi visos klasės.


Author(s):

Variables

Methods


Child classes:

SBBS
Vartotojų valdymo Vero SBBS(MBS) prenumeratų sistemoje
Bank
WEB apmokėjimų klasė
Direct
Direct apmokėjimų klasė
MBS
WAP apmokėjimų klasė
Identify
Identifikavimo klasė skirta WAP vartotojo identifikavimui MBS sistemoje
MBSNotifyBase
Klasė skirta priimti sistema-sistema tipo pranešimus apie kažkurią iš MBS paslaugų.

Class Details

[line 133]
MBSBase - tėvinė klasė, Debug, Error ir SOAP apdorojimas. Paveldi visos klasės.



Tags:

author:  Liutauras Rickus <lr@vero.lt>
see:  SBBSNotify
see:  SBBS
see:  MBS
see:  Identify


[ Top ]


Class Variables

$back_url =  ''

[line 142]

Saugomas URL, kur bus gražinamas vartotojas po Wap apmokestinimo, po prenumeratos Registracijos.



Tags:

access:  protected

Type:   string


[ Top ]

$debug_buffer =  ''

[line 197]

Laikoma Debug informacija



Tags:

access:  protected

Type:   string


[ Top ]

$debug_level =  DEBUG_LEVEL_NORMAL

[line 175]

Pranešimų kaupimo lygis. Lygis pagal nutylėjimą DEBUG_LEVEL_NORMAL

Galimos reikšmės:




Tags:

access:  protected

Type:   int


[ Top ]

$debug_type =  DEBUG_TYPE_BUFFER

[line 188]

Debug informacijos išvedimo tipas. Pagal nutylėjimą DEBUG_TYPE_OUTPUT

Galimos reikšmės:




Tags:

access:  protected

Type:   int


[ Top ]

$error =  ''

[line 160]

Klaidos pranešimas



Tags:

access:  protected

Type:   string


[ Top ]

$secret_key =  ''

[line 151]

Saugomas slaptas žodis, kuris bus naudojamas saugumo parašui



Tags:

access:  protected

Type:   string


[ Top ]

$soap_type =  null

[line 210]

Naudojame SOAP klasė

Galimos reikšmės:




Tags:

var:  NuSOAP|SOAP
access:  protected

Type:   string


[ Top ]

$soap_url =  ''

[line 219]

SOAP užklausų kreipinių adresas



Tags:

var:  URL
access:  protected

Type:   string


[ Top ]

$suffix =  '_class_data'

[line 229]

Sesijos saugomo parametro priešdėlis.

Pvz.: Identify identifikuoto vartotojo duomenis saugo sesijos kintamajame „identify_$suffix“.




Tags:

access:  protected

Type:   string


[ Top ]

$use_session =  true

[line 237]

Ar saugoti reikiamus duomenis sesijoje



Tags:

access:  protected

Type:   boolean


[ Top ]



Class Methods


constructor MBSBase [line 244]

MBSBase MBSBase( )

Konstruktorius, neatliekantis jokiu konkrečių veiksmų



[ Top ]

method debug [line 288]

void debug( string $msg, int $need_level)

Kaupiame debug informaciją $msg jeigu klasės savybės $debug_level yra mažesnis arba lygus $need_level.

Jeigu $this->debug_type nustatytas kaip DEBUG_TYPE_OUTPUT, debug informacija vedama į ekrana, kitu atveju į buferį.




Tags:



Parameters:

string   $msg   Žinutės tekstas
int   $need_level   Žinutės debug lygis

[ Top ]

method formatUrl [line 566]

string formatUrl( string $url, array $url_params, [boolean $url_encode = true])

Grąžina "suklijuotus" URL parametrus



Tags:

return:  URL eilute su pridetais parametrais
access:  public


Parameters:

string   $url   URL prie kurio lipdysime parametrus
array   $url_params   URL parametru masyvas
boolean   $url_encode   (optional) Flag if URL encoding should be performed

[ Top ]

method getDebug [line 320]

string getDebug( )

Gražinama sukaupta debug informacija.



[ Top ]

method getError [line 339]

string getError( )

Grąžinami klaidų pranešimai



[ Top ]

method getStatusDescription [line 720]

string getStatusDescription( string $state)

Pagal tranzakcijos state reikšmę grąžiną state aprašymą.

Tranzakcijų state galimos reikšmės:

  • open – Sukurta tranzakcija. Laukiami tolimesni veiksmai.
  • ac_unknown – MBS sistemi nepavyko identifikuoti vartotojo
  • ac_ready – vartotojas identifikuotas ir paruoštas apmokestinimui
  • ac_block – vartotojas negali būti apmokestinamas
  • ac_limit – vartotojas pasiekė mėnesio limitą ir negali būti apmokestinamas.
  • ac_cancel – vartotojas atsisakė mokėti. Paspaudė mygtuką „Ne“ arba „Atgal“
  • ac_done – vartotojas sutiko būti apmokestinamas pradedamas apmokestinimo procesas
  • op_wait – apmokestinimas pradėtas laukiame apmokestinimo rezultato iš operatoriaus. Omnitel, LMT operatorių atvejais.
  • cancel_config – neteisingai sukonfigūruota paslauga.
  • cancel – atšauktas dėl MBS vidinių problemų
  • op_cancel – operatorius atšaukė apmokestinimą (ši būsena suteikiamas visosm vidinėms klaidosm)
  • op_cancel_connect – nepavyko prisijungti prie operatoriaus
  • op_cancel_data – neteisingai pateikiami parametrai operatoriaus sistemai
  • op_cancel_config – klaida parametruose
  • op_cancel_param – neįmanoma apmokestinti už nurodytą kainą ar valiutą
  • op_cancel_unavail – nepasiekiama operatoriaus sistema
  • op_timeout – įvyko timeout į operatoriaus sistemą
  • op_ac_blocked – operatorius nebeleidžia apmokestinti vartotojo
  • op_ac_limit – vartotojas pasiekė mėnesio limitą operatoriaus sistemoje
  • op_done – sėkmingai įvykęs apmokestinimas
  • rollback – apmokestinimas atšauktas vartotojui pinigai grąžinti. Šį veiksmą inicijuoja partnerio sistema.
  • commit – pilnai pabaigtas apmokestinimas. Vartotojas sėkmingai apmokestintas ir tranzakcija nebekeičiama.




Tags:

return:  Tranzakcijos būsenos aprašymas


Parameters:

string   $state   Tranzakcijos būsena

[ Top ]

method initSoap [line 253]

void initSoap( string $url)

Nustatoma naudojama SOAP klasė ir SOAP adresui priskiriama paduota reikšmė $url



Tags:



Parameters:

string   $url   URL

[ Top ]

method isError [line 348]

boolean isError( )

Gražinama ar įvyko klaida



[ Top ]

method prepareParams [line 410]

array prepareParams( $options, array $url_params)

Paruošia URL parametrus. Jeigu $this->back_url nustatytas, tuomet visi šie parametrais sudedami į $this->back_url

Taip pat nuorodoje galima naudoti žymenis:

  • %t arba %{transaction_id}% - Tranzakcijos identifikatorius
  • %s arba %{service_id}% - Paslaugos identifikatorius
  • %c arba %{channel_id}% - Kanalo identifikatorius
  • %o arba %{operator_id}% - Operatoriaus identifikatorius
  • %n arba %{operator_name}% - Operatoriaus pavadinimas (pvz.. bite_lt, tele2_lv, t.t.)
Pavyzdys: Jeigu $this->back_url nustatom http://example.lt?trans=%t&s=%s&service=%{service_id}%&a=test , o tranzakcijos ID yra 2456 ir paslaugos ( Service ) ID yra 1 Vartotojas bus gražintas į URL : http://example.lt?trans=2456&s=1&service=1&a=test




Tags:

return:  Parametrai ( masyvas ) kurį reikia naudoti kuriant tranzakciją
see:  MBSBase::setBackUrl()


Parameters:

array   $url_params   URL parametrai kuriuos norite perduoti
   $options  

[ Top ]

method setBackUrl [line 535]

void setBackUrl( string $url)

Nustatomas gražinimo url. Jis gali būti bet koks. Jeigu yra galimybė iš Vero(MBS) platformos bus bandom nukreipti vartotoją į šią nuorodą. Nuorodoje galima naudoti parametrus, gražinant vartotoją į nuorodą bus pakeisti reikšmėmis.

Galimi parametrai:

  • %t arba %{transaction_id}% - pakeistas į naudojamos transakcijos ID
  • %s or %{service_id}% - pakeistas į naudojamos paslaugos(service) ID
  • %c or %{channel_id}%- pakeistas į naudojamo kanalo (channel) ID
  • %o or %{operator_id}%- pakeistas į vartotojo operatoriaus (operator) ID
  • %a or %{account_id}%- pakeistas į vartotojo identifikatorių (account) ID
  • %n or %{operator_name} - pakeistas į vartotojo operatoriaus pavadinimą (pvz.: bite_lt, tele2_lv, ect.)
Didžiosios mažosios raidės neturi reikšmės.




Parameters:

string   $url   URL

[ Top ]

method setDebug [line 308]

void setDebug( int $level, [int $type = DEBUG_TYPE_BUFFER])

Nustatomas debug kaupimo lygis į $level ir kaupimo tipas į $type.



Tags:



Parameters:

int   $level  
int   $type  

[ Top ]

method setError [line 329]

void setError( string $msg)

Nustatomas klaidos pranešimas su debug lygiu DEBUG_LEVEL_LOW



Parameters:

string   $msg  

[ Top ]

method setSecretKey [line 547]

void setSecretKey( string $secret_key)

Nustatomas slaptas žodis, kuris bus naudojamas saugumo parašui



Parameters:

string   $secret_key   Slapto žodžio reikšmė

[ Top ]

method setSessionUse [line 516]

void setSessionUse( [boolean $isUse = true])

Nustatoma ar saugoti duomenis sesijoje



Parameters:

boolean   $isUse  

[ Top ]

method signArrayLow [line 590]

array signArrayLow( array $params)

Pasirašo pateiktus parametrus žemo patikimumo parašu



Tags:

return:  Pasirašytas masyvas


Parameters:

array   $params   Masyvas su parametrais

[ Top ]

method signUrlLow [line 602]

string signUrlLow( string $url)

Pasirašo pateiktą URL žemo patikimumo parašu



Tags:

return:  Pasirašytas URL


Parameters:

string   $url   URL, kurį reikia pasirašyti

[ Top ]

method verifyArrayHigh [line 641]

boolean verifyArrayHigh( array $params)

Patikrina ar parametrai teisingai pasirašyti aukštu patikimumu



Tags:

return:  Ar masyvas pasirašytas teisingai


Parameters:

array   $params   Masyvas su parametrais

[ Top ]

method verifyArrayLow [line 627]

boolean verifyArrayLow( array $params)

Patikrina ar parametrai teisingai pasirašyti žemu patikimumu



Tags:

return:  Ar masyvas pasirašytas teisingai


Parameters:

array   $params   Masyvas su parametrais

[ Top ]

method verifyUrlHigh [line 680]

boolean verifyUrlHigh( string $url)

Patikrina ar URL turi teisingą aukšto patikimumo parašą



Tags:

return:  Ar URL pasirašytas teisingai


Parameters:

string   $url   URL, kurį reikia tikrinti

[ Top ]

method verifyUrlLow [line 664]

boolean verifyUrlLow( string $url)

Patikrina ar URL turi teisingą žemo patikimumo parašą



Tags:

return:  Ar URL pasirašytas teisingai


Parameters:

string   $url   URL, kurį reikia tikrinti

[ Top ]

method _CallNuSOAP [line 484]

array|boolean _CallNuSOAP( string $function, array $soap_params)

SOAP metodo kvietimas naudojantis NuSOAP biblioteka



Tags:

return:  Sėkmės atvėju gražinamas array, nesėkmės false
link:  http://sourceforge.net/projects/nusoap/
access:  protected


Parameters:

string   $function   Soap metodo pavadinimas
array   $soap_params   Metodo parametrai pagal struktura (parameter_name => parameter_value)

[ Top ]

method _CallSOAP [line 455]

array|boolean _CallSOAP( string $function, array $soap_params)

SOAP metodo kvietimas naudojantis PHP SOAP moduliu.



Tags:

return:  Sėkmės atvėju gražinamas array, nesėkmės false
link:  http://www.php.net/soap
access:  protected


Parameters:

string   $function   Soap metodo pavadinimas
array   $soap_params   Metodo parametrai pagal struktura (parameter_name => parameter_value)

[ Top ]

method _prepareParams [line 380]

array _prepareParams( array $params)

Paruošiami parametrai pagal "JArray" tipą (naudojamas soap metoduose), kiekvienam masyvo $params elementui

Jeigu $params atrodo:

  1.  $params array(
  2.     'key1'=>'value1',
  3.     'key2'=>'value2',
  4.  );
Tai metods grazins:
  1.  array(
  2.   array(
  3.     'name'=>'key1',
  4.     'value'=>'value1',
  5.   ),
  6.   array(
  7.     'name'=>'key2',
  8.     'value'=>'value2',
  9.   )
  10.  )




Tags:

access:  protected


Parameters:

array   $params  

[ Top ]

method _SOAPCall [line 435]

array|boolean _SOAPCall( string $function, array $soap_params)

SOAP metodo kvietimas. Naudojantis nustatyta soap klasė



Tags:

return:  Sėkmingo kvietimo atveju gražinamas array, nesėkmės atvėju false
see:  MBSBase::$soap_type
access:  protected


Parameters:

string   $function   Soap metodo pavadinimas
array   $soap_params   Metodo parametrai pagal struktura (parameter_name => parameter_value)

[ Top ]


Documentation generated on Fri, 05 Nov 2010 11:25:44 +0200 by phpDocumentor 1.4.3