Quickstart n2n

Quickstart

Der Quickstart gibt einen schnelle Einführung in das Framework n2n. Er setzt voraus, dass du bereits einen ersten ܜberblick über die Struktur und den Aufbau von n2n hast. Wir empfehlen dir, das n2n Quickstart Composer Projekt zu installieren.

Voraussetzungen

n2n ist vollständig objektorientiert aufgebaut. Kenntnisse in OO-Programmierung und dem Model-View-Controller (MVC) Konzept sind also von Vorteil. Kennst du dich in dieser Welt aber noch nicht aus, kann n2n die perfekte Gelegenheit sein, die Vorteile der OO-Programmierung kennen und schätzen zu lernen! Der Quickstart wird dir dabei helfen.

Quickstart-Projekt installieren

Für diesen Quickstart haben wir ein Composer Projekt erstellt. Führe den folgende Befehl in einem Verzeichnis deines Webservers aus:

composer create-project n2n/n2n-quickstart-skeleton quickstart

Datenbank Verbindung eingerichtet

Das Quickstartmodul benötigt Datenbankzugriff. Unter var/etc/app.ini muss die Datenbank-Verbindung korrekt definiert sein. Hier ein Beispiel für eine lokale MySQL-Datenbank namens example, mit dem Benutzer root und einem leeren Passwort:

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; database settings for debug mode  ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

[database : development]
default.dsn_uri = "mysql:server=localhost;dbname=example"
default.user = "root"
default.password = ""
default.transaction_isolation_level = "SERIALIZABLE"
default.dialect = "n2n\impl\persistence\meta\mysql\MysqlDialect"

Konfiguration überprüfen

n2n kennt einen page.name und einen application.name. page.name ist der offizielle Name deiner Webseite oder Applikation, während der application.name der interne Namen ist. Achte darauf, dass du bei application.name keine Leerschläge oder Sonderzeichen verwendest. Ausserdem muss der application.name eindeutig sein.

[general]
page.name = "New awesome project"
application.name = "newAwesomeProject"
Wenn du zwei Applikationen mit gleichem application.name hast, kann es dir passieren, dass du dich im Backend der einen Webseite einloggst und dann automatisch auch im Backend der anderen Webseite eingeloggt bist.

Unter [locales] kannst du bei default die Standardsprache deiner Applikation eintragen.

[locales]
default = "en"

Möglich ist hier auch "de". Bei anderen Locales fehlen noch Übersetzungen. n2n kennt noch viele weitere Einstellungen zu Locales. Auf diese gehen wir momentan aber nicht ein.

Vorbereitung: ein Modul erstellen

Für alle gezeigten Code-Beispiele verwenden wir ein eigenes Modul. Zuerst müssen wir einen Verzeichnisnamen (Namespace) für unser Modul bestimmen. Unser Modul soll Quickstart heissen. Der Einfachheit halber entscheiden wir uns für den Namespace qs. Um das Modul zu erstellen, musst du die folgenden drei Verzeichnisse erstellen:

  • app/qs
  • var/etc/qs
  • public/assets/qs

Somit hast du dein erstes n2n Modul erstellt! Jetzt bist du bereit für den n2n Quickstart!

Im n2n-Quickstart Modul gibt es die Module /qs1, /qs2, /qs3 und /qs4. In diesen Modulen ist jeweils die "Musterlösung" abgelegt. Wenn du irgendwas nicht zum Laufen bringst, kannst du in diesen Modulen nachschauen.
« MVC-Architektur Hello Controller »

Kommentare

Du musst eingeloggt sein, damit du Beiträge erstellen kannst.

Fragen