Servercoding

Wake on LAN benötigt eine Netzwerkkarte, sowie eine Hauptplatine, die WOL unterstützen. Die Netzwerkkarte muss über Standby mit Strom versorg sein. Ist dies der Fall, kann man der Netzwerkkarte ein sog. Magic Paket senden, was dann zum starten des Rechners führt.

Dieses Magic Paket enthält sechs mal hintereinander den Wert FF, danach folgt 16 mal die MAC-Adresse der Netzwerkkarte. Für den Versand von so einem Datenpaket gibt es jede Menge Windows-Tools.

Manchmal möchte man aber das WOL automatisieren, z. B. für das regelmässige sichern von Desktop-Rechnern. An dieser Stelle bräuchte man dann ein Script, das man zeitgesteuert ausführen lassen kann. Genau so ein Problem hatte ich kürzlich zu lösen. Meist bietet sich hier eine Scriptsprache wie Perl oder Windows Power Shell an. Da ich aber am liebsten in PHP programmiere, hab ich das WOL-Script eben mit PHP geschrieben.


Hier mal meine Lösung:

//#!/usr/bin/php -q

#!C:\Program Files\php\php.exe -q



// -------------------------------------------------------------------------------------------------------------------------

// Main Script

// -------------------------------------------------------------------------------------------------------------------------

// Hosts mit IP und Mac

$hosts = array(

                array('mac' => '00-11-22-FF-EE-AA', 'host' => '192.168.0.55', 'port' => '7')

              );

//

// WOL ausführen

//

try

{

    foreach($hosts as $host)

    {

        pingPC($host);

        if ( $return == 0 )

        {

            echo "Rechner laeuft";

        }

        else

        {

            echo "Rechner aus";

        }

        wakeOnLAN($host['mac'], $host['host'], $host['port']);

    }

}

catch(Exception $e)

{

    echo $e->getMessage();

    exit();

}

// -------------------------------------------------------------------------------------------------------------------------

// WOL Funktion

// -------------------------------------------------------------------------------------------------------------------------

function wakeOnLAN( $macAdress, $host, $port )

{

    $magicPacket = '';              // Magisches Packet für WOL (entsprechend AMD Spec)

    $ff = chr(0xFF);                // notwendiger Hexwert

    $host = 'udp://' . $host;

    //

    // Verbindung aufbauen

    //

    if( !$fp = fsockopen($host, $port, $errno, $errstr, 2) )

    {

        fclose($fp);

        throw new Exception("NetworkException: Es konnte keine Verbindung mit $host [$macAdress] hergestellt werden. Error Message: " . $errstr );

    }

    //

    // Überflüssige Zeichen aus der Mac-Adresse filtern und in Binär-Zeichenkette konvertieren

    //

    $macAdress = preg_replace('/[^a-f0-9]/i', '', $macAdress);

    $macAdressBin = pack('H12', $macAdress);

    //

    // Magic Packet aufbauen

    //

    $magicPacket  = str_repeat($ff, 6);                     // 6 x FF

    $magicPacket .= str_repeat($macAdressBin, 16);          // 16 x Mac-Adresse der Netzwerkkarte

    //

    // Magic Packet senden

    //

    fwrite($fp, $magicPacket);

    fclose($fp);

    return true;

}

function pingPC( $host )

{

    exec("ping $host -n 1", $array, $returnCode);

    return $returnCode;

}

Netbeans 6.5 (mit PHP Plugin) ist IMHO die derzeit beste Entwicklungsumgebung für PHP. In einem Vergleich zwischen Netbeans 6.5 und Eclipse PDT auf Webseite des PHP Magazins geht Netbeans als Sieger hervor.

Dass PHP nicht nur irgendsoein Plugin für Netbeans ist, sondern ernsthaft als Entwicklungs-Sprache angesehen wird, merkt man nicht zuletzt daran, dass Netbeans PHP einen eigenen PHP Learning Trail widmet.

Und weil Netbeans sehr innovativ ist und viele Informationen auch über Screencasts zur Verfügungstellt, gibt es auch zur PHP Entwicklung auf Netbeans Einführungs-Videos:

Demo of PHP support in NetBeans 6.5


Demo of PHP support in NetBeans 6.5 - Part II: Editor Features

Class Property Variables in NetBeans IDE 6.5 for PHP


Zudem gibt es einen eigenen Weblog zu PHP mit Netbeans

Auf der Webseite von MySQL findet man eine neue Alpha-Verson 6.0.9 von MySQL 6.0. Sie enthält die zwei neue Storage-Enginges - die transaktionale Falcon Engine und die ausfallsichere Maria-Engine. Hier findet man einige Informationen zu den Änderungen in MySQL.

