Laravel Tutorial DEUTSCH – 6 Schritt Beginner Guide

Laravel Coding Lab Steffen Lippke Guide Tutorials
Laravel Coding Lab Steffen Lippke Guide Tutorials
  1. Möchtest Du Laravel kennenlernen?
  2. Brauchst Du ein einfaches Einsteigs-Tutorial?

In 6 Schritten programmieren wir eine Laravel-API auf JSON-Basis.

[Bonus: Model-View-Controller-Laravel erklärt + Command Line Interface]

Laravel Tutorial - Inhalt - 6 Schritte zur eigenen API

Ziel

Coding

Konzept

Erweiterung

Grundlagen

Fazit

1. Kapitel

Herausforderung & Ziel: Wir entwickeln eine API mit Laravel

Ziel
Ziel

Dieses Tutorial setzt sich zum Ziel einen Backend für einen Shop mit JSON zu entwickeln. Die Daten sollen in einer MySQL Datenbank liegen, während wir über eine selbstgebautes REST-Interface mit dem MVC-Modell abfragen machen können.

 

 

Laravel API Shop mit Produkten

Die Schnittstelle /products/ soll alle Produkte mit dem Titel und dessen Beschreibung des Shops auflisten. Diese Schnittstelle könnten wir z. B. für eine App nutzen. Andere Entwickler können als Affiliate auf Deine Angebote auf anderen Webseiten zu greifen, sodass Du mehr Umsatz genieren kannst.

 

Voraussetzungen: Dein Wissen

  • Etwas programmiert haben ... mit Java, Python oder jede anderen Programmiersprache
  • Admin Rechte / Programme installieren und deinstallieren
    00 Visual Studio Code - Laravel Tutorial deutsch Guide Steffen Lippke
    00 Visual Studio Code - Laravel Tutorial deutsch Guide Steffen Lippke

Technische Voraussetzungen: Computer für Laravel vorbereiten

Für Laravel brauchen wir auf Windows eine PHP-Entwicklungsumgebung wie XMAPP mit Composer als PHP-Bibliothek-Verwaltungs-Tool.

01 XAMPP für Laravel - Laravel Tutorial deutsch Guide Steffen Lippke
01 XAMPP für Laravel – Laravel Tutorial deutsch Guide Steffen Lippke
  1. XAMPP kannst Du hier downloaden und über einen GUI installieren. Wähle nicht alle Module aus:
    03 XAMPP Setup mit wengier - Laravel Tutorial deutsch Guide Steffen Lippke
    03 XAMPP Setup mit wengier - Laravel Tutorial deutsch Guide Steffen Lippke
    04 XAMPP starten mit PHP und phpmyadmin - Laravel Tutorial deutsch Guide Steffen Lippke
    04 XAMPP starten mit PHP und phpmyadmin - Laravel Tutorial deutsch Guide Steffen Lippke
  2. Composer kannst Du im XAMPP-Shell oder in der Windows PowerShell installieren. Nutze für die Installation das aktuelle 4-zeilige Skript auf der Download-Webseite von Composer.
    05 PHP Shell für Composer Installation - Laravel Tutorial deutsch Guide Steffen Lippke
    05 PHP Shell für Composer Installation – Laravel Tutorial deutsch Guide Steffen Lippke
  3. Im nächsten Schritt richten wir die Umgebungsvariablen für Composer und PHP in Windows ein.
    06 Umgebungsvariablen - Laravel Tutorial deutsch Guide Steffen Lippke
    06 Umgebungsvariablen - Laravel Tutorial deutsch Guide Steffen Lippke
  1. Die Umgebungsvariablen lädt Dein Computer nur, wenn Du Dich ausloggst und wieder einloggst (nicht sperren!)
    07 Composer Variable setzen - Laravel Tutorial deutsch Guide Steffen Lippke
    07 Composer Variable setzen - Laravel Tutorial deutsch Guide Steffen Lippke
  2. Öffne die Windows PowerShell im Administrator-Modus (Linksklick auf das Icon).
  3. Um die Installation von Composer zu prüfen, gebe in die Shell folgendes ein
    composer
    08 Composer Powershell Startup - Laravel Tutorial deutsch Guide Steffen Lippke
    08 Composer PowerShell Start-up – Laravel Tutorial deutsch Guide Steffen Lippke

 

2. Kapitel

Konzept & Lösungsansatz: Grundlagen Laravel

Konzept
Konzept

Eine kleine Übersicht über das Wichtigste zu Laravel.

Was ist Laravel?

Das Framework Laravel erleichtert die Programmierung von Programmierschnittstellen (APIs) und Backends. Das Framework basiert auf PHP, die Pakteverwaltung Composer und dem Artisan-Comand-Line-Interface (Konsole).

02 Composer - Laravel Tutorial deutsch Guide Steffen Lippke
02 Composer - Laravel Tutorial deutsch Guide Steffen Lippke

