Administration système

Disponible dans :

• Post Affiliate Pro
• Post Affiliate Pro Ultimate
• Post Affiliate Network

Aperçu de l’administration système

Une administration système efficace est essentielle pour maintenir un programme d’affiliation haute performance. Post Affiliate Pro fournit des outils complets pour gérer les tâches planifiées, la mise en cache, la journalisation, l’optimisation de la base de données et la maintenance du système. Comprendre ces fonctionnalités aide à garantir que votre logiciel d’affiliation fonctionne de manière fluide et efficace.

Tâches planifiées et tâches cron

Comment fonctionnent les tâches cron

Post Affiliate Pro utilise un système de planification des tâches qui traite automatiquement les travaux en arrière-plan. Le point d’entrée principal est le script jobs.php, qui doit être appelé régulièrement par le démon cron de votre serveur.

L’exécuteur de tâches exécute les tâches en attente dans un délai configurable, s’exécutant généralement pendant la durée de l’intervalle cron moins un petit tampon. Les tâches qui ne peuvent pas être terminées en un cycle d’exécution sont automatiquement reprises lors de l’exécution suivante.

Configuration des tâches cron

Pour configurer les tâches cron pour votre installation :

1. Accédez à votre serveur via SSH ou le panneau de contrôle de votre hébergement
2. Ajoutez une entrée cron pour exécuter le script jobs :

* * * * * /usr/local/bin/php -q /chemin/vers/votre/installation/scripts/jobs.php

Cela exécute le processeur de tâches chaque minute, ce qui est la configuration recommandée. Le système calcule automatiquement la durée d’exécution de chaque cycle en fonction de votre intervalle cron configuré.

Options de configuration cron

Dans le panneau marchand sous Outils, vous pouvez configurer :

• Intervalle d’exécution cron - Fréquence d’exécution de votre tâche cron (par défaut : 1 minute)
• Nombre de jobs parallèles - Nombre de workers de tâches simultanés pour les installations à fort trafic

Le système surveille l’exécution cron et affiche un avertissement si les tâches n’ont pas été traitées récemment. Vous pouvez également déclencher manuellement l’exécution des tâches depuis le panneau d’administration à des fins de test.

Inclusion et exclusion de tâches

Pour les configurations avancées, vous pouvez exécuter des tâches spécifiques ou exclure certaines tâches :

php jobs.php --include TaskClassName1 TaskClassName2
php jobs.php --exclude TaskClassName1 TaskClassName2

C’est utile pour répartir la charge de travail sur plusieurs workers cron ou isoler des tâches problématiques.

Gestion du cache

Système de mise en cache

Post Affiliate Pro utilise Redis pour une mise en cache haute performance, ce qui améliore significativement les temps de réponse pour les données fréquemment consultées. Le système de mise en cache stocke :

• Les données de session utilisateur
• Les paramètres de configuration
• Les données des affiliés et campagnes pour le suivi
• Les associations visiteur-affilié

Configuration du cache

Les paramètres de cache sont définis dans le fichier de configuration de votre installation. Le système prend en charge :

• Hôtes Redis de cache - Adresses des serveurs Redis pour la mise en cache
• Hôtes Redis de suivi - Configuration Redis séparée pour les données de suivi
• Configuration des ports - Paramètres de port personnalisés pour les connexions Redis

Vidage du cache

Lors de modifications de configuration ou de résolution de problèmes, vous pouvez avoir besoin de vider les données en cache. Le système fournit des options pour :

• Vider des entrées de cache spécifiques
• Purger l’intégralité du cache
• Invalidation automatique du cache lors des changements de paramètres

Pour les caches liés au suivi comme les liens directs et les paramètres mod rewrite, videz le cache après avoir effectué des modifications de configuration pour vous assurer que les nouveaux paramètres prennent effet immédiatement.

Configuration de la journalisation de débogage

Niveaux de journalisation

Post Affiliate Pro fournit une journalisation configurable pour aider à diagnostiquer les problèmes. Les niveaux de journalisation disponibles incluent :

• Erreur (40) - Erreurs critiques uniquement (par défaut)
• Avertissement (30) - Erreurs et avertissements
• Info (20) - Messages d’information généraux
• Débogage (10) - Informations de débogage détaillées

Des niveaux de verbosité plus élevés génèrent plus d’entrées de journal, ce qui peut impacter les performances. Utilisez la journalisation de débogage uniquement lors du dépannage de problèmes spécifiques.

Mode débogage

Pour des diagnostics de suivi détaillés, vous pouvez activer le mode débogage qui journalise :

