4 * -------------------------------------------
5 * Mit dieser Klasse ist ein einfacher Primeratransfer von Ihrem Account
6 * zu dem Account eines bei Primusportal.de registrierten Mitglieds möglich.
8 *------------------ Aenderungen durch Roland Haeder 09.08.2008 ----------------
9 * Klasse umbenannt nach PrimeraApi, damit sie in das Framework besser passt.
10 * Zudem sind alle oeffentlichen Attribute nun privat, der Konstruktor hat den
11 * neuen "magischen" Namen __construct() und "normale" Konstanten sind nach
12 * Klassenkonstanten umbenannt. Unsinnige else-Bloecke sind noch umgewandelt.
13 * Methodennamen fangen nun immer mit einem kleinen Buchstaben an. Zudem sind
14 * die Methoden Pay,Query und Parse umbenannt.
15 *------------------ Aenderungen durch Roland Haeder 09.08.2008 ----------------
17 * Die Einbindung des Interfaces geschieht folgendermaßen:
18 * 1. Einbindung der Klasse in Ihr PHP-Auszahlungsskript:
20 * require_once( "PFAD/ZU/DER/KLASSE/PrimusInterface.class.php" );
21 * $PPUsername = "username"; // Ihr Username bei Primusportal
22 * $PPPassword = "passwort"; // Ihr Passwort bei Primusportal
24 * $Interface = new PrimusInterface($PPUsername, $PPPassword);
25 * 2. Durchführen einer Auszahlung:
27 * $Status = $Interface->payPrimera($PayReceiver, $PayAmount, $PayDescription);
29 * Wobei $PayReicer der Username des Empfängers bei
30 * Primusportal.de ist. $PayAmount ist der gerundete( !! ) Betrag an Primera,
31 * die der Empfänger erhalten soll. $PayDescription ist eine von Ihnen
32 * festgelegte kurze Beschreibung. Die Länge dieses Textes darf 100 Zeichen
33 * nicht überschreiten. Beispiel:
34 * $status = $Interface->payPrimera("garbage", 10000, "Auszahlung IhreSeite.de - ID: 12345");
35 * 3. Überprüfung des Status (Rückgabecode):
38 * // Ein Fehler ist aufgetreten
39 * // Fehlerbehandlung hier einfügen...
41 * // Auszahlung erfolgreich durchgeführt
42 * // Führen Sie hier Ihre Datenbankabfragen durch, um die Auszahlung zu
46 * Die komplette Rückgabe des Interfaces wird als assoziatives Array in der Klassen-
47 * variable __data gespeichert:
48 * __data => array("status" => Rückgabecode (PI_DONE, PI_SENDER_ERROR, ...),
49 * "statustext" => Status in Worten (z.B.: "Transaktion erfolgreich durchgeführt"),
53 * @author Andreas Schmidt <xxgarbagexx@web.de>
54 * @author Roland Haeder <webmaster@ship-simu.org>
56 * @copyright (c) 2007 by Primusportal.de
57 * @copyright (c) 2008 by Roland Haeder
61 * Fehler - Interfacebenutzer
66 * Statuscode für erfolgreich ausgeführte Transaktion
71 * Fehler - User existiert nicht oder ist gesperrt
73 const PI_RECEIVER_ERROR = 301;
76 * Sender-Account Fehler (User nicht existent, gesperrt, ...)
78 const PI_SENDER_ERROR = 401;
83 const PI_AMOUNT_ERROR = 501;
88 const PI_TOO_LESS_PRIMERA = 502;
91 * User nicht aktiv oder existiert nicht
93 const PI_USER_CHECK_ERROR = 601;
98 const PI_USER_CHECK_OK = 602;
101 * Primerastand erfolgreich geholt
103 const PI_GET_PRIMERA_DONE = 701;
106 * URL für das Interface auf dem Primusserver:
108 private $host = "www.primusportal.de";
109 private $path = "/transfer.interface.2.0.php";
114 private $seperator = ":";
116 private $username = "";
117 private $password = "";
119 private $data = array();
124 public function __construct ($PPUsername, $PPPassword) {
125 // Call parent constructor
126 parent::__construct();
129 $this->removeSystemArray();
130 $this->removeNumberFormaters();
132 // Set data (DEPRECATED!)
133 $this->username = $PPUsername;
134 $this->password = $PPPassword;
138 * Anfrage senden und Rückgabecode in Variable speichern
140 function queryApi ( $data = array() ) {
141 $fp = fsockopen($this->host, 80, $this->errno, $this->_err);
142 if (!$fp) return false;
144 $data["PrimusInterface_Username"] = base64_encode($this->username);
145 $data["PrimusInterface_Password"] = base64_encode(md5($this->password));
147 // POST-Daten übermitteln:
148 $data = http_build_query($data, '', '&');
150 fputs($fp, "POST {$this->path}HTTP/1.1\r\n");
151 fputs($fp, "Host: {$this->host}\r\n");
152 fputs($fp, "Content-type: application/x-www-form-urlencoded\r\n");
153 fputs($fp, "Content-length: ". strlen($data) ."\r\n");
154 fputs($fp, "Connection: close\r\n\r\n");
159 $return.=fgets($fp,128);
162 $content = explode("<!-- return-start -->", $return);
167 * Funktion parst die Rückgabe vom Transferskript:
169 function parseContent ( $content ) {
170 $x = explode("\n", $content);
172 foreach($x as $currentLine) {
173 $line_exploded = explode(":", $currentLine,2);
174 if (count($line_exploded) > 1) {
175 $return[$line_exploded[0]] = $line_exploded[1];
182 * @param int/string $Receiver UserID / Username des Empfängers
183 * @param int$Amount Betrag in ganzzahligen Primera
184 * @param string $Description Beschreibung (Sichtbar in Einzelauflistung)
186 public function payPrimera ($Receiver, $Amount, $Description = "") {
188 $PostData = array("PrimusInterface_Action" => "Pay",
189 "PrimusInterface_Receiver" => base64_encode($Receiver),
190 "PrimusInterface_Amount" => base64_encode($Amount),
191 "PrimusInterface_Description" => base64_encode($Description) );
193 $PostReturn = $this->parseContent( $this->queryApi($PostData) );
195 $this->data = $PostReturn;
196 if ($PostReturn["status"] == "200") {
203 * Überprüft den Status eines Primus-Users
204 * - existiert der User
206 * @param string/int $User Userid / Username
208 function CheckPrimusUser($User) {
210 $PostData = array("PrimusInterface_Action"=> "CheckPrimusUser",
211 "PrimusInterface_CheckPrimusUser" => $User);
213 $PostReturn = $this->parseContent( $this->queryApi($PostData) );
215 $this->data = $PostReturn;
217 if ($PostReturn["status"] == self::PI_USER_CHECK_OK) {
224 * Die Funktion liefer den aktuellen Primerastand
226 function getPrimera() {
228 $PostData = array( "PrimusInterface_Action" => "GetPrimera" );
229 $PostReturn = $this->parseContent( $this->queryApi($PostData) );
231 $this->data = $PostReturn;
232 if ($PostReturn["status"] == self::PI_GET_PRIMERA_DONE) {
233 $primera = $PostReturn["primera"];