NAME ^

Business::PhoneBill::Allopass - Une classe pour le système de micro-paiement d'Allopass

SYNOPSIS ^

  use Business::PhoneBill::Allopass;

  my $allopass=Business::PhoneBill::Allopass->new($session_file, [$ttl]);
  
  # Vérifie si la classe est correctement créée.
  die "Cann't create class: ".$allopass unless ref $allopass;
  
  # Vérifie l'accès
  if ($allopass->check($document_id, [$RECALL])) {
        print "OK\n";
  } else {
        print $allopass->get_last_error;
  }
  
  # Termine la session
  $allopass->end_session($document_id);

DESCRIPTION ^

Cette classe fournit une API au système Allopass. Elle gère automatiquement les sessions utilisateur.

Voir http://www.allopass.com/index.php4?ADV=1508058 pour de plus amples informations sur leur système, et savoir son fonctionnement de base.

METHODES ^

new Constructeur de classe.

    $allopass=Billing::Allopass->new($session_file, [$ttl]);

$session_file est le chemin d'accès absolu au fichier de session. Votre serveur web doit y avoir accès en écriture.

$ttl est le nombre de minutes d'inactivité avant la suppression automatique de la session. Defaut : 60.

$allopass est la référence de l'objet créé. elle servira à appeler les méthodes et modifier les propriétés. Si la création de la classe échoue, un message d'erreur est retourné en lieu et place de la référence. Vous devez donc tester si la valeur retournée est bien une référence.

check - Vérifie si un client est autorisé à accéder au document spécifié.

    $ok=$allopass->check($document_id, [$RECALL]);

Le parametre RECALL est fourni par Allopass.com lorsqu'ils redirigent le visiteur vers votre site web, après avoir vérifié le code secret (premier accès à votre script). Les accès suivants seront protégés par le système de session, vous n'avez donc plus besoin de fournir l'argument RECALL... Retourne 1 si le code est correct .

end_session - Termine la session utilisateur pour le document spécifié.

    $allopass->end_session($document_id);

get_last_error - Retourne la dernière erreur

    $err=$allopass->get_last_error();

PROPRIETES ^

ttl - Temps de vie de session.

    $ttl=$allopass->ttl([$ttl]);

Temps d'inactivité au-delà duquel la session concernée est automatiquement supprimée.

os - Système d'exploitation

    $allopass->os(1);

Vous devez positionner cette valeur à 1 si votre système d'exploitation ne supporte pas l'appel flock.

AUTEUR ^

Bernard Nauwelaerts <bpn@it-development.be>

LICENSE ^

GPL. Voir le fichier COPYING pour de plus amples informations sur GPL.

Business::PhoneBill::Allopass - Documentation en français