• Les détails du traitement des clics et impressions
• Les informations de suivi des ventes et prospects
• Les détails des requêtes API
• Les conditions d’erreur et leur contexte

Le mode débogage se désactive automatiquement après une heure pour éviter la dégradation des performances et la croissance des fichiers journaux. Le paramètre des types de débogage vous permet de spécifier quelles catégories d’événements journaliser (par ex., actions, bannières, erreurs).

Gestion du journal des événements

Le système nettoie automatiquement les anciennes entrées du journal des événements en fonction de votre configuration :

• Supprimer les événements après X jours - Supprimer les entrées de journal plus anciennes que le nombre de jours spécifié (par défaut : 7 jours)
• Nombre maximum d’enregistrements d’événements - Conserver uniquement le nombre spécifié d’enregistrements les plus récents (par défaut : 500 000)

Ces paramètres aident à maintenir les performances de la base de données tout en conservant suffisamment de données historiques pour le dépannage.

Nettoyage de l’historique de connexion

Les enregistrements d’historique de connexion sont automatiquement purgés après un nombre de jours configurable (par défaut : 30 jours). Cela aide à maintenir la taille de la base de données tout en préservant les informations d’audit de sécurité récentes.

Mode maintenance

Comprendre le mode maintenance

Le mode maintenance suspend temporairement les opérations normales de l’application pendant les mises à niveau ou la maintenance critique. Lorsqu’il est activé :

• Le traitement des tâches est mis en pause
• Les requêtes API retournent HTTP 503 (Service non disponible)
• Les utilisateurs voient une notification de maintenance
• Le suivi continue de mettre en file d’attente les données pour un traitement ultérieur

Points de terminaison exemptés

Certains points de terminaison restent accessibles pendant la maintenance :

• Points de terminaison de vérification de santé (/health, /health-check)
• Points de terminaison de documentation
• Spécification OpenAPI

Cela permet aux systèmes de surveillance de vérifier l’état de l’application même pendant les fenêtres de maintenance.

Maintenance automatique

Le système entre automatiquement en mode maintenance pendant :

• Les mises à niveau de version
• Les migrations de base de données
• La revalidation de licence

Une fois l’opération de maintenance terminée, le fonctionnement normal reprend automatiquement.

Statut et optimisation de la base de données

Plugin Statut de la base de données

Le plugin Statut de la base de données offre une visibilité sur la santé de votre base de données. Après activation, accédez à Outils > Statut de la base de données pour voir :

• Les noms et tailles des tables
• Le nombre de lignes pour chaque table
• Les informations sur les index
• Les détails du moteur de stockage

Opérations de base de données

Le plugin prend en charge plusieurs opérations de maintenance :

• Analyser la table - Met à jour les statistiques de table pour l’optimisation des requêtes
• Optimiser la table - Défragmente les tables et récupère l’espace inutilisé
• Réparer la table - Corrige les structures de tables corrompues

Exécutez ces opérations pendant les périodes de faible trafic car elles peuvent temporairement verrouiller les tables.

Exigences du plugin

Le plugin Statut de la base de données nécessite que votre utilisateur de base de données ait les privilèges SELECT sur la table système INFORMATION_SCHEMA.TABLES. Si l’activation échoue, vérifiez ces permissions avec votre administrateur de base de données.

Nettoyage automatique des données

Post Affiliate Pro gère automatiquement la rétention des données pour des performances optimales :

• Clics bruts - Supprimés après un nombre de jours configurable (par défaut : 185 jours)
• Visiteurs expirés - Nettoyés automatiquement
• Journaux de visites et de ventes - Supprimés après le nombre de jours spécifié (par défaut : 60 jours)
• Anciens enregistrements de courrier - Purgés après un nombre de mois configurable (par défaut : 2 mois)

Exigences système

Exigences PHP

• PHP 8.0 ou supérieur
• Extension PDO MySQL
• Bibliothèque GD (pour le captcha et le traitement d’images)
• Extension bcmath (pour les algorithmes de limitation de débit)
• Extension hash avec support SHA-256
• Standard PHP Library (SPL)
• Fonction filter_var activée
• Limite de mémoire minimale de 128 Mo

Fonctions PHP requises

Les fonctions suivantes doivent être activées :

• tempnam
• mkdir
• imagettftext
• imagejpeg
• base64_decode
• mime_content_type

Exigences MySQL

• MySQL 5.7 ou supérieur (MySQL 8.0 recommandé)
• Jeu de caractères utf8mb4
• Collation utf8mb4_unicode_ci
• Pilote PDO MySQL

Configuration des sessions

• session.auto_start doit être désactivé
• session.save_path doit être un chemin absolu (non relatif)

