DIEVOLUTION TV + Blog

Erfahrene Bäcker kennen dieses Verfahren sicherlich auswendig, doch gerade für Bäker-Lehrlinge stellt die Installation von CakePHP auf ihrem Entwicklungsrechner ein paar Fallen bereit, die sie mit diesem Mini-Tutorial umschiffen können.

Das erfahrt Ihr in diesem Tutorial:

• CakePHP downloaden
• Wohin Entpacken
• CakePHP starten
• Fehlerfreier Start

Das Tutorial ist vor allem auf Mac (wobei fast alles auch auf Linux zutreffen dürfte) Umgebungen ausgelegt, kann aber auch unter Windows verwendet werden. Dort fallen allerdings mindestens zwei Schritte weg

Voraussetzung für dieses Tutorial ist ein funktionierender Webserver (lokal oder im Netz) mit PHP und MySQL. Dazu gibts genug Tutorials

Beginnen wir zunächst mit der wohl essentiellsten Frage: Wo bekomme ich CakePHP her. Die Antwort ist in diesem Fall sehr einfach: www.cakephp.org und dort auf Download. Da endlich die 1.2er Version des Frameworks als stable verfügbar ist, müsst ihr euch nicht mehr irgendwelche Alpha oder Beta Versionen downloaden.
Habt ihr euch das Paket eurer Wahl gezogen (dmg für Mac, tar.gz für Linux und .zip für Windows, aber eigentlich egal, im Zweifel einfach das zip Archiv nehmen) entpackt es in ein Unterverzeichnis eures Webservers. Bei mir auf dem Mac wäre das im Websites Ordner der Ordner “tutorial”, den ich über http://localhost/~thomasdiehl/tutorial erreiche. Auf Windowssystemen (mit einem Xampp Apache) spräche nichts gegen http://localhost/tutorial, wenn der Unterordner im htdocs Verzeichnis installiert ist.

Achtung, Falle: Mac
Aufpassen wenn ihr den Inhalt des CakePHP Pakets irgendwo anders hinverschiebt, da die .htaccess Dateien normalerweise unsichtbar sind und daher nur mitkopiert werden, wenn ihr das Verzeichnis kopiert. Markiert ihr die Inhalte, so fällt die erste .htaccess Datei aus dem Raster.
Lösung:
Ein kleines .command Script, das alle Dateien anzeigt. Dieses verwende ich immer, bevor ich die Dateien entsprechend in die Ordner kopiere (danach kann man diese auch wieder unsichtbar machen).
ZeigeVersteckteDateien.command

VersteckeDateien.command

Nun könnt ihr auf eurem Webserver das CakePHP Projekt aufrufen.
-> http://localhost/~benutzer/tutorial (Mac)
-> http://localhost/tutorial (Windows)

Wobei ihr feststellen werdet, dass ihr auf einem Mac einen 404 Error erlebt! Dies ist leider etwas umständlich zu lösen. Nehmt den Codeedtior eurer Wahl und fügt folgende Zeile in alle 3 .htaccess Dateien eures Projektes ein:
/tutorial/.htaccess
/tutorial/app/.htaccess
/tutorial/app/webroot/.htaccess

Nun sollte sich folgendes Bild in eurem Browser zeigen:

Viele gelbe Zeilen zeigen uns, dass unsere Installation noch nicht abgeschlossen ist. Arbeiten wir diese Zeilen am besten von oben nach unten ab:

1. Warning (512): /Users/thomasdiehl/Sites/buch/app/tmp/cache/ is not writable
(Sollte auf Windows Rechnern nicht angezeigt werden)
Kein Schreibrecht für das Cache Verzeichnis. Dies können wir (zumindest auf unserem Entwicklungsrechner) relativ einfach lösen, indem wir diesem Ordner (am besten dem gesamten tmp Ordner) 777er Rechte geben, also Schreib und Leserecht für alle. Auf einem Webserver sollte man dagegen das komplette Projekt dem Webserveruser zuordnen.
Auf dem Mac rechtsklickt ihr einfach auf den Ordner tmp -> Informationen -> auf das Schloss rechts unten klicken -> Kennwort eingeben -> bei Everyone auf Lesen & Schreiben ändern und schließlich noch auf das Zahnrad -> auf alle Unterobjekte anwenden klicken.

2. Notice (1024): Please change the value of ‘Security.salt’ in app/config/core.php to a salt value specific…
Dies bedeutet, dass wir unseren Salt in der app/config/core.php ändern sollen, so dass ein zufällig generierter Wert erscheint.
Geht also in die app/config/core.php und ändert die Zeile 151, indem ihr möglichst zufällig neue Zeichen einfügt (das “auf die Tastatur hauen” hat sich dort bewährt )

3. Your database configuration file is NOT present.
Als letzten Punkt müssen wir jetzt nur noch die Datei database.php.default in database.php umbenennen und die entsprechenden Zugangsdaten in die Konfiguration der $default Datenbank eingeben.

Tipp: Wenn ihr mit Tests arbeiten wollt (und glaubt mir, ihr wollt!) ist es wichtig, einen zweiten Datenbankzugang anzugeben (unter var $test). Nehmt allerdings nicht dieselbe Datenbank wie für eure $default Konfiguration, da die Test Datenbank vor jedem neuen kompletten Testrun neu aufgebaut wird.

Habt ihr alle Konfigurationselemente erfolgreich gemeistert, sollte eure Startseite nun so aussehen:

Damit sind wir auch am Ende unseres kleinen Installationstutorials angekommen. Verbesserungsvorschläge immer gerne per Mail oder in den Kommentaren.

Kategorie: CakePHP | 1 Kommentar »