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

Class: Identify

Source Location: /lib/Identify.class.php

Class Overview

MBSBase
   |
   --Identify

Identifikavimo klasė skirta WAP vartotojo identifikavimui MBS sistemoje


Author(s):

Variables

Methods


Inherited Variables

Inherited Methods

Class: MBSBase

MBSBase::MBSBase()
Konstruktorius, neatliekantis jokiu konkrečių veiksmų
MBSBase::debug()
Kaupiame debug informaciją $msg jeigu klasės savybės $debug_level yra mažesnis arba lygus $need_level.
MBSBase::formatUrl()
Grąžina "suklijuotus" URL parametrus
MBSBase::getDebug()
Gražinama sukaupta debug informacija.
MBSBase::getError()
Grąžinami klaidų pranešimai
MBSBase::getStatusDescription()
Pagal tranzakcijos state reikšmę grąžiną state aprašymą.
MBSBase::initSoap()
Nustatoma naudojama SOAP klasė ir SOAP adresui priskiriama paduota reikšmė $url
MBSBase::isError()
Gražinama ar įvyko klaida
MBSBase::prepareParams()
Paruošia URL parametrus. Jeigu $this->back_url nustatytas, tuomet visi šie parametrais sudedami į $this->back_url
MBSBase::setBackUrl()
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.
MBSBase::setDebug()
Nustatomas debug kaupimo lygis į $level ir kaupimo tipas į $type.
MBSBase::setError()
Nustatomas klaidos pranešimas su debug lygiu DEBUG_LEVEL_LOW
MBSBase::setSecretKey()
Nustatomas slaptas žodis, kuris bus naudojamas saugumo parašui
MBSBase::setSessionUse()
Nustatoma ar saugoti duomenis sesijoje
MBSBase::signArrayLow()
Pasirašo pateiktus parametrus žemo patikimumo parašu
MBSBase::signUrlLow()
Pasirašo pateiktą URL žemo patikimumo parašu
MBSBase::verifyArrayHigh()
Patikrina ar parametrai teisingai pasirašyti aukštu patikimumu
MBSBase::verifyArrayLow()
Patikrina ar parametrai teisingai pasirašyti žemu patikimumu
MBSBase::verifyUrlHigh()
Patikrina ar URL turi teisingą aukšto patikimumo parašą
MBSBase::verifyUrlLow()
Patikrina ar URL turi teisingą žemo patikimumo parašą
MBSBase::_CallNuSOAP()
SOAP metodo kvietimas naudojantis NuSOAP biblioteka
MBSBase::_CallSOAP()
SOAP metodo kvietimas naudojantis PHP SOAP moduliu.
MBSBase::_prepareParams()
Paruošiami parametrai pagal "JArray" tipą (naudojamas soap metoduose), kiekvienam masyvo $params elementui
MBSBase::_SOAPCall()
SOAP metodo kvietimas. Naudojantis nustatyta soap klasė

Class Details

[line 24]
Identifikavimo klasė skirta WAP vartotojo identifikavimui MBS sistemoje