Système de fichiers

• Le répertoire de configuration doit être accessible en écriture par le serveur web
• Capacité de créer des fichiers et sous-répertoires dans le répertoire accounts

Réglage des performances

Traitement des visites

Optimisez le traitement des visites pour votre volume de trafic :

• Traitement hors ligne - Traitez les visites de manière asynchrone pour les sites à fort trafic
• Traitement des ventes en ligne - Activez pour un suivi immédiat des commissions
• Workers multi-processeurs - Configurez jusqu’à 8 workers parallèles pour les visites et impressions

Traitement des statistiques

Le processeur de statistiques de ventes consolide les données de transaction à intervalles configurables :

• Intervalle de traitement - Fréquence de recalcul des statistiques (par défaut : 15 minutes)
• Rétention des statistiques horaires - Jours de conservation des statistiques horaires détaillées
• Pour les impressions et clics : par défaut 365 jours
• Pour les ventes : par défaut 180 jours

Performances des grilles

Configurez les limites des grilles de données pour équilibrer utilisabilité et performances :

• Limite de lignes - Nombre maximum de lignes retournées dans les grilles (par défaut : 500)
• Limite d’export - Nombre maximum de lignes pour les exports CSV (par défaut : 500)
• Limite de conditions - Nombre maximum de conditions de filtre (par défaut : 1000)

Limitation des emails

Contrôlez les taux d’envoi d’emails pour éviter de surcharger les serveurs de messagerie :

• Emails affiliés par minute - Limite les emails en masse aux affiliés (par défaut : 30)
• Emails système par minute - Maximum de notifications automatisées (par défaut : 10)

Interruption des tâches

Configurez le comportement des tâches pour les opérations de longue durée :

• Temps de pause d’interruption - Pause entre les segments de tâches
• Temps d’exécution maximum de tâche - Timeout pour les tâches bloquées (15 minutes)

Les tâches enregistrent automatiquement leur progression, permettant une reprise transparente en cas d’interruption.

Considérations de sauvegarde

Que sauvegarder

Une sauvegarde complète inclut :

1. Base de données MySQL

   • Toutes les tables Post Affiliate Pro
   • Données utilisateurs, transactions et configurations
   • Informations sur les campagnes et bannières

2. Système de fichiers

   • Fichiers de configuration dans le répertoire accounts
   • Bannières téléchargées et supports promotionnels
   • Thèmes et modèles personnalisés
   • Configurations des plugins

Bonnes pratiques de sauvegarde

• Planifiez des sauvegardes automatisées régulières
• Stockez les sauvegardes dans un emplacement séparé de votre serveur
• Testez périodiquement la restauration des sauvegardes
• Documentez vos procédures de sauvegarde et de récupération
• Envisagez la récupération à un instant précis pour les installations critiques

Installations hébergées

Pour les installations Post Affiliate Pro hébergées, les sauvegardes sont gérées automatiquement par l’infrastructure d’hébergement. Contactez le support pour des demandes spécifiques de sauvegarde et de restauration.

Considérations de sécurité

Restrictions IP

Configurez les contrôles d’accès basés sur l’IP pour :

• Les connexions au panneau d’administration
• Les inscriptions d’affiliés
• L’accès API

Limitation de débit

Protégez-vous contre les abus avec des limites de débit configurables :

• Tentatives de connexion par nom d’utilisateur/IP (par défaut : 10 par heure)
• Tentatives d’inscription (par défaut : 10 par heure)
• Soumissions de formulaire de contact (par défaut : 10 par heure)

Sécurité des sessions

• Les sessions expirent après un timeout configurable
• Les anciennes sessions sont automatiquement nettoyées
• Stockage des sessions sauvegardé par Redis pour la haute disponibilité

Surveillance et dépannage

Vérifications de santé

Surveillez la santé du système via :

• Le statut d’exécution des tâches cron
• La profondeur de la file d’attente des tâches
• Le statut de connexion à la base de données
• La disponibilité du cache

Problèmes courants

Cron non exécuté :

• Vérifiez que l’entrée cron est correctement configurée
• Vérifiez que le chemin PHP est correct
• Assurez-vous que scripts/jobs.php est exécutable

Utilisation élevée de la base de données :

• Activez le nettoyage automatique des données
• Exécutez l’optimisation des tables
• Examinez les journaux des requêtes lentes

Problèmes de cache :

• Vérifiez la connectivité Redis
• Vérifiez l’allocation de mémoire Redis
• Videz le cache et redémarrez si nécessaire

Pour une assistance supplémentaire au dépannage, accédez au portail de support ou contactez le support technique.