portal php reference

Gentics Portal | php - référence

Ce référentiel contient les deux, un exemple de pile Docker Compose pour créer un nouveau projet avec Gentics Portal | PHP, Gentics Mesh et Gentics CMS et une application de démonstration facile à démarrer montrant les fonctionnalités les plus importantes du portail Gentics | php

Branches

Bifurquer	Description	Documentation
newproject	Pour créer un nouveau projet frais avec Gentics Portal PHP	Lien
démo	Application de référence de démonstration	Lien

Exigences

• Git
• Docker - Dernière version
• Docker Compose - Dernière version
• PHP - 8.1 (> = 8.1.7)
• Compositeur v2

IMPORTANT: Lorsque vous utilisez Windows, vous devez configurer votre client GIT pour ne pas convertir les terminaisons de ligne en fins de ligne Windows avant de cloner ce référentiel GIT.

 git config --global core.autocrlf input

Lisez la section «Installation des exigences» pour plus de détails sur la façon d'installer et de configurer les outils requis. Si vous rencontrez des erreurs, vous trouvez peut-être une solution sur cette page ici.

Authentification pour repo.apa-it.at

Contactez Gentics si vous n'avez pas encore reçu vos informations d'identification pour repo.apa-it.at.

Ouvrez le fichier compositeur auth.json. Vous pouvez également modifier %USERPROFILE%AppDataRoamingComposerauth.json ou ~/.composer/auth.json à la place.

composer config --global --auth --editor

Assurez-vous que votre auth.json contient la configuration suivante:

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

Remplacez MYUSERNAME et MYPASSWORD . Utilisez la touche API comme mot de passe, qui peut être généré / récupéré dans la page de profil d'artefactoire.

Connectez-vous au registre Docker et utilisez les mêmes informations d'identification comme ci-dessus:

 docker login repo.apa-it.at

Exécuter la démo

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

Création d'un nouveau projet Laravel avec Gentics Portal | php

Cela explique comment configurer un projet Laravel de base avec le package Portal-PHP.

Créez un nouveau projet Laravel avec Gentics Portal | php

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

Cela ajoute le référentiel "Gentics" à vos projets Composer.json, tire les dépendances et copie certains fichiers par défaut du package portail-php.

.htaccess

Les demandes de publication du CMS vers le CMSController ne fonctionnent pas par défaut car le stock Laravel .htaccess redirige toutes les demandes qui ont une barre oblique pour le retirer. Cependant, dû à la norme RFC qui interdit les redirections post-interaction, cela signifie que les données de poste sont perdues.

Nous pouvons résoudre ce problème facilement, dans portal/public/.htaccess trouver cette ligne (ligne 12):

 # Redirect Trailing Slashes If Not A Folder...

Ajoutez ceci après:

 RewriteCond %{REQUEST_METHOD} =GET

Configuration du service Docker

Copiez le fichier docker-compose.override.yml.example sur docker-compose.override.yml Vous pouvez configurer des mots de passe, des ports, des variables d'environnement et d'autres paramètres in docker-compose.override.yml La clé de licence pour le CMS doit être modifiée.

Exécution du portail

Copier docker-compose.override.yml.example à docker-compose.override.yml

Vous pouvez configurer des mots de passe, des ports, des variables d'environnement et d'autres paramètres in docker-compose.override.yml La clé de licence pour le CMS doit être modifiée.

Copier portal/.env.example sur portal/.env

Ce fichier contient les paramètres d'environnement du framework Laravel.

Courir:

docker-compose up -d

• Vous pouvez afficher l'état du conteneur avec docker-compose ps
• Pour afficher les journaux d'un conteneur spécifique, utilisez docker-compose logs -f name . Par exemple: docker-compose logs -f portal
• Vous pouvez lire cette page ici si vous rencontrez des problèmes.

Désactiver la génération de clés API à maillage automatique

Définissez la variable d'environnement AUTOGENERATE_MESH_API_KEY sur FALSE pour le portail.

Ouvrez le projet de référence dans le navigateur

Application de portail

http: // localhost: 8080 - Si vous demandez l'authentification, enregistrez un nouveau compte (Keycloak)

Engrener

http: // localhost: 8081 - Utilisez l'administrateur admin comme connexion

CMS

http: // localhost: 8082 - Utilisez le nœud de nœud comme connexion

Documentation du service:

• engrener
• Elasticsearch
• CMS
• db

Howto

Installation des exigences

Git

Fenêtre

Installez le client git à partir de https://git-scm.com/downloads

Assurez-vous d'activer "la caisse en tant que celle du style UNIX" lorsque l'installateur vous demande.

Linux / Mac

Installez le package "Git" avec le gestionnaire de paquets.

Docker

Exigences matérielles minimales:

• CPU: x86, 2 cœurs
• Mémoire: 8 Go de RAM
• Disque: 15 Go d'espace libre

Windows / Mac

• Utilisez Docker avec WSL2 si disponible
• Nous vous recommandons d'augmenter la mémoire à au moins 6 Go et de définir le CPU disponible au moins 2 cœurs dans les paramètres Docker

Php

Vérifiez si PHP 8.1.7 ou plus est déjà installé en exécutant php -version

Si votre système d'exploitation dispose d'un gestionnaire de paquets avec PHP 8.1.7 ou supérieur, installez le package, sinon téléchargez PHP à partir de https://windows.php.net/download#php-8.1 (PHP 8.1 "VS16 x64 Non Thread Safe" pour Windows).

Construire le dockerfile

Si vous effectuez des modifications, faites le dockerfile ou les fichiers dans portal-files , vous devez exécuter

docker-compose build