Naudojimo pavyzdys:

  1. <?php
  2. /**
  3.  * Raw identify example
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_identify.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Šarūnas Davalga <sd@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12.  
  13. // Inicijuojame MBS identifikavimo biblioteką
  14. define('IDENTIFY_SERVICE_ID'1);
  15. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  16. define('IDENTIFY_SECRET_KEY''test');
  17. $identify new Identify(IDENTIFY_SERVICE_IDIDENTIFY_SECRET_KEYtrue'http://mbs.vero.lt/simple/wap_identify.php');
  18.  
  19. // Patikrinam ar gryžo vartotojas po identifikavimo
  20. if (!$identify->isIdentified()) {
  21.     // vartotojas bus nukreiptas i MBS identifikavimui
  22.     $identify_url $identify->MakeIdentify(session_id());
  23. else {
  24.     // Ar pavyko identifikuoti vartotoją ir nėra klaidų
  25.     if $identify->getAccount(!= && !$identify->isError()) {
  26.         session_id($identify->getTransaction());
  27.         echo '<pre>';
  28.         print_r($identify->getUserInfo());
  29.         echo '</pre>';
  30.     else {
  31.         // Įvykus klaidai išvedama klaida
  32.         echo $identify->getError();
  33.         // Paruošiamas vartotojas pakartotiniam identifikavimui
  34.         $identify->unsetUserData();
  35.     }
  36. }
  37.  
  38. ?>
  1. <?php
  2. /**
  3.  * Raw WAP registration example (using redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_register.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Valdas Petrulis <vpe@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame MBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. define('SBBS_SECRET_KEY''test');
  23.  
  24. // Identifikuojame vartotoją
  25. if (!$identify->isIdentified()) {
  26.     $identify->MakeIdentify(session_id()array());
  27. }
  28.  
  29. // Registracijos inicijavimas
  30. if (!isset($_GET['after_register'])){
  31.     // Registruojame, tik jei vartotojas dar nera registruotas
  32.     if (!$identify->getSubscriberStatus()!='active'{
  33.         // Čia vartotojas bus nukreipiamas į MBS registruotis
  34.         $sbbs->registerRedirect(array(
  35.             'session_id' => session_id(),
  36.             'after_register' => 'yes',
  37.         )time());
  38.     // Jau registruotas vartotojas
  39.     else {
  40.         echo "Vartotojas jau buvote registruotas";
  41.     }
  42. // Registracijos pabaiga ir GET rasti teisingi duomenys
  43. else if ($transaction=$sbbs->getRegisterInformation()) {
  44.     // Registracija sėkminga
  45.     if ($transaction['subscriber_status']=='active' {
  46.         echo 'Vartotojas sėkmingai užregistruotas';
  47.     // Registracija nepavyko
  48.     else {
  49.         echo 'Vartotojo užregistruoti nepavyko';
  50.     }
  51. // Registracijos pabaiga, bet GET duomenys neteisingi
  52. else {
  53.     echo "Registracijos klaida: ".$sbbs->getError();
  54. }
  55.  
  56. ?>
  1. <?php
  2. /**
  3.  * Raw WAP registration example (using SOAP service and redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_register_soap.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Šarūnas Davalga <sd@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame SBBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. $sbbs new SBBS(SBBS_MBS_SERVICE_IDnullSBBS_BACK_URL);
  23.  
  24. // Identifikuojame vartotoją
  25. if (!$identify->isIdentified()) {
  26.     $identify->MakeIdentify(session_id()array());
  27. }
  28.  
  29. // Registracijos inicijavimas
  30. if (!isset($_GET['after_register'])) {
  31.     // Registruojame, tik jei vartotojas dar nera registruotas
  32.     if (!$sbbs->isActive($identify->getAccount())) {
  33.         $sbbs->register(array(
  34.             'session_id' => session_id(),
  35.             'after_register' => 'yes',
  36.             't' => '%t'// čia MBS įrašys tranzakcijos ID
  37.             's' => '%s'// čia MBS įrašys paslaugos ID
  38.             'op' => '%n'// čia MBS įrašys operatoriaus ID
  39.             'a' => '%a'// čia MBS įrašys vartotojo ID
  40.         ));
  41.     // Jau registruotas vartotojas
  42.     else {
  43.         echo "Vartotojas jau buvote registruotas";
  44.     }
  45. // Registracijos pabaiga 
  46. else {
  47.     // Registracija sėkminga
  48.     if ($sbbs->isActive($identify->getAccount())) {
  49.         echo 'Vartotojas sėkmingai užregistruotas';
  50.         print_r($sbbs->GetInfo($identify->getAccount()));
  51.     // Registracija nepavyko
  52.     else {
  53.         echo 'Vartotojo užregistruoti nepavyko';
  54.     }
  55. }
  56.  
  57. ?>
  1. <?php
  2. /**
  3.  * Raw WAP unregistration example (using SOAP service and redirect)
  4.  * 
  5.  * @see MBSLib/examples/simple/wap_unregister_soap.php
  6.  *
  7.  * @package RawExamples
  8.  * @author Šarūnas Davalga <sd@vero.lt>
  9.  */
  10.  
  11. include_once(dirname(__FILE__).'/../../lib/Identify.class.php');
  12. include_once(dirname(__FILE__).'/../../lib/SBBS.class.php');
  13.  
  14. // Inicijuojame MBS identifikavimo biblioteką
  15. define('IDENTIFY_SERVICE_ID'1);
  16. define('IDENTIFY_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  17. define('IDENTIFY_SECRET_KEY''test');
  18.  
  19. // Inicijuojame SBBS apmokėjimų biblioteką
  20. define('SBBS_MBS_SERVICE_ID'2);
  21. define('SBBS_BACK_URL''http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF']);
  22. $sbbs new SBBS(SBBS_MBS_SERVICE_IDnullSBBS_BACK_URL);
  23.  
  24. // Išregistravimo inicijavimas
  25. if (!isset($_GET['after_unregister'])) {
  26.     $sbbs->unregister(array(
  27.         'after_unregister' => 'yes',
  28.     ));
  29. // Išregistravimo pabaiga
  30. else {
  31.     // Išregistravimas sėkmingas
  32.     if ($sbbs->isActive($identify->getAccount())) {
  33.         echo 'Vartotojas išregistruotas';
  34.         print_r($sbbs->GetInfo($identify->getAccount()));
  35.     // Išregistravimas nepavyko
  36.     else {
  37.         echo 'Vartotojo išregistruoti nepavyko';
  38.     }
  39. }
  40.  
  41. ?>




Tags:

author:  Liutauras Rickus <lr@vero.lt>


[ Top ]


Class Variables

$service_id =  0

[line 43]

Identifikavimo paslaugos identifikatorius



Tags:

access:  protected

Type:   int


[ Top ]

$user_info = array()

[line 52]

Vartotojo informacija



Tags:

access:  protected

Type:   array


[ Top ]



Class Methods


constructor Identify [line 78]

Identify Identify( int $service_id, string $secret_key, [boolean[optional] $use_session = true], [string[optional] $back_url = ''])

Identifikavimo klases konstruktorius

Konstruktoriui paduodami parametrai paslaugos identifikatorius $service_id ir paslaugos slaptas raktas $secret_key. Parametras $use_session skirtas nurodyti ar Identifikuoto vartotojo duomenis saugoti sesijoje.

Nustatoma ar vartotojo grąžintas iš MBS po identifikavimo. Jei taip, vartotojo duomenys užkraunami.

Jeigu nustatytas savybė use_session po vartotojo nustatymo duomenis patalpinami į sesiją. Vartotojo duomenis atstatomi iš sesijos, jei nėra persiustas iš MBS.

Parametras $back_url nurodo, kur bus nukreiptas vartotojas po identifikavimo. Šį parametrą galima nustatyti konstruktoriuje arba metodo setBackUrl pagalba.




Tags:



Parameters:

int   $service_id   Identifikavimo paslaugos ID
string   $secret_key   Identifikavimo paslaugos slaptas raktas
boolean[optional]   $use_session   Ar turi buti naudojama sessija vartotojo duomenims saugoti
string[optional]   $back_url   URL į kurį tūrėtų būti gražintas vartotojas

[ Top ]

method getAccount [line 440]

int getAccount( )

Gražinamas vartotojo identifikatorius MBS sistemoje (account_id). Jei gražinama reikšmė 0 vadinasi vartotojo nepavyko identifikuoti.



Tags:

return:  Jei vartotojas identifikuotas gražina > 0, jei neidentifikuotas 0


[ Top ]

method getAccountCountry [line 579]

string getAccountCountry( )

Gražina vartotoja kalbą ISO 3166-1 alpha-2 standartu

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getAccountIdent [line 477]

string getAccountIdent( )

Gražinama vartotojo operatoriaus identifikatorius. Dažniausia tai būna vartotojo telefono numeris.

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getAccountInfo [line 430]

array getAccountInfo( )

Gražinamas masyvas identifikuoto vartotojo duomenų.

Gražinamo masyvo struktūra:

  1.  array(
  2.   'accountID' => <Varotojo identifikatorius MBS sistemoje>
  3.   'operatorName' => <Vartotojo operatoriaus pavadinimas>
  4.   'operatorID' => <Vartotojo Identifikatorius operatoriaus sistemojedažniausiai MSISDN telefono numeris )>
  5.   'language' => <Vartotojo kalbos kodas ISO 639-standartu>
  6.   'country' => <Vartotjo šalies kodas ISO 3166-alpha-standartu>
  7.   ...
  8.   ...
  9.  )




Tags:

return:  Vartotojo informacija


[ Top ]

method getAccountLanguage [line 553]

string getAccountLanguage( )

Gražina vartotoja kalbą ISO 639-1 standartu

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getAccountMSISDN [line 502]

string getAccountMSISDN( )

Gražina vartotojo telefono numerį

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getAccountType [line 527]

string getAccountType( )

Gražina vartotojo mokėjimo tipą (prepaid, postpaid, testing, unknown)

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getCountry [line 567]

string getCountry( )

Gražina vartotoja kalbą ISO 3166-1 alpha-2 standartu

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




Tags:

deprecated:  


[ Top ]

method getOperatorId [line 466]

string getOperatorId( )

Gražinama vartotojo operatoriaus identifikatorius. Dažniausia tai būna vartotojo telefono numeris.

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




Tags:

deprecated:  


[ Top ]

method getOperatorMSISDN [line 491]

string getOperatorMSISDN( )

Gražina vartotojo telefono numerį

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




Tags:

deprecated:  


[ Top ]

method getOperatorName [line 452]

string getOperatorName( )

Gražinamas vartotojo operatoriaus pavadinimas. Pvz:. bite_lt, bite_lv, tele2_ee, omnitel_lt ir t.t.

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




[ Top ]

method getOperatorType [line 516]

string getOperatorType( )

Gražina vartotojo mokėjimo tipą (prepaid, postpaid, testing, unknown)

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




Tags:

deprecated:  


[ Top ]

method getSubscriberIdent [line 589]

string getSubscriberIdent( )

Gražina prenumeratoriaus identifikatorių paslaugoje (jei galima registruotis į vieną paslaugą kelis kartus)



[ Top ]

method getSubscriberState [line 609]

string getSubscriberState( )

Gražina prenumeratoriaus tikslesnį statusą paslaugoje



[ Top ]

method getSubscriberStatus [line 599]

string getSubscriberStatus( )

Gražina prenumeratoriaus statusą paslaugoje



[ Top ]

method getTransaction [line 619]

string getTransaction( )

Gražinamas parametras, kuris buvo nustatytas siunčiant į MBS identifikavimo sistemą.



[ Top ]

method getUserInfo [line 408]

array getUserInfo( )

Gražinamas masyvas identifikuoto vartotojo duomenų.

Gražinamo masyvo struktūra:

  1.  array(
  2.   'accountID' => <Varotojo identifikatorius MBS sistemoje>
  3.   'operatorName' => <Vartotojo operatoriaus pavadinimas>
  4.   'operatorID' => <Vartotojo Identifikatorius operatoriaus sistemojedažniausiai MSISDN telefono numeris )>
  5.   'language' => <Vartotojo kalbos kodas ISO 639-standartu>
  6.   'country' => <Vartotjo šalies kodas ISO 3166-alpha-standartu>
  7.   ...
  8.   ...
  9.  )




