ClientTool

ClientTool (anciennement Utils) est un utilitaire léger dédié à l'identification technique du visiteur. Il permet de récupérer l'adresse IP réelle (en contournant les proxys transparents) et d'identifier le logiciel (Navigateur/OS) ou la nature du visiteur (Humain vs Robot) à des fins de statistiques ou de sécurité.

Namespace : Magepattern\Component\Tool\ClientTool

Liste des méthodes

Méthode	Paramètres	Retour	Description
getIp()	-	string	Récupère l'IP publique réelle.
getBrowser()	?string $ua	string	Retourne le nom du navigateur (Chrome, Firefox, etc.).
getOs()	?string $ua	string	Retourne le système d'exploitation.
isBot()	?string $ua	bool	Détermine si le visiteur est un robot.

Usage courant

1. Logs et Sécurité (IP) Récupération fiable de l'IP pour enregistrer l'activité utilisateur, même si le serveur est derrière un Load Balancer (AWS, Cloudflare).

use Magepattern\Component\Tool\ClientTool;

$userIp = ClientTool::getIp();
// Ex: 203.0.113.45

2. Filtrage des Robots Utile pour ne pas incrémenter les compteurs de vues si le visiteur est un bot Google ou Facebook.

if (!ClientTool::isBot()) {
    $article->incrementViews();
}

3. Debugging Identifier rapidement l'environnement technique d'un utilisateur lors d'un rapport de bug.

$debugInfo = sprintf(
    "User on %s using %s (IP: %s)", 
    ClientTool::getOs(), 
    ClientTool::getBrowser(), 
    ClientTool::getIp()
);
// Résultat : User on Windows using Chrome (IP: 85.x.x.x)