Manuelle Installation

Bei der manuellen Installation müssen Sie die Dateien auf Ihren Webserver kopieren. Dabei spielt es keine Rolle, ob Sie Ihren Server lokal betreiben oder über FTP ansprechen. Im letzteren Fall benutzen Sie zum Kopieren der Dateien Ihren FTP-Client.

Die Distribution von papaya CMS besteht in der Regel aus einer Zip-Datei. Extrahieren Sie zunächst den Inhalt der Zip-Datei in ein Verzeichnis Ihrer Wahl. Wenn Sie den Inhalt der Zip-Datei in /usr/home/papayaCMS_5 extrahiert haben, finden Sie in diesem Ordner die zwei Unterverzeichnisse /readme und /files vor. Der erste Ordner enthält verschiedene Textdateien, die wichtige Informationen für eine erfolgreiche Installation enthalten:

changelog.txt

Enthält eine Liste der Bugfixes und neuen Features, die seit dem letzten Release hinzugekommen sind.

gpl.txt

Der Text der Gnu General Public License

htaccess.tpl

Eine Vorlage für die .htaccess-Datei. Wenn Sie papaya CMS in ein Unterverzeichnis von DocumentRoot installieren, können Sie die Standard-.htaccess nicht benutzen, da in den Rewrite-Direktiven der Name des Unterverzeichnisses eingetragen werden muss. Diese Vorlagendatei enthält an entsprechenden Stellen den Platzhalter {%webpath_pages%}. Mit der Ersetzen-Funktion eines Textbrowsers Ihrer Wahl können Sie diesen Platzhalter mit dem Namen des Unterverzeichnisses ersetzen und erhalten eine gültige .htaccess-Datei, die Sie anstelle der Standarddatei einsetzen können.

liesmich.txt

Enthält wichtige Informationen zu dieser Ausgabe von papaya CMS sowie eine Installationsanleitung.

update_de.txt

Enthält eine deutschsprachige Anleitung, wie Sie papaya CMS beta2 auf die aktuelle Release-Version von papaya CMS aktualisieren können.

update_en.txt

Enthält eine englischsprachige Anleitung, wie Sie papaya CMS beta2 auf die aktuelle Release-Version von papaya CMS aktualisieren können.

Der zweite Ordner /files enthält fünf Verzeichnisse und drei Dateien, welche die Programmdateien und Ressourcen von papaya CMS bilden:

/papaya-data/
Datenverzeichnis für das CMS
/papaya-lib/
papaya-Klassenbibliothek
/papaya/
papaya-Administrationsinterface
/papaya-script/
diverse Scripte (u.a. zur Flasherkennung)
/papaya-themes/
Themes, also CSS-Dateien und Grafiken
.htaccess
RewriteRules für den Apache
conf.inc.php
Basiskonfiguration für papaya CMS
index.php
Seitenindex für das Frontend
favicon.ico

Das Favicon, das der Nutzer der Website vor der URL in der Adresszeile sehen kann. Sie sollten dieses Standardicon durch Ihr eigenes Icon ersetzen.

Wenn Sie die Installer-Version heruntergeladen haben, werden Sie noch ein zusätzliches Verzeichnis mit dem Namen /special vorfinden. Dieses enthält spezielle Scripte, mit denen das Installationsprogramm die Serverkonfiguration überprüfen kann.

Sie haben nun mehrere Möglichkeiten, papaya CMS zu installieren:

  • Sie kopieren den gesamten Inhalt des Verzeichnisses /files in das Wurzelverzeichnis für Ihre Internetdokumente (DocumentRoot).
  • Sie kopieren den gesamten Inhalt des Verzeichnisses /files in ein Unterverzeichnis von DocumentRoot. Sie müssen jedoch die .htaccess-Datei in das Wurzelverzeichnis kopieren und die Rewrite-Regeln anpassen.

In beiden Fällen sollten Sie nicht vergessen, Apache so zu konfigurieren, dass die .htaccess-Datei im DocumentRoot gelesen wird. Näheres dazu erfahren Sie in Abschnitt 2.2.1, „Apache konfigurieren“.

[]

Sie haben zudem in beiden Fällen die Möglichkeit, die Verzeichnisse papaya-data und papaya-lib in einen Ordner außerhalb von DocumentRoot zu verschieben. Auf diese Weise können Sie Ihre Installation sicherer machen, da wichtige Dateien vor dem Zugriff aus dem Internet geschützt sind.

papaya CMS in DocumentRoot installieren