Tags:

return:  Vartotojo informacija
deprecated:  


[ Top ]

method getUserLanguage [line 541]

string getUserLanguage( )

Gražina vartotoja kalbą ISO 639-1 standartu

Šis parametras gali būti tuščias jeigu paslaugos užsakyme nebuvo nurodyta perduoti.




Tags:

deprecated:  


[ Top ]

method isIdentified [line 631]

boolean isIdentified( )

Patikrinama ar vartotoją buvo bandoma nustatyti. Jei buvo bandoma ir nepavyko tai metodas getAccount grąžins 0.



Tags:



[ Top ]

method MakeIdentify [line 125]

boolean MakeIdentify( string $trans, [array $additional = array()], [boolean $encode = false])

Inicijuoti vartotojo identifikavimą

Vykdomas vartotojo identifikavimas. Vartotojas persiunčiamas į MBS identifikavimui. Sėkmingai įvykdžius šią funkciją programos veikimas nutraukiamas.

Parametras $trans privalo būti netuščias. Jo paskirtis susieti vartotoją išėjusį iš partnerių sistemos su vartotoju grįžusiu po identifikavimo. Dažniausia naudojamas laikyti sesijos identifikatorių(tačiau neprivalomai). Šis parametras gražinamas GET[‚t‘] būdu.

