Quickstart n2n
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"
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!
/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.