Im Folgenden soll beschrieben werden, wie Sie papaya CMS im DocumentRoot Ihres Webservers installieren. Dabei werden Sie die Ordner /papaya-data und /papaya-lib außerhalb des htdoc-Ordners unterbringen. In den meisten Linuxdistributionen befindet sich das Wurzelverzeichnis für WWW-Dokumente, kurz DocumentRoot, in /srv/www/htdocs/. Für Windows kann sich DocumentRoot beispielsweise unter C:\webspace\www\htdocs\ befinden. Für die manuelle Installation gehen Sie nun wie folgt vor:

  1. Erstellen Sie auf Ihrem Webserver unter /srv/www/ den Ordner /files/.

  2. Kopieren Sie die Verzeichnisse/papaya/, /papaya-script/ und /papaya-themes/ in das Wurzelverzeichnis /srv/www/htdocs/.

  3. Kopieren Sie die Verzeichnisse /papaya-data/ und /papaya-lib/ in ein Verzeichnis außerhalb von DocumentRoot, in unserem Beispiel nach /srv/www/files.

  4. Öffnen Sie die Datei conf.inc.php. Sie müssen folgende Einträge ändern:

    • DEFINE("PAPAYA_DB_URI", "mysql://user:password@localhost/database");

      Geben Sie in dieser Zeile für user den Benutzernamen und für password das Passwort für Ihre MySQL-Datenbank an. Für database geben Sie den Namen der Datenbank ein. Falls der Datenbankserver nicht auf dem selben Rechner liegt wie der Webserver, müssen Sie den Eintrag localhost entsprechend ändern.

    • DEFINE("PAPAYA_INCLUDE_PATH", dirname(__FILE__)."/../files/papaya-lib/");

      Tragen Sie in dieser Zeile den relativen Pfad zur Programmbibliothek von papaya ein. Der Eintrag muss in diesem Beispiel /srv/www/files/papaya-lib/ lauten. Die Funktion dirname(__FILE__) ermittelt dabei das DocumentRoot der Datei conf.inc.php. Wenn das Verzeichnis wie in diesem Fall Außerhalb von DocumentRoot liegt, können Sie den relativen Pfad mit dem Pfadoperator .. spezifizieren.

    Speichern Sie die Datei nach den Änderungen ab.

  5. Kopieren Sie die Dateien .htaccess, conf.inc.php, favicon.ico und index.php nach /srv/www/htdocs/.
  6. Starten Sie Ihren Webbrowser und öffnen Sie das Installationsscript unter: http://www.meine-domain.tld/papaya/install.php Ersetzen Sie den Abschnitt www.meine-domain.tld durch Ihre tatsächliche Internetadresse. Bei einer lokalen Installation werden Sie bspw. http://localhost/papaya/install.php aufrufen.

Näheres zur Initialisierung der Datenbank und zur ersten Konfiguration von papaya CMS erfahren Sie in Abschnitt 2.4, „Initialisierung und Konfiguration“.

papaya CMS in ein Unterverzeichnis installieren

In einigen Fällen möchte man papaya CMS nicht in das Wurzelverzeichnis seines Servers installieren. Dies ist dann der Fall, wenn man papaya CMS testen möchte und bereits ein bestehendes Webprojekt vorliegen hat, das nicht angetastet werden soll. Damit papaya CMS korrekt läuft, muss jedoch die .htaccess-Datei zunächst umgeschrieben werden, damit die darin definierten Rewrite-Direktiven auf die richtigen Verzeichnisse angewandt werden.

Als Beispiel soll angenommen werden, dass Sie papaya CMS nicht in das Wurzelverzeichnis für WWW-Dokumente /srv/www/htdocs/ installieren möchten, sondern in den Ordner /srv/www/htdocs/test/. Sie müssen diesen Unterordner daher in die .htaccess-Datei eintragen. Um diesen Vorgang zu erleichtern, wird papaya CMS mit einer .htaccess-Vorlage ausgeliefert, die Platzhalter enthält. Sie können also diese Vorlage in einem Texteditor öffnen und mit der Suchen-und-Ersetzen-Funktion den Platzhalter mit dem Verzeichnisnamen ersetzen. Dazu gehen Sie wie folgt vor:

  1. Öffnen Sie die Datei htaccess.tpl im Unterverzeichnis /readme/ von /papayaCMS_5/ mit einem Textverarbeitungsprogramm wie Notepad (Windows) oder vim (Linux).
  2. Ersetzen Sie den Platzhalter {%webpath_pages%} durch den Namen des Unterverzeichnisses, in das Sie papaya CMS auf Ihrem Webserver installieren möchten. Im oben genannten Beispiel ist dies /test/. Bitte achten Sie dabei auf das „/“ am Ende des Verzeichnisnamens. Sie können unter Notepad die Ersetzen-Funktion des Editors benutzen, um diese Änderung in der gesamten Datei durchzuführen.
  3. Speichern Sie die Datei unter dem Namen .htaccess ab. Wenn Sie Notepad verwenden, setzen Sie den Dateinamen in Anführungszeichen, da der Editor ansonsten die Speicherung der Datei verweigert.
  4. Kopieren Sie nun die von Ihnen erstellte .htaccess-Datei nach /srv/www/htdocs/.
  5. Starten Sie Ihren Webbrowser und öffnen Sie das Installationsscript unter: http://www.meine-domain.tld/test/papaya/install.php Ersetzen Sie den Abschnitt www.meine-domain.tld durch Ihre tatsächliche Internetadresse. Ersetzen Sie /test/ durch den Namen des Unterverzeichnisses, in das Sie papaya CMS installiert haben. Bei einer lokalen Installation werden Sie bspw. http://localhost/test/papaya/install.php aufrufen.

[]

Wenn Sie mehrere Projekte auf Ihrem Webserver betreiben und bisher immer Unterverzeichnisse zur Organisation verwendet haben, sollten Sie die Benutzung von VirtualHost in Betracht ziehen. Mit VirtualHost können Sie verschiedene Domains unter einer IP-Adresse betreiben. Apache verwaltet dabei für jeden virtuellen Host ein DocumentRoot. Wenn Sie papaya CMS in ein virtuelles Host installieren, brauchen Sie die .htaccess-Datei nicht anzupassen. Sie können dabei beliebig viele papaya-Installationen parallel betreiben.

Lesen Sie nun im nächsten Abschnitt, wie Sie mit dem Installationsscript Datenbanktabellen anlegen und initialisieren und papaya CMS für den Betrieb konfigurieren.

Suche

Im Handbuch suchen nach:

Fehler gefunden?

Teilen Sie uns mit, wenn Sie Fehler gefunden haben. Auf diese Weise helfen Sie uns, die Qualität der Dokumentation zu verbessern: Redaktion

Weiterfürende Links