Parametras $additional vienmatis masyvas, tai parametrai kurie bus gražinami kartus vartotojo duomenimis po identifikavimo GET‘e.

$addinional parametruose negalima naudoti rezervuotu parametrų 'i', 'a', 't', 's1', 's2', 'op', 'oi', 'sid', 'al', 'ac', 'u', 'k'.

Jeigu nustatytas $encode į TRUE vadinasi nuorodoje visus & keičiame į &amp; tai daroma išvedant nuorodą WML puslapiuose.




Parameters:

string   $trans   Identifikavimo tranzakcija
array   $additional   Papildomi parametrai, kurie bus prideti prie identifikavimo URL
boolean   $encode   Ar pakeisti simboli '&' į '&amp;' ( be kabučių )

[ Top ]

method MakeIdentifyRemote [line 198]

string MakeIdentifyRemote( [integer $service_id = null], IP $account_ip, array $account_headers, [string $account_cookie = null], [Url $account_url = null], [string $account_user_agent = null])

Performs remote WAP browsing user identification.

Current user data are given to MBS remotely, then as much as possible account information is returned (country, language, operator, operator ident, operator MSISDN, etc.)

Grąžinamo masyvo struktūra:

  1.  array(
  2.     'visit' => Identification event structure
  3.     'url' => URL to which redirect should be performed
  4.  )

