>> Inhaltsverzeichnis >> Anleitung für Entwickler

PHP-Programme auf CD-ROM brennen

Das folgende Tutorial wird erläutern, wie Sie Ihre Webanwendung mit dem Yana PHP-Framework und Server2Go auf eine CD/DVD-ROM brennen und direkt von dort starten können.

Der Zeitaufwand um alle Schritte nachzuvollziehen beläuft sich auf etwa 1/2 Stunde, nicht gerechnet die Zeit für eventuell notwendige Downloads. Literaturhinweise zu thematisch verwandten Artikeln finden Sie jeweils am Ende eines Abschnitts.

Systemvoraussetzungen

Kapitel 1: Quellen downloaden

Bevor Sie mit diesem Tutorial beginnen, sollten Sie sicherstellen, dass Sie einige Vorbereitungen abgeschlossen haben, da Sie andernfalls an eine Stelle gelangen könnten, an der Sie das Tutorial nicht fortsetzen können.

Server2Go ist Donationware und darf auch für kommerzielle Anwendungen kostenlos verwendet werden. Die Software wird von Timo Haberkern entwickelt und betreut.

Grundlegende Kenntnisse im Aufbau und der Funktion von PHP und MySQL-Datenbanken werden in diesem Artikel vorausgesetzt.

Hier einige vorbereitete Konfigurationsdateien für Server2Go. Diese Dateien basieren auf Version 1.5.0. Die Angaben gelten ohne Gewähr. Hier finden Sie Links zu einigen weiteren nützlichen Quellen:

Kapitel 2: CD-ROM vorbereiten

Um ein PHP-Programm mit dem Yana PHP-Framework direkt von CD starten zu können gehen Sie bitte wie folgt vor.

  1. Grundinstallation
    1. Entpacken Sie Server2Go.
    2. Kopieren Sie das Yana PHP-Framework in das Verzeichnis "htdocs/" des Webservers.
    3. Editieren Sie die Datei "server/config_tpl/php.ini" in einem Texteditor Ihrer Wahl. Ändern Sie den Wert "memory_limit" von "8M" auf mindestens "16M". Empfohlen sind "128M", der tatsächliche Wert ist jedoch abhängig von Ihrer PHP-Anwendung. Da bei einer CD-Anwendung nicht mehrere Nutzer gleichzeitig auf das Programm zugreifen sondern stets nur eine Person allein, brauchen Sie sich nicht zu scheuen, hier einen hohen Wert einzutragen.
    4. Öffnen Sie die Konfigurationsdatei "htdocs/yana/library.php" in einem Texteditor (z.Bsp. ConTEXT, oder PSPad).

    Die Datei "library.php" ändern Sie wie folgt: define('YANA_CDROM', true);

  2. Datenbankkonfiguration

    Falls Ihr Programm eine MySQL-Datenbank benötigt, gehen Sie wie folgt vor:

    1. Editieren Sie die Datei "pms_config.ini" im Server2Go-Verzeichnis und aktivieren Sie MySQL, indem Sie "UseMySQL" auf "1" setzen.
    2. Starten Sie Server2Go durch Ausführen der Datei "Server2Go.exe".
    3. Es wird automatisch Ihr Browser geöffnet. Auf der Startseite finden Sie im rechten Seitenmenü einen Link zu PHPMyAdmin. Die Adresse lautet: http://127.0.0.1:4001/phpmyadmin/ Klicken Sie diesen Link an, oder rufen Sie die Adresse direkt über die Adressleiste Ihres Browsers auf.
    4. Installieren Sie mit PHPMyAdmin Ihre Datenbanken. Achten Sie darauf, dass Sie den gleichen Namen für Ihre Datenbank verwenden, den Sie für Ihre lokale Installation verwendet haben. Andernfalls müssen Sie die Datenbankverbindungseinstellungen des Yana PHP-Framework entsprechend anpassen.
    5. Falls Sie die Datenbankverbindung für das Framework ändern müssen, finden Sie die Verbindungseinstellungen in der Datei "htdocs/yana/config/".
    6. Installieren Sie PEAR-DB. Gehen Sie dazu auf die Download Site und kopieren Sie das Archiv für DB und das PEAR Package auf Ihren Rechner. Sie werden ein Programm benötigen, dass die beiden TGZ-Archive entpacken kann. Sollten Sie keines besitzen, finden Sie zum Beispiel auf 7-Zip ein kostenloses Open-Source Programm, mit welchem Sie die Archive öffnen können.
    7. Die Archive sind 2 mal verpackt - Sie müssen also nachdem Sie die erste Datei entpackt haben die zweite Datei ebenfalls entpacken. Darin enthalten sind XML-Dateien, welche Sie ignorieren können, und jeweils ein Verzeichnis mit Installationsdateien. Kopieren Sie den Inhalt beider Installationsverzeichnisse in das Verzeichnis "server/php/pear/", so dass die Dateien "DB.php" und "PEAR.php" beide direkt in diesem Verzeichnis liegen. Damit ist die Installation für PEAR-DB abgeschlossen. Sie können dies testen indem Sie Server2Go starten und das Yana PHP-Framework mit dem Parameter "yana/index.php?action=test" aufrufen. Auf der Seite sollte in grüner Schrift bestätigt sein, dass PEAR-DB erfolgreich gefunden wurde.
  3. Server2Go - Konfiguration

    Nach der Installation Ihrer Datenbanken fahren Sie mit der Konfiguration fort.

    1. Um Ihnen die Aufgabe zu erleichtern, wurden für dieses Handbuch alle Einstellungen vorkonfiguriert, welche Sie für Ihre CD-ROM benötigen. Sie müssen die Dateien lediglich in das Server2Go-Installationsverzeichnis entpacken. Überschreiben Sie dabei die alten Konfigurationsdateien. Das ZIP-Archiv finden Sie hier.
    2. Konfigurieren Sie anschließend die Datenbankeinstellungen in der Datei "pms_config.ini" und den Autostart-Eintrag gemäß Ihren Wünschen. Eventuell möchten Sie auch Ihr eigenes Logo einbinden.

