Dokumentation

Bevor Sie papaya CMS installieren, passen Sie die Systemoptionen in der Datei conf.inc.php an. Sie finden die Datei im Verzeichnis /htdocs/ auf Ihrem Server. Stellen Sie die Datenbankverbindung ein und geben Sie das Verzeichnis zur papaya-Klassenbibliothek an. Die weiteren Einstellungen der Systemoptionen in der Datei conf.inc.php sind optional, da sie nach erfolgreicher Installation von papaya CMS im Menü Einstellungen ebenso geändert werden können. Verfügen Sie über mehrere Server und Domains, die mit papaya CMS betrieben werden sollen, oder möchten Sie Ihre Installation insgesamt sicherer gegen Zugriffe aus dem Internet machen, empfiehlt es sich, einige der Systemoptionen in der Datei conf.inc.php vor der Installation einzustellen.

Sie können die Systemoptionen im Menü Einstellungen oder in der Datei conf.inc.php festlegen. Im Menü Einstellungen sind die Systemoptionen thematisch in Ordnern sortiert und werden durch einen kurzen Text beschrieben. In der Datei conf.inc.php definieren Sie die Systemoption und weisen ihr einen Wert zu. Bevor Sie papaya CMS installieren, können Sie bereits einige Systemoptionen in der Datei conf.inc.php einstellen.

Example 3.12. Syntax für die Definition einer Systemoption in der Datei conf.inc.php

define('NAME_DER_SYSTEMOPTION' 'Wert');

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie die Systemoption ein und weisen Sie ihr einen Wert zu. Achten Sie auf die genaue Syntax wie unter Syntax für die Definition einer Systemoptionen in der Datei conf.inc.php angegeben.
3. Speichern Sie die Datei.

Damit papaya CMS auf die Datenbank zugreifen kann, müssen Sie in der Datei „conf.inc.php“ Benutzername, Passwort und Datenbank angeben. Wenn Sie als Datenbank SQLite benutzen, müssen Sie den absoluten Pfad zur Datenbankdatei angeben, da die Authentifizierung der Datenbank über die Rechte im Dateisystem des Servers eingestellt sind.

Example 3.13. Benutzername, Passwort und Datenbank in der Datei conf.inc.php einstellen

/*------------------------------------------------------------------------------ 
Database access
------------------------------------------------------------------------------*/
/*
* Database URI
* Example for the most common case (MySQL):
*
* mysql://username:password@localhost/name_of_database
*/
define('PAPAYA_DB_URI', 'protocol://user:password@hostname/database');

Sie können neben der URI der Standard-Datenbank die URI zur Master-Datenbank angeben, über welche die Schreibzugriffe erfolgen. Standardmäßig ist die Systemoption PAPAYA_DB_URI_WRITE auf NULL gesetzt.

Weitere Informationen zu Datenbank-Clustern finden Sie auf der Internetseite von MySQL unter http://www.mysql.com/.

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_DB_URI die Datenbankverbindung ein.
3. Tragen Sie Benutzername, Passwort und Hostname ein.
4. Speichern Sie die Datei.

Table 3.5. Details zur Systemoption PAPAYA_DB_URI

Geben Sie den absoluten Pfad zum Verzeichnis der papaya-Klassenbibliothek an, damit Sie die Verzeichnisse /papaya-lib/ und /papaya-data/ außerhalb der DocumentRoot anlegen können. Die Installation ist dann sicherer, da die Dateien vor dem Zugriff aus dem Internet geschützt sind.

Example 3.14. Verzeichnis zur papaya-Klassenbibliothek angeben

/*------------------------------------------------------------------------------ 
Framework (in most of the cases, no changes needed!)
------------------------------------------------------------------------------*/
/*
* Path to the papaya CMS class framework (~/papaya-lib/)
*/
define('PAPAYA_INCLUDE_PATH', dirname(__FILE__).'/papaya-lib/');

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_INCLUDE_PATH den absoluten Pfad zum Verzeichnis /papaya-lib/ an.
3. Speichern Sie die Datei.

Table 3.6. Details zur Systemoption PAPAYA_INCLUDE_PATH

Geben Sie einen neuen Namen für die Datenbanktabelle an, in der Sie eine andere Konfigurationen von papaya CMS speichern möchten. Dadurch können Sie auf einer papaya-Installation mehrere Konfigurationen einstellen. Nachdem Sie der Datenbanktabelle einen neuen Namen gegeben haben, müssen Sie den Installationsassistenten von papaya CMS ausführen. Der Installationsassistent füllt die Datenbanktabelle mit Standardwerten, die Sie anschließend im Menü Einstellungen anpassen und sichern können. Um von einer Konfiguration zu einer anderen zu wechseln, ändern Sie den Namen der Datenbanktabelle.

Example 3.15. Namen der Datenbanktabelle angeben