Der Programmierer kann ein Frontend-Framework wie Angular oder Vue mit Blade in Laravel nutzen. Blade strukturiert HTML-Vorlagen, indem Blade den Bild- und Text-Inhalt in die Webseiten einfügt.

Funktionen, Vorteile + Umfang von Laravel

Wie in jedem Framework schreibst Du einen Framework-eigenen Laravel-Code. PHP-Artisan-CLI bietet mehere Funktionen, um Standard-Softwaremodule und Datenbanken zu erstellen und zu modifizieren.

Laravel erstellt z. B. einen Login mit dessen Backend-Logik automatisch. Die Struktur und Aufbau eines sicheren Logins folgt dem gleichen Muster. Mit ein paar Anpassungen kannst Du den genierten Code in Dein Projekt einfügen.

Wir arbeiten für diese Tutorial über die PHP-Artisan-CLI mit einer MySQL-Integration. Über ein PHP-Skript kann Laravel Tabellen generieren.

Composer dient als Paket-Manager für PHP-Dateien (wie Node.js für JavaScript-Bibliotheken). Der Paket-Manager installiert das Laravel-Framework auf Deinem Computer.

3. Kapitel

Basics: MVC + CLI

Grundlagen
Grundlagen

Was bedeutet MVC?

Was ist eine CLI?

Hier ein paar Grundlagen

Model-View-Controller (MVC) in Laravel

Laravel basiert auf dem Model-View-Controller-Prinzip. Das MVC trennt Datenmodell (Datenbank), Benutzeroberfläche (GUI) und Anwendungslogik. Laravel arbeitet mit einer Vielzahl an (No)SQL-Datenbanken. In diesem Tutorial verwende ich MySQL über phpMyAdmin.

Der Model-View-Controller stellt ein typisches Architektur-Muster dar. Das MVC trennt die Komponenten, weil der View „Design-Moden“ durchläuft. Alle 3–5 Jahre kristallisiert sich eine andere Form von neuen „hippen“ Design heraus. Bei einer starken Verflechtung der Komponenten, müsste der Programmierer neben dem View den Controller neu entwickeln.

Der Controller dient für die Eingaben des Views zu verifizieren und an das Backend weiterzuleiten. Neben der Überprüfung der Eingaben kann der Controller Texte übersetzt und geladene Text- und Bild-Inhalte formatieren.

Command Line Interface (CLI) – PHP-Artisan

Eine Kommandozeile (engl. Command Line Interface, CLI) steuert z. B. ein Programm über das Terminal / Bash / Shell. Der Nutzer gibt Anweisungen und Parameter per Text in die CLI ein. Ein Interpreter überprüft die Eingaben. Das Programm führt die Anweisungen mit den gegebenen Parametern aus.

Viele Entwicklungsprogramme wie Node.js, Android SDK und Composer stellen eine CLI zur Verfügung. Der Programmierer muss die Befehle kennen oder nutzt den –help Flag. Die CLIs bieten (meistens) mehr Funktionalität und Fehlerbehebungsmöglichkeiten als die GUI. Diese bauen auf die Funktionen einer CLI auf. Eine CLI bietet neben der Funktion eine Textausgabe und Debugging-Möglichkeiten.

4. Kapitel

Coden: Ab zur Praxis

Coding
Coding

Dieses Tutorial setzt sich zum Ziel einen Backend für einen Shop mit JSON zu entwickeln. Die Daten sollen in einer MySQL Datenbank liegen, während wir über eine selbstgebautes REST-Interface mit den MVC-Model abfragen machen können.

Die Schnittstelle /products/ soll alle Produkte mit dem Titel und dessen Beschreibung auflisten. Diese Schnittstelle könnten wir z. B. für eine Web App nutzen.

Laravel installieren und starten

  1. Wenn Composer läuft, installiere Laravel mit dem folgenden Kommando global auf Deinem Rechner.
    composer global require laravel/installer
  2. Gehe mit der Windows PowerShell in einen Ordner, in dem Du das Projekt starten möchtest
    cd Desktop
  3. Führe in dem Ordner das Start-Kommando aus, um das Projekt zu starten
    laravel news shop
  4. Sobald der Prozess beendet ist, gehe in der Ordner
    cd shop
    und starte den Server mit
    php aritsan serve
  5. Das erste Starten kann bis zu 10 min (je nach Rechenleistung) dauern.
  6. Öffne Deinen Browser und geben in die URL
    localhost:8000
  7. Die weiße Laravel-Default-Webseite sollte laden
    12 Laravel startet - - Laravel Tutorial deutsch Guide Steffen Lippke
    12 Laravel startet - - Laravel Tutorial deutsch Guide Steffen Lippke

