Dokumentation

Sie können papaya CMS entweder mit einem Apache-Server oder Lighttp-Server betreiben. papaya CMS erfordert bestimmte Einstellungen in PHP und MySQL, um einwandfrei laufen zu können. PHP erfordert XML, XSLT und Erweiterungen für Ihren Datenbankserver, wie GD Library, ImageMagick, GraphicksMagick oder Netpbm. Die Erweiterungen werden standardmäßig mit PHP 5 ausgeliefert. Legen Sie die Datenbank mit UTF-8-Zeichensatzkodierung an und wählen Sie eine entsprechende UTF-8-Kollation, damit die Inhalte alphabetisch korrekt sortiert werden.

• Installation und Konfiguration eines Apache-Servers: http://httpd.apache.org/docs/
• Installation und Konfiguration von PHP: http://www.php.net/manual/de/

• wie Sie Ihren Apache-Server konfigurieren,
• wie Sie Ihren lighttpd-Server konfigurieren,
• wie Sie PHP konfigurieren und
• wie Sie die Datenbank MySQL anlegen.

Nehmen Sie folgende Einstellungen an Ihrem Apache-Server vor, damit papaya CMS installiert werden kann:

• Aktivieren Sie das Modul mod_rewrite.
• Geben Sie die Datei .htaccess frei.
• Betreiben Sie mehrere Webauftritte auf einem Apache-Server, konfigurieren Sie den Server mit Virtual Hosting.

papaya CMS benötigt das Modul „mod_rewrite“, das in der Konfigurationsdatei des Apache-Servers standardmäßig auskommentiert ist.

Example 3.1. mod_rewrite aktivieren

„LoadModule rewrite_module modules/mod_rewrite.so“

1. Öffnen Sie die Konfigurationsdatei httpd.conf Ihres Apache-Servers in einem Texteditor, z.B. Notepad. Sie finden die Datei im Verzeichnis Ihrer Apache-Installation.
2. Entfernen Sie die Raute vor der Direktive LoadModule.
3. Speichern Sie die Datei.
4. Starten Sie den Server neu.

Apache kann eine Reihe von Verzeichnissen für die Webfreigabe verwalten. Sie können ein Verzeichnis als DocumentRoot festlegen und weitere Verzeichnisse für Skripte wie Perl oder PHP angeben. Über <Directory>-Bereiche können Sie für jedes der Verzeichnisse Einstellungen vornehmen. Auf diese Weise können Sie bestimmen, ob die Datei .htaccess in dem Verzeichnis ausgewertet werden soll. Die Freigabe wird durch die Direktive AllowOverride festgelegt.

Example 3.2. .htaccess-Datei freigeben

# Each directory to which Apache has access can be configured 
# with respect to which services and features are allowed
# and/or disabled in that directory (and its subdirectories). 
<Directory "/Pfad_zur_DocumentRoot">
  Options FollowSymLinks 
  AllowOverride All 
</Directory>

Example 3.3. AllowOverride in die Datei httpd.conf einfügen

<Directory "/Pfad_zur_DocumentRoot"> 
  Options FollowSymLinks 
  AllowOverride None 
  RewriteEngine On 
  #remove session id 
  RewriteRule ^/?sid[a-z]*([a-zA-Z0-9,-]{32}|[a-zA-Z0-9,-]{40})(/.*) $2 [QSA] 
  #admin pages 
 
  RewriteCond %{REQUEST_FILENAME} !-d 
  RewriteCond %{REQUEST_FILENAME} !-f 
(…)
</Directory> 

1. Öffnen Sie die Konfigurationsdatei httpd.conf Ihres Apache-Servers in einem Texteditor, z.B. Notepad. Sie finden die Datei im Verzeichnis Ihrer Apache-Installation.
2. Setzen Sie den Wert der Direktive AllowOverride auf All.
3. Speichern Sie die Datei.

Um mehrere Webauftritte unter verschiedenen Domain-Namen auf einem Apache-Server zu betreiben, können Sie Ihren Apache-Server mit Virtual Hosting konfigurieren. Mit Virtual Hosting können Sie verschiedene Domains unter einer IP-Adresse betreiben. Wenn Sie mehrere Virtual Hosts mit der gleichen Konfiguration anlegen möchten, verwenden Sie VirtualDocumentRoot anstelle von DocumentRoot. VirtualDocumentRoot bildet Verzeichnisnamen auf URLs ab.