Für den produktiven Einsatz wurde der MySQL Community Server 5.1.32 veröffentlicht. Beschreibung der Neuerungen im Handbuch.

MySQL hat auf ihrer Website einen Anwenderbericht der Uni Duisburg-Essen veröffentlicht. Darin geht es um eine hochverfügbare eLearning Lösung auf Basis von MySQL.

Für .Net Entwickler gibt es ein neues Release des .Net Connectors in der Version 6.0 Alpha.

In diesem Artikel möchte ich euch zeigen, wie man gezielt eine RFC-Funktion bzw. genauer gesagt ein BAPI über PHP aufruft und das Ergebnis verarbeitet.

In meinem letzten Artikel bin ich bereits darauf eingegangen, wie man grundsätzlich ein PHP-Script mit einem SAP-Server verbinden kann. Dabei habe ich als SAP-Server das Test-System von SAP verwendet. Wobei ich mit dem Begriff Test-System vorsichtig sein muss, weil damit in einer typischen SAP Drei-System-Landschaft meist auch das Qualitätssicherungs-System gemeint ist. Also ihr braucht dagegen so eine kostenlose 90-Tage Ausprobier-Version, entweder Mini-SAP oder Mini-WAS, die ihr z. B. im SAP Developer Network downloaden könnt.

Wenn man ein Datenbank-Anwendung kennenlernen will, benötigt man Testdaten. Was die Nordwind-Datenbank bei MS Access ist, ist die Flugdatenbank bei SAP Mini-WAS. Unter diesem Link findet man übrigens eine Übersicht über die Tabellen der Flugdatenbank.

Als Ziel setzen wir uns, die Kundendaten aus Tabelle SCUSTOM auszulesen. Dabei können wir mit PHP natürlich nicht direkt auf die Datenbanktabelle zugreifen. Stattdessen benötigen wir einen ABAP-Funktionsbaustein, den wir über RFC aufrufen und der uns die Ergebnisse zurück liefern soll. So einen FuBa könnten wir natürlich selber in ABAP programmieren. Das Problem ist, eigene Programme liegen im sog. Z-Namensraum und weichen vom SAP-Standard ab. Besser ist es, wenn man Standard-Funktionen von SAP aufrufen kann. Außerdem, warum das Rad neu erfinden? Wir haben Glück. Für die Ausgabe einer Kundenliste existiert die BAPI-Funktion BAPI_FLCUST_GETLIST.

BAPI steht für Business Application Programming Interfaces. BAPIs gehören zum SAP Business Frameworks und stellen eine Kommunikations-Schnittstelle nach außen dar. Während klassische Funktionsbausteine explizit als Remote-Baustein deklariert werden müssen, damit sie von extern aufgerufen werden können, sind BAPIs automatisch Remote-fähig.

Nun zu unserem Script. Damit wir auf den SAP-Server zugreifen können, brauchen wir wieder die Verbindungs- und Logindaten. Für eine leichtere Wiederverwendung habe ich diese Daten in ein externes Script conf/sap_connection.conf.php ausgelagert:

//

// Verbindungsdaten zum SAP-Server

//

$sapServer = array();

// NSP

$sapServer["NSP"] = array(  'USER'      => 'bcuser',            // SAP User

                            'PASSWD'    => 'minisap',           // SAP User Passwort

                            'NSP'       => 'NSP',               // SAP SID

                            'ASHOST'    => '127.0.0.1',         // SAP Application Server

                            'SYSNR'     => '00',                // System Nummer

                            'CLIENT'    => '000'                // Mandant

);

?>

Im Haupt-Script wird diese Datei mit

include("conf/sap_connection.conf.php");

eingebunden.

Danach führen wir einige Vorbelegungen durch:

define("RFC_FUNCTION_NAME", "BAPI_FLCUST_GETLIST");

$rfcReturnTable = "CUSTOMER_LIST";

$rfcCon = null;

$rfcResult = array();

Zunächst mal geben wir die gewünschte BAPI-Funktion BAPI_FLCUST_GETLIST an. Diese BAPI gibt ihr Ergebnis u.a. in die Tabelle CUSTOMER_LIST zurück. Danach verbinden wir uns mit dem SAP-Server.

$rfcCon = saprfc_open($sapServer["NSP"]);       // Verbindungsdaten als Array

if( !$rfcCon )      // Verbindung fehlgeschlagen

{

    die( "RFC Verbindung fehlgeschlagen: " . saprfc_error() );

}

Die Variable $rfcCon erhält das Connection-Handle und muss in den folgenden Funktionen mit angegeben werden. Als nächstes registrieren wir die RFC-Funktion (also unser BAPI), die Rückgabe-Tabelle und den Import-Parameter. Wobei der Import-Parameter als Übergabe-Parameter an die RFC-Funktion zu verstehen ist.