Anschließend kann das Paket direkt auf CD-ROM gebrannt und sofort verwendet werden.

Im nächsten Kapitel werden Sie erfahren, wie Sie Server2Go und das Yana PHP-Framework zusammen mit der Portable-Edition des Firefox Browser verwenden können.

Kapitel 3: Verwendung mit Firefox-Portable

Sie haben die Möglichkeit mit Server2Go auch einen Firefox-Browser direkt von CD zu starten. Die folgende Anleitung erklärt Ihnen, was dazu nötig ist.

Achtung: Firefox-Portable kann (soweit bekannt) mit Version 1.5.1 von Server2Go zur Zeit NICHT auf CD-ROM, sondern nur auf USB-Stick oder Festplatte verwendet werden. Das Problem wird in einer kommenden Version beseitigt sein. In der Zwischenzeit ist es möglich einen alternativen Browser zu verwenden. Eine von mehreren Möglichkeiten ist das Zusatzprogramm "SimpleBrowser" von der Server2Go Website zu verwenden. Der Autor erwartet im Gegenzug eine geringe Spende für die Weiterentwicklung der Software.
  1. Firefox Portable installieren
    1. Zuerst benötigen Sie eine aktuelle, portable Version des Browsers. Diese finden Sie auf der Website http://portableapps.com. Laden Sie diese Datei aus dem Netz und entpacken Sie sie in das Server2Go-Installationsverzeichnis (dort, wo sich "Server2Go.exe" befindet).
    2. Der Browser wird auf dieser Seite in Englisch angeboten. Sie können diesen jedoch in eine deutsche Version umwandeln. Laden Sie dazu das deutsche Sprachpaket herunter. Sie finden dieses unter anderem auf www.firefox-browser.de. Kopieren Sie die Datei "de.xpi" auf Ihren Rechner.
    3. Starten Sie FirefoxPortable, indem Sie die Datei "FirefoxPortable/FirefoxPortable.exe" ausführen. Installieren Sie die Datei "de.xpi", indem Sie sie mit entweder mit der Maus auf das Firefox-Fenster ziehen, oder indem Sie das Menü "Datei / Datei öffnen ..." anklicken und die Datei "de.xpi" aus dem Explorer-Fenster wählen.
    4. Starten Sie den Browser anschließend 1 Mal neu.
  2. Server2Go für Firefox Portable konfigurieren

    Achtung: Es gibt ein ZIP-Archiv mit allen erforderlichen Konfigurationsdateien, welches Sie verwenden können. Entpacken Sie das Archiv und überschreiben Sie alle Originaldateien. Danach sind Sie bereits fertig und können Ihre Anwendung direkt auf CD-ROM brennen.

    Falls Sie das Archiv nicht verwenden und die Schritte stattdessen von Hand durchführen wollen, fahren Sie mit der Konfiguration wie folgt fort.

    1. Öffnen Sie die Datei "pms_config.ini".
    2. Ändern Sie den Wert "BrowserType" auf "EXTERNAL"
    3. Ändern Sie den Wert "BrowserPath" auf "FirefoxPortable/FirefoxPortable.exe"
    4. Speichern Sie die Datei.
    5. Erzeugen Sie eine neue Datei: "FirefoxPortable/FirefoxPortable.ini" mit folgendem Inhalt:
      [FirefoxPortable]
      FirefoxDirectory=App\firefox
      ProfileDirectory=Data\profile
      PluginsDirectory=Data\plugins
      SettingsDirectory=Data\settings
      FirefoxExecutable=firefox.exe
      AdditionalParameters=-contentLocale de-DE -UILocale de-DE
      LocalHomepage=
      DisableSplashScreen=true
      DisableIntelligentStart=false
      AllowMultipleInstances=true
      SkipChromeFix=false
      SkipCompregFix=false
      WaitForFirefox=true
      RunLocally=true
      Eine Anleitung zu den verwendeten Optionen finden Sie in der Datei "FirefoxPortable/Other/FirefoxPortableSource/Readme.txt". Diese Datei wird mit Firefox Portable ausgeliefert. Die Option "AdditionalParameters" sorgt hier für das Starten der deutschen Version.