/*------------------------------------------------------------------------------
*Special database parameters (in most of the cases, no changes needed!)
*------------------------------------------------------------------------------*/
(…)
/*
* options table name (including prefix)
*/
define('PAPAYA_DB_TBL_OPTIONS', 'papaya_options');
(…)

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_DB_TBL_OPTIONS den Namen der Datenbanktabelle ein, in der Sie die Konfiguration speichern möchten.
3. Speichern Sie die Datei.

Table 3.7. Details zur Systemoption PAPAYA_DB_TBL_OPTIONS

Sie können für eine Datenbanktabelle ein Präfix angeben, wenn Sie mehrere papaya-Installationen oder Webauftritte gleichzeitig mit einer Datenbank betreiben möchten. Sie richten die Datenbank nur einmal ein und können Sie für alle papaya-Installationen oder Webauftritte nutzen. Durch das Präfix werden die Daten der verschiedenen Datenbanktabellen voneinander getrennt, sodass die Daten nicht überschrieben werden. In der Standardeinstellung hat das Präfix den Namen papaya.

Geben Sie der Datenbanktabelle nur dann einen Präfix, wenn Sie mehrere papaya-Installationen oder Webauftritte mit einer Datenbank betreiben möchten. Arbeiten Sie mit einer papaya-Installation für einen Webauftritt, können Sie diesen Schritt überspringen.

Example 3.16. Präfix für die Datenbanktabelle angeben

/*------------------------------------------------------------------------------
*Special database parameters (in most of the cases, no changes needed!) 
*------------------------------------------------------------------------------*/
(…)
/*
* papaya tables prefix
*/
define('PAPAYA_DB_TABLEPREFIX', 'papaya');

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_DB_TABLEPREFIX den Namen des Präfix ein.
3. Speichern Sie die Datei.

Table 3.8. Details zur Systemoption PAPAYA_DB_TABELPREFIX

Im Wartungsmodus wird Ihr Webauftritt durch eine Standardseite ersetzt, auf der Sie z.B. die Nutzer Ihres Webauftritts über die Dauer der Wartung informieren können. Speichern Sie die Standardseite als HTML-Dokument im Verzeichnis “/htdocs/“ Ihrer papaya-Installation ab. Im Wartungsmodus können Sie papaya CMS installieren, aktualisieren sowie Templates ändern, ohne dass unbefugte Nutzer sensible Daten, wie etwa Debug-Ausgaben, einsehen können.

Example 3.17. Wartungsmodus aktivieren

/*------------------------------------------------------------------------------ 
* Maintenance / Technical problems (in most of the cases, no changes needed!)
*------------------------------------------------------------------------------*/
/* 
* maintenance mode - show maintenance page 
*/ 
 
define('PAPAYA_MAINTENANCE_MODE', TRUE); 
 
/* 
* maintenance page - (error/maintenance.html) 
*/ 
define('PAPAYA_ERRORDOCUMENT_MAINTENANCE', 'Name_der_Standardseite.html'); 
(…)

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert der Systemoption PAPAYA_MAINTENANCE_MODE auf TRUE, um den Wartungsmodus zu aktivieren.
3. Geben Sie für die Systemoption PAPAYA_ERRORDOCUMENT_MAINTENANCE den Namen des HTML-Dokuments an, das Sie als Standardseite einsetzen möchten. Das Dokument muss im Verzeichnis /htdocs/ Ihrer papaya-Installation abgelegt sein.
4. Speichern Sie die Datei.

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert der Systemoption PAPAYA_MAINTENANCE_MODE auf FALSE, um den Wartungsmodus zu deaktivieren.
3. Speichern Sie die Datei.

In der Standardeinstellung gibt papaya CMS eine eigene Fehlerseite für den HTML-Fehlercode 503 aus. Sie können ein eigenes, statisches HTML-Dokument angeben, das anstelle der papaya-Fehlerseite ausgegeben wird. Damit können Sie Fehlerseiten an Ihre Corporate Identity anpassen. Speichern Sie das HTML-Dokument im Verzeichnis /htdocs/ Ihrer papaya-Installation.

Example 3.18. Fehlerseite für den HTML-Fehlercode 503 angeben

/*------------------------------------------------------------------------------ 
* Maintenance / Technical problems (in most of the cases, no changes needed!)
*------------------------------------------------------------------------------*/ 
(…)
/* 
* technical problems page - (error/503.html) - no framework / no database 
*/ 
define('PAPAYA_ERRORDOCUMENT_503', 'Name_der_Fehlerseite.html');

Weitere Informationen zu Standardseiten für HTML-Fehlercodes finden Sie in den Systemoptionen der Standardseiten.

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_ERRORDOCUMENT_503 den Namen des HTML-Dokuments an. Das Dokument sollte im Verzeichnis /htdocs/ Ihrer papaya-Installation abgelegt sein.
3. Speichern Sie die Datei.

