portal php reference

Gentics Portal | PHP - Referenz

Dieses Repository enthält beide, ein Beispiel Docker Compose Stack zum Erstellen eines neuen Projekts mit Gentics Portal | PHP, Gentics Mesh und Gentics CMS und eine leicht zu starten Demo -Anwendung mit den wichtigsten Merkmalen des Gentics -Portals | Php

Zweige

Zweig	Beschreibung	Dokumentation
NewProject	Zum Erstellen eines neuen neuen Projekts mit dem Gentics Portal PHP	Link
Demo	Demo -Referenzanwendung	Link

Anforderungen

• Git
• Docker - Neueste Version
• Docker Compose - Neueste Version
• PHP - 8.1 (> = 8.1.7)
• Komponist V2

Wichtig: Bei der Verwendung von Windows müssen Sie Ihren Git -Client so konfigurieren, dass sie die Zeilenende nicht in Windows -Zeilenende konvertieren, bevor Sie dieses Git -Repository klonen.

 git config --global core.autocrlf input

Lesen Sie den Abschnitt "Installieren der Anforderungen" für genauere Details zur Installation und Konfiguration der erforderlichen Tools. Wenn Sie auf Fehler stoßen, finden Sie hier möglicherweise eine Lösung auf dieser Seite.

Authentifizierung für repo.apa-it.at

Wenden Sie sich an Gentics, wenn Sie Ihre Anmeldeinformationen für repo.apa-it.at noch nicht erhalten haben.

Öffnen Sie die Composer -Datei auth.json. Sie können auch %USERPROFILE%AppDataRoamingComposerauth.json oder ~/.composer/auth.json stattdessen bearbeiten.

composer config --global --auth --editor

Stellen Sie sicher, dass Ihr Auth.json die folgende Konfiguration enthält:

 {
    "http-basic": {
        "repo.apa-it.at": {
            "username": "MYUSERNAME",
            "password": "MYPASSWORD"
        }
    }
}

Ersetzen Sie MYUSERNAME und MYPASSWORD . Verwenden Sie die API -Taste als Kennwort, das auf der Seite "Artefactory Profile" generiert/abgerufen werden kann.

Melden Sie sich in die Docker -Registrierung an und verwenden Sie dieselben Anmeldeinformationen wie oben:

 docker login repo.apa-it.at

Die Demo laufen

Siehe: https://github.com/gentics/portal-php-reference/blob/demo/readme.demo.md

Erstellen eines neuen Laravel -Projekts mit Gentics Portal | Php

Dadurch wird erläutert, wie ein Basic Laravel-Projekt mit dem Portal-Php-Paket eingerichtet wird.

Erstellen Sie ein neues Laravel -Projekt mit Gentics Portal | Php

composer create-project gentics/portal-php-laravel-project portal --repository-url " https://repo.apa-it.at/api/composer/php "

Dies fügt das Repository "Gentics" zu Ihrem Projekt Composer.json hinzu, zieht die Abhängigkeiten an und kopiert einige Standarddateien aus dem Portal-Php-Paket.

.htaccess

Postanfragen vom CMS an den CMSController funktionieren nicht standardmäßig, da die Lagerbestände Laravel .htaccess alle Anfragen, die einen nachgezogenen Schrägstrich haben, um ihn zu entfernen, umleitet. Doch aufgrund des RFC -Standards, der nach dem Umleitungsumleitungen ohne Benutzerinteraktion nicht ausreicht, bedeutet dies, dass die Postdaten verloren gehen.

Wir können dies leicht beheben, in portal/public/.htaccess Finden Sie diese Zeile (Zeile 12):

 # Redirect Trailing Slashes If Not A Folder...

Fügen Sie dies nach: nach:

 RewriteCond %{REQUEST_METHOD} =GET

Docker -Dienstkonfiguration

Kopieren Sie die Datei docker-compose.override.yml.example in docker-compose.override.yml Sie können Kennwörter, Ports, Umgebungsvariablen und andere Einstellungen in docker-compose.override.yml konfigurieren. Der Lizenzschlüssel für das CMS muss geändert werden.

Ausführen des Portals

docker-compose.override.yml.example to docker-compose.override.yml

Sie können Kennwörter, Ports, Umgebungsvariablen und andere Einstellungen in docker-compose.override.yml konfigurieren. Der Lizenzschlüssel für das CMS muss geändert werden.

Kopieren Sie portal/.env.example in portal/.env

Diese Datei enthält die Umgebungseinstellungen für das Laravel -Framework.

Laufen:

docker-compose up -d

• Sie können den Containerstatus mit docker-compose ps anzeigen
• Verwenden Sie, um die Protokolle eines bestimmten Containers anzuzeigen, docker-compose logs -f name . EG: docker-compose logs -f portal
• Sie können diese Seite hier lesen, wenn Sie auf Probleme stoßen.

Deaktivieren Sie die automatische Mesh -API -Schlüsselgeneration

Setzen Sie die Umgebungsvariable AUTOGENERATE_MESH_API_KEY für das Portal auf False.

Öffnen Sie das Referenzprojekt im Browser

Portalanwendung

http: // localhost: 8080 - Wenn Sie nach Authentifizierung gefragt werden, registrieren Sie ein neues Konto (KeyCloak).

Netz

http: // localhost: 8081 - Verwenden Sie Admin Administrator als Anmeldung

CMS

http: // localhost: 8082 - Verwenden Sie den Knotenknoten als Anmeldung

Servicedokumentation:

• Netz
• Elasticsarch
• CMS
• db

Howto

Installation der Anforderungen

Git

Fenster

Installieren Sie den GIT-Client unter https://git-scm.com/downloads

Stellen Sie sicher, dass Sie "Checkout As-is, Commit Unix-Stil" aktivieren, wenn der Installateur Sie fragt.

Linux / Mac

Installieren Sie das Paket "Git" mit dem Paketmanager.

Docker

Mindesthardwareanforderungen:

• CPU: x86, 2 Kerne
• Speicher: 8 GB RAM
• Festplatte: 15 GB Freiraum

Windows / Mac

• Verwenden Sie Docker mit WSL2, falls verfügbar
• Wir empfehlen, den Speicher auf mindestens 6 GB zu erhöhen und die verfügbare CPU mindestens 2 Kerne in den Docker -Einstellungen einzustellen

Php

Überprüfen Sie, ob PHP 8.1.7 oder höher bereits durch Ausführen von php -version installiert ist

Wenn Ihr Betriebssystem über einen Paket-Manager mit PHP 8.1.7 oder höher verfügt, installieren Sie das Paket und laden Sie PHP von https://windows.php.net/download#php-8.1 (PHP 8.1 "VS16 X64 Non Thread Safe" für Windows) herunter.

Aufbau der Dockerfile

Wenn Sie portal-files vornehmen

docker-compose build