Trafic AI
Instalare pe alt site PHP
Nucleul PHP, pentru orice site PHP fără pachet dedicat.
Nucleul e baza pachetelor pentru WordPress, Laravel și OpenCart. Îl folosești direct pe orice alt site PHP (Symfony, CodeIgniter, cod propriu).
Cerințe: PHP 8.1 sau mai nou, ext-json. Folosește ext-curl dacă e instalat. Fără alte dependențe.
Instalare
-
Creează o cheie în Survelium → Setări brand → Integrări → Creează cheia. Apare o singură dată.
-
Până când pachetul e pe Packagist, adaugă repo-ul în
composer.json:"repositories": [{ "type": "vcs", "url": "https://github.com/survelium/agent-analytics-php" }] -
Instalează-l:
composer require survelium/agent-analytics-php:^0.1@dev -
Pornește-l o singură dată, cât mai devreme în fiecare cerere (în front controller sau prin
auto_prepend_file):use Survelium\AgentAnalytics\AgentAnalytics; use Survelium\AgentAnalytics\Config; AgentAnalytics::start(new Config(apiKey: 'svk_...'));
Atât. La sfârșitul cererii, afișarea de pagină se înregistrează (GET/HEAD, nu XHR sau prefetch), iar la 50 de
elemente sau 60 de secunde buffer-ul se trimite. Sub PHP-FPM sau LiteSpeed, răspunsul pleacă întâi spre vizitator.
Înainte să-l lași să ruleze, verifică
- În spatele Cloudflare sau al unui load balancer, setează
ipHeader, altfel boții nu pot fi verificați. - Un cache de pagini în fața PHP-ului ascunde boții care citesc paginile din cache. Exclude din cache user agent-ii boților AI (lista).
- Folderul de stocare poate fi scris de utilizatorul serverului web. Dacă nu, nu se înregistrează nimic (și nu se strică nimic).
Opțiuni
new Config(
apiKey: 'svk_...',
trackReferrals: true, // false = doar boții AI
denyPaths: ['/admin'], // căi nici raportate, nici numărate
ipHeader: 'HTTP_CF_CONNECTING_IP', // doar în spatele unui proxy care îl setează mereu
storagePath: '/var/www/storage/survelium', // implicit: folderul temporar al sistemului
);
Când ceva nu merge
- Survelium indisponibil: datele rămân în buffer, reîncercările se răresc de la 30 de secunde la o oră.
- Cheie revocată: pauză de o oră. Plan fără Trafic AI: pauză de 6 ore. Datele se păstrează.
- Folder nescriibil: nu face nimic. Integrarea nu-ți strică niciodată site-ul.