Laravel Model + Controller für Shop erstellen

  1. php artisan make:migration create_products_table --create=products
  2. Erstelle eine Tabelle in PhpMyAdmin, indem Du zu
    localhost/phpMyAdmin

    11 phpmyadmin füge ein Datenbank hinzu - Laravel Tutorial deutsch Guide Steffen Lippke
    11 PhpMyAdmin füge ein Datenbank hinzu - Laravel Tutorial deutsch Guide Steffen Lippke

    gehst und dort eine Tabelle mit den Namen Laravel erstellst

  3. Im Projektordner findest Du eine
    .env
    Datei, in der die Credentials zu Deiner MySQL-Datenbank
    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=laravel
    DB_USERNAME=root
    DB_PASSWORD=

    13 env credentials - Laravel Tutorial deutsch Guide Steffen Lippke
    13 .env credentials – Laravel Tutorial deutsch Guide Steffen Lippke
  4. Mit Laravel kannst Du mit einem PHP-Script eine Tabelle hinzufügen. Bearbeite den folgenden Code in
    database > migrations > XXXX_XX_XX_063911_create_products_table.php
    zu

    14 php erstellt - Laravel Tutorial deutsch Guide Steffen Lippke
    14 php erstellt - Laravel Tutorial deutsch Guide Steffen Lippke
  5. Die CLI übernimmt die SQL-Arbeit für Dich, in dem Du
    php artisan migrate
    ausführst
  6. Füge den Controller hinzu
  7. php artisan make:controller ProductController --resource --model=Product
  8. Datenbank “sähen” mit Database Seeder / Factory
    php artisan make:factory ProductFactory --model=Product
  9. Fake 1000 Produkte
    factory(AppProduct::class, 1000)->create();
  10. Controller erstellen mit
    php artisan make:controller API/ProductController --api
  11. Füge folgenden Code hinzu
  12. Füge eine JSON Resource hinzu
    php artisan make:resource Product
    und dann
    php artisan make:resource Product --collection
  13. Ändere die Routen
  14. Füge folgenden Code hinzu
  15. Führe
    php artisan serve
    aus
  16. Öffne den Browser unter
    localhost:8000/api/products/
    Dort sollten jetzt alle Artikel angezeigt werden.
  17. Unter
    localhost:8000/api/products/1
    zeigt Dir der Browser nur 1 Produkt an
  18. Fertig

5. Kapitel

Erweiterungen: Laravel Schnittstellen

Erweiterung
Erweiterung

Mit etwas PHP Geschick geht noch mehr...

Füge nach gleichem Prinzip...

  • Nutzer
  • Shops
  • Lieferanten

...hinzu.

6. Kapitel

Fazit: Gratulation zu Deiner Laravel-API

Fazit
Fazit

Sei kreativ. Lese in der Doku. Teste Laravel.

Ich freue mich auf Deine Kommentare mit dem Link zu Deinem (ersten) Laravel-Projekt(en).

  • Schreibt von Fehlern, die auftreten ...
  • Textstellen, die undeutlich geschildert wurden
  • Kritik mit Verbesserungsvorschlägen ...
  • Vorschläge für neue Post ...
  • Installationsprobleme ...
  • Eure Erweiterungen Euer ersten Laravel App ...

Danke. Ich freue mich auf Euer Feedback.

Credits zu den verwendeten Bildern
Icons made by Vectors Market from www.flaticon.com is licensed by CC 3.0 BY

Kommentare 2

  • Hallo Herr Lippke,

    an drei Stellen hatte ich meine Schwierigkeiten:
    Die CLI übernimmt die SQL-Arbeit für Dich, in dem Du
    php artisan migrate
    ausführst
    Ich musste erst mein Passwort bei MariaDB auf „Ohne Kennwort“ setzen, was man ja nicht sollte.

    php artisan make:controller ProductController –resource –model=Product
    Ich musste den Befehl aufteilen, da ich eine Fehlermeldung bekommen
    php artisan make:model Product
    php artisan make:controller ProductController –resource

    Fake 1000 Produkte
    factory(AppProduct::class, 1000)->create();
    Wo gibt man das ein? Ich konnte somit zum Schluß keine Produkte sehen.

    Für einen Anfänger wäre es schön, wenn man ein bisschen Hintergrundwissen bekommen könnte. Warum macht man was und was bewirkt der Befehl.

    • Hallo Dirk,

      danke für Deinen Kommentar. Der Database Seeder ist eine extra Klasse, die mit dem Erstellen von Seeder über php artisan erstellt wird. Durchsuche mal die Dateistruktur nach „DatabaseSeeder“

      Für einen Anfänger wäre es schön, wenn man ein bisschen Hintergrundwissen bekommen könnte. Warum macht man was und was bewirkt der Befehl.

      Bald gibt es ein Update für diesen Eintrag.

      Grüße
      Steffen

Schreibe einen Kommentar

Deine E-Mail-Adresse wird nicht veröffentlicht. Erforderliche Felder sind mit * markiert.