Anschließend kann das Paket auf CD-ROM gebrannt werden.

Warnung: es besteht die Möglichkeit, dass Server2Go auf einigen Rechnern aufgrund lokaler Firewalls oder eingeschränkter Nutzerrechte nicht korrekt funktioniert. Es ist daher dringend empfohlen, dass Sie Ihre CD-ROM auf mindestens einem anderen Testsystem ausprobieren. Unter einigen Betriebssystemen können Administratorrechte notwendig sein um die CD zu starten.
Windows Vista: Unterstützung für MS Vista wurde für Server2Go ab Version 1.5.0 eingeführt. Es kann passieren, dass der Nutzer gefragt wird, ob die Anwendung auf das System zugreifen darf. Bis Version 1.5.0 sind unter Vista Administratorrechte erforderlich um Server2Go von einer CD-ROM zu starten.
Windows 98: Für Rechner mit Windows 98, welche KEIN Microsoft Office Paket installiert haben, muss ein Patch von Microsoft installiert werden. Sie finden diesen Patch unter folgender URL: http://www.microsoft.com/downloads/details.aspx?FamilyID=6c050fe3-c795-4b7d-b037-185d0506396c&DisplayLang=de
Um einen stabilen Betrieb sicherzustellen ist außerdem ein Downgrade der MySQL-Datenbank auf Version 4 erforderlich. Dazu genügt es, die Dateien der Datenbankanwendung im Verzeichnis "server/mysql/" auszutauschen. Ein passendes Installationspaket kann von der Server2Go Website bezogen werden.

Autor: Thomas Meyer, www.yanaframework.net