Installieren
Serveranforderungen
Laravel hat einige Systemanforderungen. Natürlich werden alle diese Anforderungen von der virtuellen Maschine Laravel Homestead erfüllt, daher wird dringend empfohlen, Homestead als Entwicklungsumgebung zu verwenden.
Wenn Sie Homestead nicht verwenden, stellen Sie bitte sicher, dass Ihr Server die folgenden Anforderungen erfüllt:
- PHP >= 7.1.3
- OpenSSL PHP-Erweiterung
- PDO PHP Erweiterung
- Mbstring PHP-Erweiterung
- Tokenizer PHP-Erweiterung
- XML PHP-Erweiterung
- Ctype PHP-Erweiterung
- JSON PHP-Erweiterung
- BCMath PHP Erweitern
Laravel installieren
Laravel verwendet Composer, um Projektabhängigkeiten zu verwalten. Stellen Sie daher vor der Verwendung von Laravel sicher, dass Composer auf Ihrem Computer installiert ist.
Über Laravel Installer
Installieren Sie zunächst Laravel Installer mit Composer:
composer global require laravel/installer
Stellen Sie sicher, dass Sie das systemweite Vendor-Bin-Verzeichnis von Composer in in ablegen Ihre Systemumgebungsvariable $PATH
, damit das System die ausführbare Datei von Laravel finden kann. Dieses Verzeichnis ist je nach Betriebssystem an verschiedenen Orten vorhanden; einige gängige Konfigurationen sind:
- macOS:
$HOME/.composer/vendor/bin
- GNU/Linux-Distributionen:
$HOME/.config/composer/vendor/bin
- Windows:
%USERPROFILE%AppDataRoamingComposervendorbin
Nachdem die Installation abgeschlossen ist, erstellt der Befehl laravel new
ein neues Laravel-Projekt in dem von Ihnen angegebenen Verzeichnis. Beispielsweise erstellt laravel new blog
ein Verzeichnis mit dem Namen blog
, in dem alle Laravel-Abhängigkeiten installiert sind:
laravel new blog
Erstellen Sie das Projekt über Composer
Alternativ können Sie es auch ausführen den Befehl create-project
im Terminal zur Installation Laravel:
composer create-project --prefer-dist laravel/laravel blog
Lokale Entwicklungsumgebung
Wenn Sie PHP lokal installiert haben und den integrierten PHP-Server zum Bereitstellen Ihrer Anwendung verwenden möchten, können Sie die verwenden Handwerkerbefehl serve
. Dieser Befehl startet den Entwicklungsserver auf http://localhost:8000
:
php artisan serve
Natürlich ist es besser, Homestead und Valet zu wählen.
Konfiguration
Öffentlicher Pfad
Nach der Installation von Laravel, You sollte das Dokumentationsverzeichnis Ihres Webdienstes so konfigurieren, dass es auf den Pfad public
verweist. Die index.php
-Datei in diesem Pfad dient als Front-End-Controller für alle HTTP-Anfragen, die in die Anwendung eingehen.
Konfigurationsdateien
Alle Konfigurationsdateien des Laravel-Frameworks werden im Verzeichnis config
gespeichert. Jede Option ist dokumentiert, sodass Sie die Datei leicht durchsehen und sich mit den Optionen vertraut machen können, die für Sie nützlich sein könnten.
Verzeichnisberechtigungen
Nach der Installation von Laravel müssen Sie möglicherweise einige Berechtigungen konfigurieren. Die Verzeichnisse storage
und bootstrap/cache
sollten unter Ihrem Webdienst beschreibbar sein, sonst läuft Laravel nicht. Wenn Sie eine virtuelle Homestead-Maschine verwenden, sollten diese Berechtigungen bereits festgelegt sein.
Anwendungsschlüssel
Der nächste Schritt nach der Installation von Laravel besteht darin, Ihren Anwendungsschlüssel auf eine zufällige Zeichenfolge festzulegen. Wenn Sie über composer
oder den Laravel-Installer installiert haben, wurde dieser Schlüssel bereits über den Befehl php artisan key:generate
für Sie festgelegt.
Normalerweise sollte diese Zeichenfolge 32 Zeichen lang sein. Dieser Schlüssel wird in der Umgebungsvariablendatei .env
festgelegt. Wenn Sie die .env.example
-Datei nicht in eine .env
-Datei umbenannt haben, müssen Sie die .env.example
-Datei in eine .env
-Datei umbenennen. Wenn der Anwendungsschlüssel nicht festgelegt wurde, sind Ihre Benutzersitzungen und andere verschlüsselte Daten nicht sicher!
Andere Konfigurationen
Laravel benötigt außer den oben genannten kaum eine andere Konfiguration. Sie können mit der Entwicklung beginnen, wie Sie möchten! Möglicherweise möchten Sie sich jedoch noch einmal die Datei config/app.php
und ihre Kommentare ansehen. Es enthält einige Optionen, die Sie je nach Anwendung möglicherweise ändern möchten, wie zum Beispiel: timezone
und locale
.
Vielleicht möchten Sie auch Laravel konfigurieren Einige andere Komponenten, wie zum Beispiel:
- Cache
- Datenbank
- Sitzungssteuerung
Web Serverkonfiguration
Elegante Links
Apache
in Laravel enthalten Eine public/.htaccess
-Datei wird häufig zum Verstecken in Ressourcenpfaden verwendet index.php
s Front-Controller. Bevor Sie Laravel mit Apache bereitstellen, stellen Sie sicher, dass das mod_write
-Modul aktiviert ist, damit .htaccess
-Dateien vom Server analysiert werden können.
Wenn die mit Laravel gelieferte .htaccess
-Datei nicht funktioniert, versuchen Sie die folgende Alternative:
Options +FollowSymLinks -Indexes RewriteEngine On RewriteCond %{HTTP:Authorization} .RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME} !-f RewriteRule ^ index.php [L]
Nginx
Wenn Sie Nginx verwenden, fügen Sie die folgende Konfiguration zu Ihrer Site-Konfiguration hinzu und alle Anfragen werden an den index.php
Front-End-Controller weitergeleitet.
location / { try_files $uri $uri/ /index.php?$query_string;}
Wenn Sie Homestead oder Valet verwenden, werden elegante Links automatisch konfiguriert.