Textpattern CMS auf FreeBSD 13.0 installieren & einrichten

Textpattern CMS ist ein kostenfreies, quelloffenes Content-Management-System (CMS), das auf PHP basiert. Es überzeugt durch Schnelligkeit, Sicherheit und ein schlankes Design, das eine benutzerfreundliche Oberfläche ermöglicht. Zu den Hauptmerkmalen zählen Mehrsprachigkeit, erweiterbare Funktionalität über Plugins, integrierte Features sowie ein tag-basiertes Templatesystem.

Diese Anleitung beschreibt die vollständige Einrichtung von Textpattern CMS auf einem FreeBSD 13.0 Server.

Voraussetzungen

Führen Sie die folgenden vorbereitenden Schritte aus:

• Starten Sie einen FreeBSD 13.0 Server. Eine Anleitung zur Installation finden Sie im Installations Handbuch.
• Verbinden Sie sich per SSH mit dem Server.
• Richten Sie einen Benutzer mit sudo-Rechten ein (nicht Root).

Schritt 1: Notwendige Pakete installieren

Aktualisieren Sie zunächst die Paketlisten des Systems:

freebsd-update fetch install

pkg update

Installieren Sie die benötigten Werkzeuge und Dienstprogramme:

pkg install -y sudo nano unzip wget bash

Installieren Sie PHP 7.4 sowie die notwendigen PHP-Erweiterungen:

sudo pkg install -y apache24 mysql80-server php74 mod_php74 php74-curl php74-session php74-gd php74-json php74-mbstring php74-xmlrpc php74-gmp php74-curl php74-mysqli php74-intl php74-sqlite3 php74-xml php74-zip php74-zlib php74-pdo php74-pear php74-pdo_mysql php74-filter php74-mysqli php74-zip php74-imap php74-simplexml

Aktivieren und starten Sie den PHP-FPM-Dienst:

sudo sysrc php_fpm_enable=yes

sudo service php-fpm start

Kopieren Sie die Beispielkonfigurationsdatei von PHP in das aktive Konfigurationsverzeichnis:

sudo cp /usr/local/etc/php.ini-production /usr/local/etc/php.ini

Schritt 2: Textpattern-Datenbank einrichten

Stellen Sie sicher, dass MySQL beim Systemstart automatisch geladen wird und starten Sie den Dienst:

sudo sysrc mysql_enable="yes"

sudo service mysql-server start

Öffnen Sie die MySQL-Shell (geben Sie bei der Passwortabfrage einfach Enter ein):

sudo mysql -u root -p

Legen Sie ein sicheres Passwort für den Root-Benutzer fest. Ersetzen Sie MySecurePassword durch Ihr eigenes Passwort:

ALTER USER 'root'@'localhost' IDENTIFIED BY 'MySecurePassword';

Erstellen Sie die Datenbank textpattern:

CREATE DATABASE textpattern;

Legen Sie den MySQL-Benutzer textpatternuser an und vergeben Sie ein sicheres Passwort (ersetzen Sie SecurePassword):

CREATE USER 'textpatternuser'@'localhost' IDENTIFIED WITH mysql_native_password BY 'SecurePassword';

Erteilen Sie dem Benutzer vollen Zugriff auf die Datenbank:

GRANT ALL ON textpattern.* TO 'textpatternuser'@'localhost' WITH GRANT OPTION;

Speichern Sie die Berechtigungsänderungen:

FLUSH PRIVILEGES;

Beenden Sie die MySQL-Konsole:

exit;

Schritt 3: Textpattern CMS installieren

Laden Sie die aktuellste Version von Textpattern CMS von der offiziellen Website herunter:

wget https://textpattern.com/file_download/118/textpattern-4.8.8.zip

Entpacken Sie das heruntergeladene ZIP-Archiv:

sudo unzip textpattern-4.8.8.zip

Entfernen Sie das ursprüngliche ZIP-Archiv nach dem Entpacken:

sudo rm textpattern-4.8.8.zip

Erstellen Sie das Installationsverzeichnis:

sudo mkdir -p /usr/local/www/apache24/data/textpattern

Verschieben Sie die entpackten Dateien in das neue Zielverzeichnis:

sudo mv textpattern-4.8.8/* /usr/local/www/apache24/data/textpattern

Passen Sie die Besitzrechte des Installationsverzeichnisses an:

sudo chown -R www:www /usr/local/www/apache24/data/textpattern

Setzen Sie die Zugriffsrechte korrekt:

sudo chmod -R 755 /usr/local/www/apache24/data/textpattern

Schritt 4: Apache2 für Textpattern konfigurieren

Aktivieren Sie Apache so, dass es beim Systemstart automatisch gestartet wird:

sudo sysrc apache24_enable=yes

Starten Sie anschließend den Apache-Dienst:

sudo service apache24 start

Erstellen Sie nun eine Konfigurationsdatei, damit Apache PHP-Dateien verarbeiten kann:

sudo nano /usr/local/etc/apache24/modules.d/001_mod-php.conf

Fügen Sie den folgenden Inhalt ein und speichern Sie die Datei:

DirectoryIndex index.php index.html
<FilesMatch "\.php$">
    SetHandler application/x-httpd-php
</FilesMatch>
<FilesMatch "\.phps$">
    SetHandler application/x-httpd-php-source
</FilesMatch>

Erstellen Sie nun die Apache-Konfigurationsdatei für die Textpattern-Seite:

sudo nano /usr/local/etc/apache24/Includes/textpattern.conf

Tragen Sie dort den folgenden Inhalt ein und speichern Sie die Datei:

ServerAdmin admin@example.com
DocumentRoot /usr/local/www/apache24/data/textpattern
ServerName example.com

<Directory /usr/local/www/apache24/data/textpattern/>
    Options -Indexes +FollowSymLinks
    AllowOverride All
    Require all granted
</Directory>

Überprüfen Sie anschließend die Apache-Konfiguration auf Fehler:

sudo apachectl configtest

Starten Sie Apache neu, um die Änderungen wirksam werden zu lassen:

sudo service apache24 restart

Schritt 5: Textpattern-Installation abschließen

Öffnen Sie Ihren Webbrowser und rufen Sie die Installationsseite auf:

http://Server_IP/textpattern/setup/

Beispiel:

http://192.0.2.11/textpattern/setup/

Geben Sie anschließend die MySQL-Zugangsdaten ein, die Sie zuvor definiert haben.

Ein PHP-Konfigurationsblock wird angezeigt. Kopieren Sie diesen und fügen Sie ihn in eine Datei mit dem Namen config.php ein:

sudo nano /usr/local/www/apache24/data/textpattern/textpattern/config.php

Fügen Sie den folgenden Inhalt in die Datei ein und speichern Sie diese:

<?php
    $txpcfg['db'] = 'textpattern';
    $txpcfg['user'] = 'textpatternuser';
    $txpcfg['pass'] = 'SecurePassword';
    $txpcfg['host'] = 'localhost';
    $txpcfg['table_prefix'] = '';
    $txpcfg['txpath'] = '/usr/local/www/apache24/data/textpattern/textpattern';
    $txpcfg['dbcharset'] = 'utf8mb4';
    // For more customization options, please consult config-dist.php file.
?>

Führen Sie die restliche Konfiguration durch und legen Sie ein Admin-Konto an. Danach löschen Sie zur Sicherheit das Setup-Verzeichnis:

sudo rm -rf /usr/local/www/apache24/data/textpattern/textpattern/setup/

Fazit

Die Installation von Textpattern CMS auf Ihrem FreeBSD 13.0-Server ist abgeschlossen. Für weitere Anpassungen und Anleitungen nutzen Sie bitte die offizielle Dokumentation.