.env, Artisan et terminal
Modifier le fichier .env directement dans le navigateur sous Sites → .env. Utilisez Ctrl/Cmd+S pour enregistrer.
Installation du serveur frais
Le moyen recommandé pour bootstrap un nouveau serveur Herne est l'installateur unifié:
curl -fsSL https://raw.githubusercontent.com/fklavyenet/herne/main/install.sh | sudo bash
Il installe la pile de base, écrit l'environnement du panneau, crée le premier administrateur, installe les règles de sudoers, configure nginx et peut aussi installer la pile de courrier en option.
Éditeur .env
Allez dans Sites → .env pour modifier le fichier d'environnement de votre application directement dans le navigateur. L'éditeur lit et écrit {deploy_path}/.env.
- Enregistrez avec
Ctrl+S(ouCmd+Ssous macOS). - Le fichier est écrit de façon atomique et reçoit les permissions
640. - Cliquez sur Load from .env.example pour charger les valeurs du fichier d’exemple s’il existe.
- Cliquez sur Apply Redis defaults pour charger les réglages de cache, de session, de file d’attente et de connexion que Herne a préparés pour Redis.
Après avoir édité .env, exécutez optimize:clear ou reconstruisez les caches pertinents à partir du coureur Artisan afin que l'application lise les nouvelles valeurs.
Exécution des commandes Artisan
Exécutez n'importe quel php artisan command à partir de Sites → Artisan. Les métacaractères Shell sont dépouillés pour la sécurité. Allez à Sites → Artisan et tapez une commande sans le préfixe php artisan :
migrate --force
queue:restart
storage:link
key:generate
Les métacaractères Shell (&, |, ;, `, $(...), >, <) sont dépouillés pour assurer la sécurité.
La page est particulièrement utile pour les actions de suivi courantes telles que key:generate, storage:link, les migrations et les rebâtiments de cache après l'édition de .env.
Sécurité APP_KEY
Les applications Laravel ont besoin d'un APP_KEY non vide. L'installation rapide protège et génère dans le flux d'installation. Pour les applications déployées manuellement, exécutez:
key:generate
optimize:clear
Ne faites pas pivoter APP_KEY sur une application de production existante à moins que vous ne compreniez l'impact sur les cookies, les sessions et les données cryptées stockées.
Commande de migration de domaine canonique
Les administrateurs peuvent promouvoir un domaine de site temporaire vers le domaine de production réel avec la commande de migration canonique. Exécutez un essai à sec d'abord:
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --dry-run
Ne postuler qu'après avoir examiné le plan :
herne:sites:canonicalize-domain fklavye.webblocksui.com fklavye.net --www-alias --move-files --backup --force
La commande met à jour le domaine du site, l'alias, les métadonnées de l'application, l'environnement URL/nom, le chemin actif, le chemin de sauvegarde retiré et la configuration Nginx. Il ne doit pas laisser l'ancien domaine comme un alias ou server_name.
Terminal Web
Le Web Terminal (Sites → Terminal) exécute des commandes en tant qu'utilisateur isolé dans le répertoire de projets web_root du site. Allez à Sites → Terminal. Les commandes fonctionnent en tant qu'utilisateur de shell isolé (shell_domainslug) dans le répertoire de projets web_root du site.
Restrictions à la sécurité
Les redirections de sortie (>, >>), la substitution de commande ($(), les backticks) et la tuyauterie sont bloquées dans le terminal. Les éléments suivants sont bloqués :
- Redirection de sortie:
>,>> - Substitut de commande :
$(...), backticks - Tube :
|
Le terminal web impose un délai de 30 secondes par commande. Les commandes longues, comme un premier composer install, peuvent dépasser ce délai. Utilisez alors Déploiement avec l’étape Composer activée.
Registres des serveurs
Ouvrez Sites → Journaux → Journaux du serveur pour consulter les dernières sorties du serveur web pour ce site.
- Basculez entre les journaux d’accès Nginx, d’erreurs Nginx et de PHP-FPM.
- Les 200 lignes les plus récentes s’affichent en premier.
- Utilisez Actualiser pour recharger le fichier en cours.
- Utilisez Vider pour vider le fichier sélectionné si les permissions du serveur le permettent.
- L’onglet PHP-FPM est réservé aux administrateurs.