Sie können für die Sicherheit der Passwörter einen Hashing-Algorithmus auswählen sowie Präfixe und Suffixe für die Passwörter angeben. Die Präfixe und Suffixe werden bei der Anmeldung mit dem Passwort verknüpft. Anschließend wird der Hashwert bestimmt und mit dem Datenbankeintrag verglichen. Die Kombination erschwert die Rekonstruktion eines Passworts, auch wenn ein Angreifer den Hashwert kennt.

Sie können zwischen drei verschiedenen Hashing-Algorithmen wählen:

• Message-Diges Algorithm 5 (md5)
• Secure Hash Algorithm (sha1)
• Secure Hash Algorithm (sha256)

Example 3.19. Einstellungen für Passwörter anpassen

/*------------------------------------------------------------------------------ 
* Security (in most of the cases, no changes needed!) 
* ------------------------------------------------------------------------------*/ 
/* 
* password hashing method (md5|sha1) 
*/
 
define('PAPAYA_PASSWORD_METHOD', 'md5'); 
 
/*
* added to passwords before hashing 
*/ 
define('PAPAYA_PASSWORD_PREFIX', 'Praefix'); 
 
/*
* added to passwords before hashing 
*/ 
define('PAPAYA_PASSWORD_SUFFFIX', 'Suffix'); 
(…) 

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_PASSWORD_METHOD einen Hashing-Algorithmus ein.
3. Geben Sie für die Systemoption PAPAYA_PASSWORD_PREFIX ein Präfix ein.
4. Geben Sie für die Systemoption PAPAYA_PASSWORD_SUFFIX ein Suffix ein.
5. Speichern Sie die Datei.

Table 3.9. Details zur Systemoption PAPAYA_PASSWORD_METHOD

Die papaya-eigenen HTTP-Header enthalten Informationen zum Debugging. papaya CMS gibt in der Standardeinstellung HTTP-Header mit dem Präfix x aus. In den meisten Fällen sollten Sie die Systemoption nicht ändern und papaya-eigene HTTP-Header ausgeben.

Example 3.20. papaya-eigene HTTP-Header ausschalten

/*------------------------------------------------------------------------------ 
* Security (in most of the cases, no changes needed!) 
*------------------------------------------------------------------------------*/ 
(…) 
/* 
* disable custom http-headers like X-Generator and X-Papaya-Status 
*/ 
define('PAPAYA_DISABLE_XHEADERS', TRUE);

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert der Systemoption PAPAYA_DISABLE_XHEADERS auf TRUE.
3. Speichern Sie die Datei.

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert der Systemoption PAPAYA_DISABLE_XHEADERS auf FALSE.
3. Speichern Sie die Datei.

Wenn Sie mehrere Server unter einer Domain betreiben, können bei den Session-IDs Namenskonflikte auftreten, da nicht ersichtlich ist von welchem Server die Session-ID gesetzt worden ist. Um Namenskonflikte zu umgehen, können Sie für jeden Server ein anderes Präfix für die Session-ID einsetzen.

Example 3.21. Präfixe für Session-IDs einsetzen

/*------------------------------------------------------------------------------ 
* Session Handling (in most of the cases, no changes needed!) 
*------------------------------------------------------------------------------*/
 
/*
* suffix added to the default session name sid to handle conflicts 
* changes here will require a change in the rewrite rules 
*/ 
define('PAPAYA_SESSION_NAME', 'Praefix'); 

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Geben Sie für die Systemoption PAPAYA_SESSION_NAME ein Präfix ein.
3. Speichern Sie die Datei.

Aktivieren Sie den Entwicklungsmodus, wenn Sie Module für papaya CMS entwickeln möchten. Der Entwicklungsmodus erleichtert Ihnen die Erstellung von Templates, indem Fehler beim Parsen direkt ausgegeben werden. Deaktivieren Sie den Entwicklungsmodus für den Produktivbetrieb, da potentielle Angreifer leicht an sensible Daten kommen können.

Example 3.22. Entwicklungsmodus aktivieren

/*------------------------------------------------------------------------------ 
* Development (in most of the cases, no changes needed!) 
*------------------------------------------------------------------------------*/ 
 
/* 
* development mode - show parse errors for basic includes and some other stuff 
*/ 
define('PAPAYA_DBG_DEVMODE', TRUE);

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert für die Systemoption PAPAYA_DBG_DEVMODE auf TRUE.
3. Speichern Sie die Datei.

1. Öffnen Sie die Datei conf.inc.php in einem Texteditor, z.B. Notepad. Sie finden die Datei conf.inc.php im Verzeichnis /htdocs/ auf Ihrem Server.
2. Setzen Sie den Wert für die Systemoption PAPAYA_DBG_DEVMODE auf FALSE.
3. Speichern Sie die Datei.