Native lokale Entwicklung

Dieses Dokument beschreibt den unterstützten lokalen Entwicklungspfad für WebBlocks CMS mit lokal installiertem PHP, Composer, Nginx, MySQL oder MariaDB und Redis. Container-basiertes lokales Tooling ist nicht mehr Teil des Projekt-Workflows.

Lokale URL

Verwenden Sie für Browser-Workflows vertrauenswürdiges HTTPS und .test-Domains.

  • CMS-URL: https://webblocks-cms.test
  • Admin: https://webblocks-cms.test/webadmin
  • Installer: https://webblocks-cms.test/install

php artisan serve ist für schnelle CLI- oder Routenprüfungen weiterhin nützlich, aber das normale Browser-Ziel sollte das oben beschriebene vertrauenswürdige Nginx/PHP-FPM-Setup sein.

Bereitschaftsprüfung

Führen Sie aus:

composer native:doctor

Der Doctor-Befehl prüft die lokale Laufzeitbereitschaft, ohne Dienste zu installieren oder lokale Dateien zu ändern.

Nützliche manuelle Prüfungen:

php -v
composer --version
nginx -t
mysql --version
redis-cli ping

Bei Homebrew-Installationen auf Apple Silicon liegen Dienstdateien und Logs üblicherweise unter /opt/homebrew. Bei Intel-Homebrew-Installationen liegen sie üblicherweise unter /usr/local.

Neuinstallation

composer install
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan db:seed
php artisan storage:link

Öffnen Sie https://webblocks-cms.test/install für den Browser-Assistenten, wenn die Installation noch nicht abgeschlossen ist.

Umgebung

Typische native lokale Werte:

APP_ENV=local
APP_URL=https://webblocks-cms.test
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=webblocks_cms
DB_USERNAME=webblocks_cms
DB_PASSWORD=
CACHE_STORE=database
SESSION_DRIVER=database
QUEUE_CONNECTION=sync
CMS_BACKUP_EXECUTION=auto

Verwenden Sie für die CMS-Installation eine separate lokale Datenbank und einen separaten Benutzer. Wenn auf Ihrem Rechner bereits eine belegte MySQL-/MariaDB-Instanz läuft, verwenden Sie einen separaten Port und passende .env-Werte.

Backups und Wiederherstellungen

Backup- und Wiederherstellungsbefehle verwenden im nativen Modus lokale Datenbank-CLIs:

  • MySQL-/MariaDB-Backups erfordern mysqldump oder mariadb-dump.
  • MySQL-/MariaDB-Wiederherstellungen erfordern mysql oder mariadb.
  • SQLite-Backups und -Wiederherstellungen verwenden PHP-/PDO-Pfade.

CMS_BACKUP_EXECUTION=auto und CMS_BACKUP_EXECUTION=direct führen für MySQL/MariaDB beide zu direkter lokaler CLI-Ausführung. Das Projekt benötigt für Backup oder Wiederherstellung keinen Container-Befehl.

Smoke-Check

Führen Sie nach Dienst-Neustarts, Wiederherstellungen oder Umgebungsänderungen aus:

composer native:smoke

Für gezielte Tests:

php artisan test --filter=PluginCatalogBrowserTest
composer test:release-fast
composer format:changed

Fehlerbehebung

Wenn der Browser die falsche Site erreicht, bestätigen Sie, dass der Nginx-Serverblock webblocks-cms.test besitzt, dass das Zertifikat vertrauenswürdig ist und dass /etc/hosts die Domain auf 127.0.0.1 verweist.

Wenn Datenbankbefehle fehlschlagen, bestätigen Sie DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME und DB_PASSWORD in .env und führen Sie dann aus:

php artisan config:clear
php artisan migrate:status

Wenn Redis-gestützte Funktionen fehlschlagen, bestätigen Sie, dass der lokale Redis-Dienst läuft:

redis-cli ping