PhPoint Dev Tools - phpoint-make-upkg

Aus OneNext Knowledge Base

Dieses Tool sollte nicht mehr verwendet werden, da der phPoint Quellcode komplett mit git verwaltet wird!

Dieses Tool ist im OneNext Apt Archiv verfügbar!

phpoint-make-upkg ist ein Bash Script, das Update Pakete für phPoint erstellt.

Aufruf

Sie müssen erstmalig die Verzeichnisstruktur anlegen und die nötigen Dateien kopieren. Keine Sorge, dies wird für sie durch Angabe von init erledigt.

phpoint-make-upkg init

Das Script akzeptiert nun insgesamt 5 Parameter. Die letzten 4 Parameter WORKDIR, SOURCE, TESTDIR und UPDATEDIR müssen allerdings nur dann angegeben werden, wenn sie von der Grundkonfiguration in /etc/phpoint-make-upkg.conf abweichen.

phpoint-make-upkg PKGNAME WORKDIR SOURCE TESTDIR UPDATEDIR

Das folgende Beispiel erzeugt ein Update Paket von Version 1.8.7 auf Version 1.8.8.

phpoint-make-upkg phpoint_1.8.7-1.8.8

Der Aufruf sollte folgendes ausgeben und das Paket update-phpoint_1.8.7-1.8.8.tar.gz erzeugen. Das Prefix update- wird dem Paketnamen automatisch vorangestellt.

I: Generate patchfile "update.patch"
I: Execute phPoint devtools scripts
I: Touch all files (using date from "version.php")
I: Calculate checksums
I: Create archive package
I: Copy temporary package into testdir "old"
I: Remove unused updatefiles in "old"
I: Extract the archive into "old"
I: Remove the temporary package in "old"
I: Done (update-phpoint_1.8.7-1.8.8.tar.gz)

Achtung! Damit sie neue Update Pakete direkt testen können, extrahiert sich das Paket nach old/update. Anschliessend ist es möglich, old/update/update.php aufzurufen. Beachten Sie bitte: Wenn Sie update.php ohne den Parameter dryrun aufrufen, wird das Update direkt eingespielt. Die Dateien im Verzeichnis old, entprechen dann der aktuellen Version in htdocs.

Konfiguration

In der Konfigurationsdatei /etc/phpoint-make-upkg.conf werden die Standardeinstellungen gesetzt.

# Config file for phpoint-make-upkg
# Please set up your own things here and not in the script!
 
# Default workingdir (absolute)
DEFWORKINGDIR="/var/www"
 
# Default dir (relative) for new files
DEFNEWFILES="htdocs"
 
# Default dir (relative) for old files
DEFOLDFILES="old"
 
# Default dir (relative) for update files (update.php, etc...)
DEFUPDATEDIR="update"

DEFWORKINGDIR
Ist der absolute Pfad zur Verzeichnisstruktur, welche die folgenden drei Unterverzeichnisse enthält.

DEFNEWFILES
In diesem Unterverzeichnis befindet sich die neue Version des Projekts.

DEFOLDFILES
Die alte Version des Projekts befindet sich in diesem Unterverzeichnis.

DEFUPDATEDIR
Enthält die Datei update.php, einige Hook Scripts, Apps- und Template Dumpfiles, usw... In diesem Verzeichnis wird das Update Paket zusammengestellt.

Update Pakete verwenden

Das fertige Update Paket wird in den Pfad der phPoint Installation kopiert und mit folgendem Kommando entpackt.

tar xfz update-phpoint_1.8.7-1.8.8.tar.gz

Anschliessend wechselt man in das neu entpackte update Verzeichnis und startet das Script update.php wie folgt.

cd update
./update.php dryrun

Der zweite Parameter dryrun bewirkt, dass ein Update nur simuliert wird. Erscheinen keine Fehlermeldungen, starten sie update.php erneut, diesmal ohne dryrun.

./update.php

Fertig! Wenn das Update erfolgreich ausgeführt wurde, sollte im Backend des CMS die Version 1.8.8 erscheinen.

Aufräumen

Verwenden Sie folgenden Befehl, um das update Verzeichnis zu bereinigen.

phpoint-make-upkg clean

Achtung! Das Unterverzeichnis update/new wird nicht bereinigt!