1. Öffnen Sie die Konfigurationsdatei httpd.conf Ihres Apache-Servers. Sie finden die Datei im Verzeichnis Ihrer Apache-Installation.
2. Definieren Sie für jeden virtuellen Host eine eigene DocumentRoot.
3. Fügen Sie innerhalb der Tags <VirtualHost> die <Directory>-Elemente ein.
4. Setzen Sie den Wert der Direktive AllowOveride auf All.
5. Speichern Sie die Datei.

Example 3.4. Virtual Hosts mit der gleichen Konfiguration erstellen

<VirtualHost 192.168.1.80:80> 
  VirtualDocumentRoot /usr/local/apache/vhosts/%0 
  (…)
</VirtualHost>

1. Öffnen Sie die Konfigurationsdatei httpd.conf Ihres Apache-Servers. Sie finden die Datei im Verzeichnis Ihrer Apache-Installation.
2. Legen Sie einen <VirtualHost>-Bereich an, der die Direktive VitualDocumentRoot enthält.
3. Speichern Sie die Datei.

Als Alternative zum Apache-Server können Sie papaya CMS auf einem Lighttpd-Server betreiben. Lighttpd-Server kennen die Datei “.htaccess“ nicht. Alle Optionen der Konfiguration werden in der Datei „lighttpd.conf“ gespeichert.

Nehmen Sie folgende Einstellungen an Ihrem Lighttpd-Server vor, damit papaya CMS installiert werden kann:

• Aktivieren Sie die für den Betrieb von papaya CMS notwendigen Module.
• Fügen Sie der Konfigurationsdatei „lighttpd.conf „die Rewrite-Regeln für papaya CMS hinzu.
• Stellen Sie für den Lighttpd-Server ein, dass papaya CMS das Handling für den HTTP-Fehlercode 404 übernimmt.

papaya CMS benötigt insbesondere die Module „mod_rewrite“ und „mod_fastgi“, die Sie ggf. in die Datei „lighttpd.conf“ einfügen müssen.

Example 3.5. Module aktivieren

server.modules = ( 
"mod_rewrite", 
"mod_redirect", 
"mod_alias", 
"mod_access", 
"mod_cml", 
"mod_trigger_b4_dl", 
"mod_auth", "
"mod_status", 
"mod_setenv", 
"mod_fastcgi", 
"mod_proxy", 
"mod_simple_vhost", 
"mod_evhost", 
"mod_userdir", 
"mod_cgi", 
"mod_compress", 
"mod_ssi", 
"mod_usertrack", 
"mod_expire", 
"mod_secdownload", 
"mod_rrdtool", 
"mod_accesslog" 
)

1. Öffnen Sie die Datei lighttpd.conf in einem Texteditor, z.B. Notepad. Sie finden die Datei im Verzeichnis Ihrer Lighttpd-Installation.
2. Bearbeiten Sie die Option server.modules, wie unter Module aktivieren angegeben. Beachten Sie die vorgegebene Reihenfolge der Module.
3. Speichern Sie die Datei.

Example 3.6. PHP im Fastcgi-Modus aktivieren

#### fastcgi module 
## read fastcgi.txt for more info 
## for PHP don't forget to set cgi.fix_pathinfo = 1 in the php.ini 
fastcgi.server = ( 
  ".php" => 
   ("localhost" => 
     ("socket" => "/tmp/php-fastcgi.socket", 
      "bin-path" => "/usr/local/bin/php" 
     ) 
   ) 
)

1. Öffnen Sie die Datei lighttpd.conf in einem Texteditor, z.B. Notepad. Sie finden die Datei im Verzeichnis Ihrer Lighttpd-Installation.
2. Bearbeiten Sie das Modul fastcgi.server, wie unter PHP im Fastcgi-Modus aktivieren angegeben.
3. Speichern Sie die Datei.

papaya CMS benötigt für den korrekten Betrieb Rewrite-Regeln, die Sie in die Option url.rewrite-once der Datei lighttpd.conf eintragen.

Example 3.7. url.rewrite-once aktivieren

#### papaya-rewrites 
url.rewrite-once = ( 
"^/?(?:sid[a-z]*(?:[a-zA-Z0-9,-]{32}|[a-zA-Z0-9,-]{40})/)?papaya/module\_([a-z\_] )\.[a-z]{3,4}(?:\?(. ))?$" => "/papaya/module.php?p_module=$1"