$rfcFunction = saprfc_function_discover( $rfcCon, RFC_FUNCTION_NAME );

if( !$rfcFunction )

{

    die( "RFC Funktion konnte nicht ermittelt werden" );

}

@saprfc_table_init( $rfcCon, $rfcReturnTable );

saprfc_import( $rfcFunction, "MAX_ROWS", 20 );

Es gibt zwei Möglichkeiten, die Signatur einer RFC-Funktion festzulegen. Entweder man definiert die Signatur einer RFC-Funktion direkt über saprfc_function_define() oder man ermittelt die Signatur über saprfc_function_discover() automatisch. Die erste Variante ist aufwändiger dafür schneller, die zweite Variante bequemer, dafür aber etwas weniger performant. Wie man sieht, mag ichs bequem

Ist alles korrekt festgelegt, können wir den RFC-Aufruf ausführen:

$rfcStatus = saprfc_call_and_receive( $rfcFunction );

if( $rfcStatus != SAPRC_OK )

{

    if( $rfcStatus == SAP_EXCEPTION )

    {

        die( "RFC Exception: " . saprfc_exception( $rfcFunction ) );

    }

    else

    {

        die( "Fehler RFC-Aufruf: " . saprfc_error( $rfcFunction ) );

    }

}

Hat alles geklappt, können wir die Ergebnismenge zeilenweise auslesen. Dazu ermitteln wir mit saprfc_table_rows() die Anzahl der Reihen in der Ergebnistabelle und verarbeiten dann die Tabelle über eine for-Schleife. Die einzelnen Zeilen lesen wir mit saprfc_table_read() aus und speichern diese in einem Array.

$rows = saprfc_table_rows($rfcFunction, $rfcReturnTable);

for( $i = 1; $i <= $rows; $i++ )

{

    $rfcResult[$i] = saprfc_table_read( $rfcFunction, $rfcReturnTable, $i );

}

Ab jetzt können wir die Daten mit PHP so verarbeiten wie gewünscht. Z. B. könnten wir die Daten in einer Tabelle ausgeben:

<table border="0" cellpadding="3" cellspacing="0">

<tr>

    <th>Kunden-ID</th>

    <th>Kunden-Name</th>

    <th>Straße</th>

    <th>PLZ</th>

    <th>Ort</th>

    <th>Telefon</th>

    <th>eMail</th>

</tr>

<?php

foreach( $rfcResult as $record )

{

    echo "<tr>";

    echo "<td>" . $record["CUSTOMERID"] . "</td>";

    echo "<td>" . $record["CUSTNAME"] . "</td>";

    echo "<td>" . $record["STREET"] . "</td>";

    echo "<td>" . $record["POSTCODE"] . "</td>";

    echo "<td>" . $record["CITY"] . "</td>";

    echo "<td>" . $record["PHONE"] . "</td>";

    echo "<td>" . $record["EMAIL"] . "</td>";

    echo "</tr>";

}

?>

</table>

Das Ergebnis sollte dann im Browser in etwa so aussehen (Ok, ich hab hier etwas das SAP-GUI nachgebaut ):




In der Erweiterten Ansicht dieses Artikels ist der komplette Code nochmal dargestellt.


Links:

Allgemeine Einführung in die BAPIs (CA-BFA)

BAPI List

Absicherung der SAP RFC-Schnittstelle (BSI)

Mit PHP auf SAP zugreifen? Viele werden sich vielleicht fragen, wat?!? Warum dass denn? Schließlich hat SAP doch seine eigene Programmiersprache - nämlich ABAP. Der Allgemeine Berichts-Anwendungs-Prozessor, äh sorry, natürlich heißt's ja seit langem schon Advanced Business Application Programming. SAP ändert ja gerne mal die Namen ihrer Produkte.

Das derzeit wichtigste Produkt, der Netweaver, bietet eine enge Integration von Java über den hauseigenen J2EE-Server und dem Java Connector JCO. Außerdem existieren in SAP seit jeher Schnittstellen nach außen - klassische wie die RFCs oder moderne über HTTP/Webservices - SOA lässt grüßen. Ahh jetzt! Der Zugriff von PHP auf SAP läuft also über SOAP oder so ähnlich. Falsch gedacht! Obwohl dies natürlich auch ginge. Die Unterstützung von SOAP ist in PHP5 sehr ausgereift.

Nein. Der Zugriff erfolgt über die RFC-Schnittstelle. Möglich wird das durch die SAPRFC Extension, die 2001 von Eduard Koucky entwickelt wurde. Diese Extension wird allerdings seit 2005 nicht mehr weiterentwickelt. Es gibt aber mit SAPNWRFC, eine interessante Neuentwicklung von Piers Harding.

