01
Vor dem Start: Welche PHP-Version braucht Ihre Laravel-Version?
In der Datei composer.json Ihres Projekts zeigen die Zeilen php und laravel/framework, welche PHP-Version Sie benötigen. Die Support-Tabelle aus den offiziellen Release Notes von Laravel finden Sie unten.
Die PHP-Version wählen Sie in cPanel bis 8.5; Laravel 12 und 13 laufen in diesem Bereich. Wenn Sie eine Version nutzen, deren Support ausgelaufen ist, planen Sie das Upgrade.
- Laravel 13 (März 2026): PHP 8.3 – 8.5, Sicherheitsupdates bis 17. März 2028
- Laravel 12 (Februar 2025): PHP 8.2 – 8.5, Bugfixes endeten im August 2026, Sicherheitsupdates bis 24. Februar 2027
- Laravel 11: PHP 8.2 – 8.4, Support endete am 12. März 2026
- Laravel 10: PHP 8.1 – 8.3, Support beendet
02
Kommandozeile: cPanel-Terminal und erste Prüfungen
In den Entwickler-Paketen (HAN-DEV-1…4) ist der Shell-Zugang aktiviert. Die Befehle composer, php artisan und git aus diesem Ratgeber führen Sie im Bereich „Terminal“ von cPanel direkt im Browser aus. Wenn Sie von Ihrem eigenen Computer aus eine direkte SSH-Verbindung herstellen möchten, fragen Sie das Support-Team.
Die Terminal-Sitzung läuft in einem CloudLinux-CageFS-Käfig: Sie sehen keine Dateien anderer Konten und haben weder Root- noch sudo-Rechte. Für Projekte, die Systempakete benötigen, ist ein VDS-Server besser geeignet.
Führen Sie zuerst php -v aus: Das PHP auf der Kommandozeile muss dieselbe Version haben, die Sie für das Web gewählt haben, denn Composer prüft die Paketkompatibilität anhand dieser Version. Weicht sie ab, fragen Sie das Support-Team.
03
Projekt auf den Server bringen: Git oder Datei-Upload
Legen Sie das Projekt nicht in public_html, sondern in einen eigenen Ordner in Ihrem Home-Verzeichnis; so sind .env und Quellcode im Browser nicht erreichbar.
Git ist in den Paketen vorinstalliert; im Terminal holen Sie das Repository mit git clone in diesen Ordner (für private Repositorys benötigen Sie einen Zugriffsschlüssel oder ein Token Ihres Repository-Anbieters). Wenn Sie kein Git nutzen, laden Sie das Projekt als ZIP-Datei in den „File Manager“ (Dateimanager) von cPanel hoch und entpacken es dort.
Laden Sie die Ordner vendor und node_modules nicht hoch. Die Vite-Ausgabe public/build steht in der Standard-.gitignore von Laravel und kommt daher nicht mit dem Repository; führen Sie npm run build auf Ihrem eigenen Computer aus und laden Sie diesen Ordner separat hoch.
04
Hosting mit Composer: Abhängigkeiten auf dem Server installieren
In den Entwickler-Paketen ist Composer 2 installiert. Wechseln Sie im Terminal in den Projektordner und führen Sie composer install --no-dev --optimize-autoloader aus: --no-dev lässt Test- und Debugging-Pakete weg, --optimize-autoloader erstellt die Classmap im Voraus.
Dieser Befehl installiert exakt die Versionen aus der Datei composer.lock. Führen Sie auf dem Server kein composer update aus; aktualisieren Sie auf Ihrem eigenen Computer und laden Sie die Lock-Datei hoch. Bricht die Installation wegen einer Erweiterung oder Version ab, zeigt composer check-platform-reqs die fehlende Anforderung.
Laut offizieller Laravel-Dokumentation erforderliche PHP-Erweiterungen: Ctype, cURL, DOM, Fileinfo, Filter, Hash, Mbstring, OpenSSL, PCRE, PDO, Session, Tokenizer, XML. Falls eine davon fehlt, melden Sie es dem Support-Team.
05
.env-Datei, APP_KEY und Datenbankeinstellungen
Legen Sie in cPanel im Bereich „MySQL Databases“ eine Datenbank und einen Benutzer an und fügen Sie den Benutzer mit allen Rechten zur Datenbank hinzu. cPanel stellt den Namen meist Ihren Kontonamen voran (z. B. benutzer_laravel); tragen Sie in die Datei .env diesen vollständigen Namen ein.
Erstellen Sie die Datei mit cp .env.example .env; ist APP_KEY leer, erzeugen Sie ihn mit php artisan key:generate. Erzeugen Sie den Schlüssel bei einer Anwendung im Live-Betrieb nicht neu: Verschlüsselte Daten lassen sich dann nicht mehr entschlüsseln, und Sitzungen gehen verloren. Diese Zeilen sollten Sie prüfen:
APP_ENV=production und APP_DEBUG=false: Fehlerdetails werden Besuchern nicht angezeigtAPP_URL: die Adresse der Website, beginnend mit httpsDB_CONNECTION=mysql: Ab Laravel 11 werden neue Projekte mit SQLite ausgeliefertDB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD: die Daten, die Sie in cPanel angelegt haben
06
Artisan-Befehle: migrate, storage:link und Caches
php artisan migrate --force legt die Tabellen an; im Produktivbetrieb verlangt Laravel eine Bestätigung, --force überspringt sie. Ab Laravel 11 werden in diesem Schritt auch die Standardtabellen für Sitzungen, Cache und Queue angelegt.
Wenn Sie hochgeladene Dateien auf der Disk public speichern, legen Sie mit php artisan storage:link die Verknüpfung public/storage an.
Führen Sie anschließend php artisan optimize aus; der Befehl erstellt die Caches für Konfiguration, Routen, Events und Views (config:cache, route:cache, event:cache, view:cache) in einem Schritt. Nach dem Caching wird .env nicht mehr gelesen: Wenn Sie einen Wert ändern, führen Sie den Befehl erneut aus, und verwenden Sie env()-Aufrufe nur in den config-Dateien.
07
Laravel in cPanel einrichten: Document Root auf den public-Ordner setzen
Laut der offiziellen Deployment-Dokumentation von Laravel müssen alle Anfragen an die Datei public/index.php gehen; wird das Projektverzeichnis öffentlich zugänglich gemacht, sind sensible Dateien im Internet sichtbar. Die Umleitungsregeln in public/.htaccess liest auch LiteSpeed; löschen Sie diese Datei nicht.
Die gängigen Methoden in cPanel finden Sie unten; wenn Sie nicht sicher sind, welche zu Ihrem Konto passt, fragen Sie das Support-Team.
- Addon-Domain oder Subdomain: Tragen Sie beim Hinzufügen der Domain im cPanel-Bereich „Domains“ als Dokumentstammverzeichnis (Document Root)
anwendung/public ein. - Hauptdomain (public_html): Sichern Sie den Ordner
public_html und ersetzen Sie ihn durch einen auf den Ordner public des Projekts zeigenden symbolischen Link (ln -s), oder kopieren Sie den Inhalt von public nach public_html und passen Sie in index.php die Pfade __DIR__.'/../' an den Projektordner an. - Legen Sie nicht das gesamte Projekt in
public_html, um es dann per .htaccess umzuleiten; wird eine Regel übersehen, kann .env offengelegt werden.
08
Berechtigungen für storage und bootstrap/cache
Laravel schreibt in die Ordner storage (Logs, Sitzungen, Cache, Uploads) und bootstrap/cache. Da PHP im Shared Hosting in der Regel mit dem Benutzer Ihres Kontos läuft, reichen meist die Rechte 755 für Ordner und 644 für Dateien; vergeben Sie nicht 777.
Sehen Sie „Permission denied“ oder eine leere Seite, lesen Sie zuerst die Datei storage/logs/laravel.log; verursachen alte Caches Probleme, leert php artisan optimize:clear sie alle.
09
Geplante Aufgaben: schedule:run über die „Cron Jobs“ in cPanel
Für den Scheduler genügt eine einzige Cron-Zeile; die Aufgaben werden ab Laravel 11 in routes/console.php definiert, davor in app/Console/Kernel.php. Wählen Sie in cPanel im Bereich „Cron Jobs“ als Häufigkeit „Once Per Minute“ und tragen Sie im Befehlsfeld Folgendes ein:
cd /home/benutzer/anwendung && php artisan schedule:run >> /dev/null 2>&1
Stellen Sie sicher, dass die PHP-Version im Cronjob der Ihres Projekts entspricht; um Fehler zu sehen, können Sie die Ausgabe in eine Datei umleiten. Bei Aufgaben im Sekundentakt bleibt schedule:run bis zum Ende der Minute aktiv und verbraucht einen Teil der Paketlimits; bevorzugen Sie im Hosting Aufgaben, die minütlich oder seltener laufen.
10
Laravel-Queue-Jobs: Was ist im Hosting möglich, wo liegt die Grenze?
Die offizielle Queue-Dokumentation von Laravel empfiehlt einen Prozessmanager wie Supervisor, um den Prozess queue:work am Laufen zu halten. Im Shared Hosting werden dauerhaft laufende Hintergrundprozesse nicht unterstützt; einen permanenten Queue-Worker können Sie nicht betreiben.
Für kurze, seltene Jobs gibt es zwei Wege. Mit QUEUE_CONNECTION=sync laufen Jobs sofort während der Anfrage. Oder Sie fügen der Datei routes/console.php die Zeile Schedule::command('queue:work --stop-when-empty')->everyMinute()->withoutOverlapping(); hinzu: Der Worker arbeitet die wartenden Jobs ab, beendet sich und startet in der nächsten Minute neu.
So lassen sich Benachrichtigungs-E-Mails oder kleine Berichte abwickeln. Für stark ausgelastete Queues und dauerhaft laufende Komponenten wie Horizon, Reverb oder Octane wechseln Sie auf einen VDS-Server mit Root-Zugriff und verwalten die Worker mit Supervisor.
11
Welches Entwickler-Paket, und wann ein Upgrade?
Die Werte in der Tabelle sind die Limits auf dem Server. Für eine einzelne Anwendung ist HAN-DEV-1 (2 GB RAM, 200 % CPU-Limit, 5 Datenbanken) ein Einstieg; für mehrere Projekte sehen Sie sich HAN-DEV-2 oder HAN-DEV-3 mit mehr Addon-Domains an. Cronjobs und Queue-Jobs teilen sich dasselbe Limit mit den Web-Anfragen.
Reichen die Ressourcen nicht, wechseln Sie im Kundenbereich zu einem größeren Hosting-Paket; die Differenz wird in Rechnung gestellt, ein Wechsel zurück in ein kleineres Paket ist nicht möglich. Ihre Website bei einem anderen Anbieter können Sie über das Formular für den kostenlosen Hosting-Umzug zu uns holen.
Die Pakete umfassen LiteSpeed, CloudLinux, Imunify360 und kostenloses SSL (Einzelheiten: Linux-Hosting). Die Konten werden jede Nacht gesichert, und die Backups der letzten 3 Tage werden aufbewahrt. Das ist ein Komfortangebot; bewahren Sie Ihren Datenbank-Dump und Ihre .env-Datei auch in Ihrem eigenen Speicher auf, etwa in einem Cloud-Backup.