0.1.5
Manuelle Installation
Die
manuelle Installation eines AllMyPHP Scrips empfehlen wir grundsätzlich
nur den versierten Benutzern. Die Installationsschritte sind größtenteils
deckungsgleich mit Programmen die nicht über einen speziellen
Installer verfügen. Es ist notwendig die Konfigurationsdatei
selbstständig korrekt auszufüllen. Das beinhaltet auch die
korrekte Angabe von Pfaden und Daten, in diesem Dokument soll einem
die manuelle Installation vereinfacht werden.
Dieses Dokument geht nicht extra auf die Punkte ein, die bereits
im Kapitel 0.1.3 - Vor der Installation beschrieben
sind.
- Zunächst
ist die Konfigurationsdatei anzupassen.
Eine leere Konfigurationsdatei findet sich im Ordner "tools",
und hat folgenden Inhalt:
(Die
hier aufgeführten Zeilennummern entsprechen den Zeilennummern
der config.inc.php, und dienen zur Orientierung. Nicht aufgeführte
Bereiche der config.inc.php müssen nicht bearbeitet werden,
oder können bei einer Bearbeitung AllMyLinks beschädigen!)
- SQL
Verbindungsdaten
| 15 |
//
--> BEGIN SQL settings ----------------------------------------------------------------------------------------------------------------- |
| 16 |
$_AMLconfig['sql_dabatype']
= "MySQL"; |
| 17 |
$_AMLconfig['sql_username']
= "x"; |
| 18 |
$_AMLconfig['sql_password']
= "x"; |
| 19 |
$_AMLconfig['sql_hostname']
= "localhost"; |
| 20 |
$_AMLconfig['sql_dabaname']
= "allmylinks"; |
| 21 |
$_AMLconfig['sql_debugsql']
= false; |
| 22 |
//
<-- END SQL settings -------------------------------------------------------------------------------------------------------------------- |
In
den Zeilen 15 bis einschließlich 22 werden die Verbindungsdaten
zur Datenbank eingetragen.
» 'sql_dabatype'
Hier hinein gehört der Datenbank Typ. Es ist auf Groß-Kleinschreibung
zu achten. Folgende Werte sind entsprechend des Datenbank Typs
gültig: "MySQL"; "mSQL"; "PostgreSQL";
"PostgreSQL_local";"ODBC";"ODBC_Adabas";
"Interbase"; "Sybase".
» 'sql_username'
Dies ist der Benutzername zur SQL Datenbank, der berechtigt
ist auf 'sql_dabaname' zuzugreifen
» 'sql_password'
Dies ist das zum Benutzernamen zugehörige Passwort. Wird
für den Verbindungsaufbau kein Passwort benötigt,
so ist hier nichts einzutragen.
» 'sql_hostname'
Hostname ist der Name des Servers auf dem die SQL Datenbank
installiert ist. In der Regel ist dies localhost bzw. die IP
des Servers auf dem auch AllMyLinks liegt.
» 'sql_dabaname'
Der Datenbankname ist der Name der Datenbank innerhalb des SQL
Servers. Dieser Name ist in der Regel nicht bestimmbar und wird
vom Provider gestellt.
» 'sql_debugsql'
Hier hat man die Option bei Fehlermeldungen das debuglevel
einzuschalten. Somit erhält man im Klartext alle Querys
die an die SQL Datenbank gesendet werden. (true/false)
- Tabellen
Namen bestimmen
| 10 |
//
--> BEGIN table names ------------------------------------------------------------------------------------------------------------------ |
| 11 |
$_AMLconfig['tbl_user']
= "allmyphp_user"; |
| 12 |
$_AMLconfig['tbl_config']
= "aml5_config"; |
| 13 |
$_AMLconfig['tbl_categories']
= "aml5_categories"; |
| 14 |
$_AMLconfig['tbl_comments']
= "aml5_comments"; |
| 15 |
$_AMLconfig['tbl_blocked']
= "aml5_blockeduser"; |
| 16 |
$_AMLconfig['tbl_header']
= "aml5_header"; |
| 17 |
$_AMLconfig['tbl_links']
= "aml5_links"; |
| 18 |
$_AMLconfig['tbl_brokenvalues']
= "aml5_brokenvalues"; |
| 19 |
$_AMLconfig['tbl_wrdfil']
= "aml5_wrdfil"; |
| 20 |
$_AMLconfig['tbl_protocols']
= "aml5_protocols"; |
| 21 |
$_AMLconfig['tbl_languages']
= "aml5_language"; |
| 22 |
$_AMLconfig['tbl_notes']
= "aml5_notes"; |
| 23 |
$_AMLconfig['tbl_preferences']
= "aml5_preferences"; |
| 24 |
//
<-- END table names -------------------------------------------------------------------------------------------------------------------- |
Hier
können die Namen für die Tabellen bestimmt werden.
Es ist darauf zu achten das die Namen der Tabellen exakt denen
der Datenbank entsprechen! Eine Änderung/Anpassung ist
hier in der Regel nicht nötig!
- Pfade
bestimmen
| 42 |
//
--> BEGIN path sourroundings ----------------------------------------------------------------------------------------------------------- |
| 43 |
$_AMLconfig['cfg_scripturl']
= "http://localhost"; |
| 44 |
$_AMLconfig['cfg_scriptpath']
= "/AllMyLinks0.4.0"; |
| 45 |
$_AMLconfig['cfg_serverpath']
= "H:/AllMyLinks0.4.0"; |
| 46 |
//
<-- END path sourroundings ------------------------------------------------------------------------------------------------------------- |
Im
Laufe der Zeit konnte man feststellen, das die Pfadeinstellungen
für viele Benutzer eine scheinbar unüberwindbare Hürde
darstellt. Allein aus diesem Grunde wurde dann auch später
ein Installer eingeführt, der diese Pfade selbstständig
herausfindet.
» 'cfg_scripturl'
Die Installations-URL wird benötigt um Links korrekt
setzen zu können. Im Normalfall ist dies "http://www.domain.de",
kann aber natürlich auch jede andere Subdomain als "www"
enthalten: "http://beispiel.domain.de".
Wichtig: Web-Accounts von freien Anbietern geben in der Regel
ein Verzeichnis einer Domain frei, z.B. "http://mitglied.provider.de/userXYZ".
Auch in diesem Fall ist die Script-URL nur "http://mitglied.provider.de",
weil das "/userXYZ" ein Verzeichnis ist, und zu dem
Script Pfad gehört!
» 'cfg_scriptpath'
Der Script Pfad ist der "Rest" der kompletten
URL, ausgehend vom Basisverzeichnis; der Domain selbst. Hat
man AllMyLinks unter "http://mitglied.provider.de/userXYZ/AllMyLinks/"
installiert, so muß der Script Pfad "/userXYZ/AllMyLinks/"
lauten.
» 'cfg_serverpath'
Wie der normale PC auch, hat ein Webserver eine Verzeichnisstruktur.
In dieser Verzeichnisstruktur gibt es Verzeichnisse in denen
die Daten für die über den Browser erreichbare Website,
abgelegt werden. Der Serverpfad ist der komplette Pfad vom Basisverzeichnis
(Bei Unix Systemen immer /, bei Windows LW:/) bis zum Verzeichnis
in dem sich AllMyLinks befindet, z.B. "/home/userx/www/htdocs/AllMyLinks/"
für Unix oder Linux Systeme, oder z.B. "c:/inetpub/wwwroot/AllMyLinks/"
bei Windows Systemen.
- Cookie
Einstellungen
| 49 |
//
--> BEGIN cookie settings -------------------------------------------------------------------------------------------------------------- |
| 50 |
$_AMLconfig['cookie_name']
= "allmyphp_cookie"; |
| 51 |
$_AMLconfig['cookie_expire']
= "31536000"; |
| 52 |
$_AMLconfig['cookie_path']
= "/"; |
| 53 |
$_AMLconfig['cookie_domain']
= "localhost"; |
| 54 |
$_AMLconfig['cookie_secure']
= "0"; |
| 55 |
//
<-- END cookie settings ---------------------------------------------------------------------------------------------------------------- |
Die Cookie Einstellungen sind in der Regel
eindeutig und können so wie sie sind belassen werden, es
hat keine Auswirkung auf Sicherheit und Funktion. Selbstverständlich
bieten wir aber die Möglichkeit auch diese Einstellungen
den eigenen Wünschen/Einstellungen nach anzupassen
» 'cookie_name'
Der
Cookie Name dient der Identifizierung. Auch wenn nur von AllMyLinks
Cookies geschrieben werden, so benötigen diese einen eindeutigen
Namen. Der Name darf alphanumerisch sein, ein Semikolon, Freizeichen
oder ähnliche Sonderzeichen bis auf das "_" sind
ausgeschlossen und führen zu Fehlfunktionen!
»
'cookie_expire'
Gibt in Sekunden die Gültigkeit des Cookies an.
AllMyPHP setzt Cookies in der Regel mit 31536000 Sekunden Gültigkeit.
Dies entspricht einem Jahr.
» 'cookie_path'
Der
Pfad gibt an, auf welcher Ebene des Webservers ein Cookie gültig
ist. Ist dieser Wert z.B. "/AllMyLinks", so ist der
Cookie nur dann gültig wenn eine Datei aus dem Verzeichnis
/AllMyLinks versucht auf den Cookie zuzugreifen. Aufgrund von
möglicher Inkludierung in andere Verzeichnisse sollte der
Wert auf "/" belassen werden, somit ist dieser Cookie
auf jeder Ebene der Domain gültig!
»
'cookie_domain'
[nicht genutzt] Gibt die Domain an für die der
Cookie gültig ist. Ist dieser Wert leer oder wird gar nicht
verwendet, wird die aktuelle Domain aus der die Datei aufgerufen
wurde die den Cookie schreibt verwendet.
» 'cookie_secure'
[nicht
genutzt] 0/1 Bestimmt ob nur sichere Cookies gesendet werden
sollen oder nicht. Sichere Cookies können nur in einer
https Umgebung gesendet werden.
- Environment
Einstellungen
| 58 |
//
--> BEGIN Environment ------------------------------------------------------------------------------------------------------------------ |
| 59 |
$_AMLconfig['env_REMOTE_ADDR']
= getenv("REMOTE_ADDR"); |
| 60 |
$_AMLconfig['env_HTTP_USER_AGENT']
= getenv("HTTP_USER_AGENT"); |
| 61 |
$_AMLconfig['env_HTTP_REMOTE_HOST']
= gethostbyaddr(getenv("REMOTE_ADDR")); |
| 62 |
$_AMLconfig['env_HTTP_REFERER']
= getenv("HTTP_REFERER"); |
| 63 |
$_AMLconfig['env_SCRIPT_NAME']
= getenv("SCRIPT_NAME"); |
| 64 |
$_AMLconfig['env_SCRIPT_FILENAME']
= getenv("SCRIPT_FILENAME"); |
| 65 |
$_AMLconfig['env_REQUEST_URI']
= getenv("REQUEST_URI"); |
| 66 |
//
<-- END Environment -------------------------------------------------------------------------------------------------------------------- |
Das
Environment sind Pfade und Einstellungen rund um den Server
/ die Clientverbindung die mit AllMyLinks in Verbindung stehen.
Im Normalfall sind die Voreinstellungen hier richtig und können
so genutzt werden
- Verknüpfung
zur config.inc.php herstellen
Damit
AllMyLinks korrekt arbeiten kann, ist es notwendig den folgenden
Code in die Datei ./index.php einzufügen:
| |
<?PHP
// --> BEGIN including config --------------------------------------------------------------------------------------------------------
if(!$_AMLinclude['res_config'] = include("KOMPLETTERSERVERPFADZUAML/include/config.inc.php"))
{
die("can not load <i>config.inc.php</i>
so I will die now!");
}
// <-- END including config ---------------------------------------------------------------------------------------------------------- |
Der
Code ist einfach zu kopieren und einzufügen. Bitte beachten
das "KOMPLETTERSERVERPFADZUAML" gegen den tatsächlichen
Serverpfad ersetzt wird. Keine HTTP Inkludierung hier vornehmen!
- SQL
DUMP importieren
Als letzten Schritt ist die SQL-Dump
Datei welche sich im Ordner "./tools" befindet zu importieren.
Es wird ein Administrator angelegt mit den Benutzerdaten:
Benutername: Administrator
Password: 123ganzviele
Diese Daten sind beim ersten öffnen der Administrationsoberfläche
sofort zu ändern! Hierzu gibt es eine Oberfläche im
Menüpunkt "Allgemeines".
AllMyLinks
ist nun vollständig installiert. |