Konfiguration

Ab pvptools v0.3 findet die gesamte Konfiguration in der Datei pvptools.config.php statt - was einige Vorteile gegenüber der Konfiguration in jedem Skript selbst hat:

• ein zentraler Punkt für die Konfiguration
• keine doppelten Einstellungen
• einfachere Updates

Der einzige mir bekannte Nachteil ist, dass einzelne Skripte auch für sie nicht relevante Einstellungen mit laden - um mit Ruby Rod zu sprechen: "Wen interessierts?"

Struktur der Konfigurationsdatei

Nach wie vor handelt es sich hier um eine PHP Quellcode Datei, die von den jeweiligen Skripten direkt eingebunden wird. Das bedeutet, wir müssen uns an die PHP Coding Regeln halten.

Die Datei ist in Sektionen (durch Kommentarzeilen mit Doppellinie getrennt) unterteilt, welche sich wiederum in Unter-Sektionen (Kommentarzeile mit einfacher Linie) gliedern. Für diesen Artikel ist nur die erste Sektion (Configuration) interessant - alles andere betrachten wir als "Code", an dem der Anwender sich normalerweise nicht zu schaffen machen sollte. Daher beschäftigen sich die folgenden Abschnitte mit den Unter-Sektionen der Sektion Configuration.

Globale Konfiguration

Die erste Unter-Sektion beschäftigt sich mit der Anbindung der jeweiligen phpVideoPro Installation(en). Da die Skripte des pvptools Paketes sich der API von phpVideoPro bedienen, müssen sie schließlich auch wissen, wo sie selbige finden - und benötigen die ID des Benutzers admin, damit sie auf alles Zugriff haben. Die folgenden Erklärungen beziehen sich auf die Einstellungen der mitgelieferten Beispiel-Konfiguration:

Einstellung	Default-Wert	Erklärung
$instance["demo"]->dir	'/var/www/phpvideo'	"Root" Verzeichnis der phpVideoPro Installation
$instance["demo"]->adminID	1	Die userID des Benutzers admin. Ist sie nicht bekannt, lässt sie sich im Web-Interface von phpVideoPro nachschlagen (Menü Admin⇒Usermanagement)
$myinstance	'demo'	Wer nur eine phpVideoPro Installation hat (oder nur mit einer arbeiten möchte), gibt diese hier an. Sollen die Skripte hingegen für mehrere Installationen verwendet werden, muss man diesen Parameter auskommentieren. Das ändert die Syntax der Skripte dann dahingehend, dass zusätzlich (als erster Parameter) die zu verwendende Installation angegeben werden muss.

Einstellungen der IMDB Updater

Die nächste Unter-Sektion beschäftigt sich mit den IMDB Updater Skripten - wer diese nicht benutzt, kann den Abschnitt daher überspringen.

Einstellung	Default-Wert	Erklärung
$instancedemo?→imdbid	TRUE	movie updater: Soll nach IMDBIDs für Filme, die noch keine haben, gesucht werden?
$instancedemo?→rating	TRUE	movie updater: Sollen die Ratings aus der IMDB bezogen werden?
$stopafter	200	Wie viele Filme pro Durchlauf maximal bearbeitet werden sollen
$ignore_cat	"cat_videoclip"	movie updater: Filme dieser Kategorie(n) werden ignoriert (mehrere Kategorien mit Kommata trennen).
$skip_id	array()	movie updater: Array von IDs, die ignoriert werden sollen. Bitte im entsprechenden Artikel nach den Details sehen.
$skip_to	1	Starte mit diesem Index
$stop_at	100	Hier ist Schluss (Details wieder im entsprechenden Artikel).
$write_yt	TRUE	movie updater: Datenbank aktualisieren, wenn Filmtitel und Jahr übereinstimmen.
$write_aka_yt	TRUE	movie updater: Datenbank aktualisieren, wenn eine der AKAs und das Jahr übereinstimmen.
$write_yf	FALSE	movie updater: Datenbank aktualisieren, wenn nur das Jahr übereinstimmt (gefährlich!)
$write_yd	FALSE	movie updater: Datenbank aktualisieren, wenn Jahr und Regisseur übereinstimmen.
$report_nochange	TRUE	name updater: Log-Ausgabe, wenn keine Änderung nötig war?
$compare_mode	equal	name updater: Wie sollen Namen verglichen werden? Details zu den verfügbaren Modi finden sich im entsprechenden Artikel.
$update_name	FALSE	name updater: Sollen Einträge aktualisiert werden, wenn die gefundene IMDBID von der bereits gespeicherten abweicht?

Einstellungen des Backup-Skriptes

Hier gibt es nur eine spezielle Einstellung: $instance["demo"]->cleandb (in der Beispiel-Konfiguration auf TRUE gesetzt) legt fest, ob in der Datenbank bereits vorhandene Filme vor der Wiederherstellung aus einem Backup gelöscht werden sollen. Normalerweise ist dies der Fall (da man ja zum Status des Backups gelangen möchte). Setzt man dies auf FALSE, werden die Datensätze aus dem Backup einfach hinzugefügt - was natürlich zu Duplikaten führen kann (und in der Regel auch wird).