Ein guter Artikel, wie man SAP mit PHP connected ist "Integrating SAP with PHP" von Jason Simmons. Nach diesem Artikel bin ich auch vorgegangen.

Zunächst mal, ich hatte fürs rumspielen mit ABAP bereits eine 90-Tage Testversion von Netweaver 7.1 installiert. Diese kann man sich von sdn.sap.com runterladen. Mit dem SAP-GUI Client wird auch die notwendige librfc.dll installiert. Als PHP Umgebung verwendete ich XAMPP unter Windows. Für Windows gibt es eine DLL von SAPRFC. Diese php_saprfc.dll habe ich ins Extension-Verzeichnis von PHP kopiert und in der php.ini mit dem Eintrag

extension=php_saprfc.dll

die Extension aktiviert. Dies sollte dann über phpinfo() erkennbar sein.

Danach habe ich das mitgelieferte Script saprfc_test.php ausgeführt. Es erschien dann ein Formular, über das ich dann die Verbindungsdaten zum Mini-SAP System eingegeben habe:

Application Server: 127.0.0.1
System Number: 00
User: BCUSER
Passwort: minisap
System Name: NSP
Client: 000

Der Test war erfolgreich.

Es wurde also Zeit für ein erstes Script.

// Verbindungsdaten

$sapConnectionData = array( 'USER'      => 'bcuser',

                            'PASSWD'    => 'minisap',

                            'NSP'       => 'NSP',

                            'ASHOST'    => '127.0.0.1',

                            'SYSNR'     => '00',

                            'CLIENT'    => '000'

);

//

// RFC Verbindung zum Server aufbauen

//

$rfc = saprfc_open($sapConnectionData);

//

// prüfen ob Verbindung steht

//

if( !$rfc )

{

    echo "Fehler Verbindung: ";

    print_r( saprfc_error() );

    die();

}

else

{

    $info = saprfc_attributes($rfc);

    print_r($info);

}

saprfc_close($rfc);

Entscheidend ist die Funktion saprfc_open(), welche die Verbindung zum SAP-Server aufbaut. Als Parameter übergibt man der Funktion die Verbindungsdaten als Assoziatives Array. Der Rest des Scripts ist simpel. Es gibt einfach nur die Verbindungseigenschaften aus, die über saprfc_attributes() ermittelt werden.

"Du hast den ersten Schritt in eine neue Welt getan, Luke".

Das Script hat einwandfrei funktioniert und der Zugriff auf SAP mit PHP war garnicht so schwierig. Stellt sich immer noch die Frage, warum man denn überhaupt PHP für den SAP-Zugriff verwenden sollte. Nunja, mit Scriptsprachen lassen sich schnell und effizient Anwendungen entwickeln. Außerdem sind Scriptsprachen längst reif für den Enterprise-Einsatz, wie Grails, Ruby und nicht zuletzt PHP5 beweisen. Aber dazu mehr in einem anderen Blog-Eintrag.

Weitere Links:

SAP RFC Homepage

Blog-Seite von Piers Harding zur neuen sapnwrfc Extension

Working with PHP and SAP (Artikel von Stoyan Stefanov)


HOWTO: SCRIPTING LANGUAGE SUPPORT FOR SAP SERVICES - PHP (SAP Developer Network - Vasil Bachvarov)

Auf der "heise Developer" Webseite ist ein interessanter Überblicksartikel zur Integration von PHP und Java-Anwendungen veröffentlicht worden. Dabei geht es in erster Linie um die Anbindung Java-Backend Anwendungen an eine Webschnittstelle.

Warum sollte man sowas überhaupt machen, wo es doch Servlets und Java Server Pages gibt. Aber sogar Sun hat mittlerweile erkannt, dass Webfrontends mit Java Server Pages eben doch mühsamer zu erstellen sind, als wie mit Scriptsprachen wie PHP. Leider muss man feststellen, dass für die bestehenden Ansätze PHP und Java miteinander zu Verbinden noch viel Verbesserungsbedarf besteht. Weder die PHP Java-Extension auf PHP-Seite, noch die PHP-Servlet SAPI auf Java-Seite sind ausgereift genug für einen produktiven Einsatz. Abhilfe könnte hier vielleicht mal eine PHP Scripting Engine entsprechend der JSR 223 bringen (ab >Java6), die eine offizielle Spezifikation für die Integration von Scriptsprachen in Java darstellt.

Für den produktiven Einsatz bleibt vorerst wohl nur die lose Kopplung von PHP und Java über Webservices. Gerade seit Version 5 bietet PHP ja eine deutlich verbesserte Unterstützung für Webservices- und XML-Verarbeitung an.