!IMPORTANT! Remote identification works if operator turned on identification in your server




Tags:

return:  URL is given if MBS requires redirect for further identification


Parameters:

integer   $service_id   Id of identification service
IP   $account_ip   Visiting account IP address
array   $account_headers   Visiting account headers
string   $account_cookie   (optional) Visiting account cookie string
Url   $account_url   (optional) Visiting account URL
string   $account_user_agent   (optional) Visiting account User Agent

[ Top ]

method MakeIdentifyUrl [line 240]

string MakeIdentifyUrl( [string $trans = null], [array $additional = array()])

Veikimas identiškas MakeIdentify tiktai nenutraukia darbo ir nenukreipia vartotojo į MBS,
  • grąžina suformuotą nuorodą į MBS.




Tags:



Parameters:

string   $trans   [optional] $trans - transaction id
array   $additional   [optional] $additional - additional parameters addet to identify link

[ Top ]

method unsetAccountData [line 383]

void unsetAccountData( )

unset user data in session



[ Top ]

method unsetUserData [line 375]

void unsetUserData( )

Anuliuojami vartotojo duomenys saugomi sesijoje.



Tags:

deprecated:  


[ Top ]

method _getUserInformation [line 273]

void _getUserInformation( )

Nustatoma ar vartotojo grąžintas iš MBS po identifikavimo jei taip, vartotojo duomenys užkraunami.

Šis metodas vykdomas konstruktoriaus metu.




Tags:

access:  protected


[ Top ]


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