Skip to content

Commit

Permalink
Laragon-Tutorial (#392)
Browse files Browse the repository at this point in the history
Kann es nicht bewerten oder testen, sieht aber stimmig aus und merge
Einrichtung einer kleinen lokalen Entwicklungsumgebung in Windows mit Anpassungen an REDAXO (SSL, Cronjob).
  • Loading branch information
alxndr-w authored Jan 18, 2025
1 parent 85ee200 commit a4d23df
Showing 1 changed file with 86 additions and 0 deletions.
86 changes: 86 additions & 0 deletions _docs/development/laragon.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,86 @@
# REDAXO CMS + Laragon = 🦖💚

Laragon ist eine Alternative zu XAMPP/MAMP unter Windows, um eine lokale Entwicklungsumgebung für PHP-Projekte zu erstellen.

In diesem Tutorial zeigen wir, wie du Laragon einrichtest und REDAXO CMS unter Laragon installierst.

## Vorteile

✅ Kinderleichte Installation
✅ Automatische Einrichtung der Windows .hosts-Datei und Hosts-Konfiguration in Apache
✅ Automatische SSL-Aktivierung (lokale SSL-Nutzung)
✅ Leichter Wechsel und Update der PHP-Version
✅ Serverseitige Crons mit Cronical
✅ Zuverlässiger Betrieb

Wer in XAMPP damit zu kämpfen hat, PHP zu updaten, die MySQL-Datei reparieren zu müssen und Performance-Probleme hatte, sowie lokales SSL benötigt hätte, wird in Laragon Frieden finden. :)

## Voraussetzungen

* Windows 10ff
* Laragon >=6.0

> Hinweis: Laragon bis einschließlich Version 6 war kostenlos. Ab Version 7 gibt es eine kostenpflichtige Pro-Version. Die kostenlose Version reicht für die meisten Anwendungsfälle aus, benötigt jedoch Anpassungen, um einen Aktuellen AMP-Stack (Apache, MySQL, PHP) zu benutzen.
## Installation und Einrichtung

Nach dem [Laragon herunterladen](https://github.com/leokhoa/laragon/) und installiert ist, starte Laragon und führe folgende empfohlene Konfiguration durch:

### Einstellungen (Allgemein)

Starte Laragon automatisch mit Windows.

![image](https://github.com/user-attachments/assets/21a5b0a9-5502-4f17-829f-23262a0ee48b)

### Einstellugnen (Dienste)

Aktiviere SSL

![image](https://github.com/user-attachments/assets/46768b67-31d5-4d14-8f36-b06659e15ace)

### SSL lokal einrichten

Menü > Apache > SSL > Add Laragon to Trust Store

![image](https://github.com/user-attachments/assets/713fa18c-ebc7-4ec1-894e-1c976fa6ef9c)

### Cronical - serverseitige Cronjobs

Menü > Tools > Cron > cron.dat öffnen

![image](https://github.com/user-attachments/assets/9dcd0381-3347-41e6-8017-cdcf1388c29c)

So legst du einen Cron für REDAXO an, der jede Minute REDAXO Cronjobs triggert:

```
* * * * * C:\laragon\bin\php\php-8.3.7-Win32-vs16-x64\php.exe C:\laragon\www\example.org\bin\console cronjob:run
```

### REDAXO mit einem Klick installieren - Einrichtung

Menü > Neue Website erstellen > Konfiguration

![image](https://github.com/user-attachments/assets/6656d9d7-f718-436f-bb99-e468385ed206)

In der Textdatei folgende Zeile hinzufügen:

```
# REDAXO
REDAXO=https://redaxo.org/download/redaxo/5.18.1.zip
```

Im Dialog dann das gewünschte Projekt angeben, empfohlen ist die Domain, z.B. `example.org` - anschließend ist das Projekt unter `https://example.org.test/` erreichbar.

## PHP und andere Komponenten updaten

Variante 1: Tools > Quick Add > gewünschte PHP-Version auswählen.
Variante 2: Siehe [Laragon Wiki](https://github.com/leokhoa/laragon/wiki)

![image](https://github.com/user-attachments/assets/735d5ff6-da88-4c86-9626-10bf3d68c617)


## Abschließende Worte

Es spricht aktuell nichts dagegen, die kostenlose Variante von Laragon (Laragon 6) zu verwenden, dabei müssen die Komponenten (PHP, MySQL, Apache) jedoch manuell geupdatet werden.

Die FriendsOfREDAXO-Community kann von einem Rabatt auf die Lifetime-Lizenz für Laragon 7 profitieren, dazu einfach [@alxndr-w](https://www.alexplus.de/) ansprechen.

0 comments on commit a4d23df

Please sign in to comment.