wAnalyzer::getData

Ermittelt Statistikdaten innerhalb eines angegebenen Zeitraums
(verfügbar ab CMS-Version 016.001.131.000)

Funktionsaufruf

Int getData(String $project, Array $options)

Parameter

project

Projekt

options

Optionen

type [|requests|impressions|visits|visitors]
: Art der Daten
limitFrom: Datum, oder Anzahl Tage, ab denen die Daten ermittelt werden sollen, z.B. 30 oder 2020-01-01
limitTo: Datum, oder Anzahl Tage, bis denen die Daten ermittelt werden sollen, z.B. 0 oder 2020-01-31
limit: Alternativ zu limitFrom und limitTo kann auch eine Anzahl Tage angegeben werden. Der aktuelle Tag wird dabei dazu gerechnet.
path: Falls nur die Werte eines bestimmten Pfades ermittelt werden sollen (unterstützt die Typen requests, impressions und visits).
expires
: Cache in Sekunden
forceWriteCache
: Falls der Cache ohne expires geschrieben werden soll.

Beispiel: Ermittelt Statistikdaten innerhalb des angegebenen Zeitraums

Quelltext

<?php

$wProjectPath = '/de';
$dateFrom = (preg_match('/\d\d\d\d-\d\d-\d\d/', wRequest::getParameterSecure('dateFrom'))) ? wRequest::getParameterSecure('dateFrom') : '2021-08-01';
$dateTo   = (preg_match('/\d\d\d\d-\d\d-\d\d/', wRequest::getParameterSecure('dateTo'))) ? wRequest::getParameterSecure('dateTo') : '2021-08-31';

print '<h3>Statistik-Auswertung <i>'.$wProjectPath.'</i> für den Zeitraum <strong>'.wDate::formatDate('d.m.Y', $dateFrom).'</strong> bis <strong>'.wDate::formatDate('d.m.Y', $dateTo).'</strong></h3>
Aufrufe serverseitig: '.wAnalyzer::getData($wProjectPath, array('type' => 'requests', 'limitFrom' => $dateFrom, 'limitTo' => $dateTo)).'<br />
Aufrufe clientseitig: '.wAnalyzer::getData($wProjectPath, array('type' => 'impressions', 'limitFrom' => $dateFrom, 'limitTo' => $dateTo)).'<br />    
Anzahl Besuche: '.wAnalyzer::getData($wProjectPath, array('type' => 'visits', 'limitFrom' => $dateFrom, 'limitTo' => $dateTo)).'<br /> 
Anzahl Besucher: '.wAnalyzer::getData($wProjectPath, array('type' => 'visitors', 'limitFrom' => $dateFrom, 'limitTo' => $dateTo)).'<br />';

print '<p><a class="intern" href="?dateFrom=2021-04-01&dateTo=2021-08-31">Aufruf mit Zeitraum-Angabe über URL-Parameter</a></p>';

?>

Beispiel: Ermittelt Statistikdaten der letzten 30 Tage

Quelltext

<?php

$wProjectPath = '/de';
$limit    = '30';

print '<h3>Statistik-Auswertung <i>'.$wProjectPath.'</i> für den Zeitraum der letzten <strong>'.$limit.' Tage</strong></h3>
Aufrufe serverseitig (requests): '.wAnalyzer::getData($wProjectPath, array('type' => 'requests', 'limit' => $limit)).'<br />
Aufrufe clientseitig (impressions): '.wAnalyzer::getData($wProjectPath, array('type' => 'impressions', 'limit' => $limit)).'<br />
Anzahl Besuche (visits): '.wAnalyzer::getData($wProjectPath, array('type' => 'visits', 'limit' => $limit)).'<br />
Anzahl Besucher (visitors): '.wAnalyzer::getData($wProjectPath, array('type' => 'visitors', 'limit' => $limit)).'<br />';

print '<p><a class="intern" href="?limit=60">Aufruf mit Zeitraum-Angabe über URL-Parameter</a></p>';

?>

Hinweis
Beim Einsatz von Framework-Funktionen in eigenen Skripten beachten Sie bitte den Artikel "So verwenden Sie das PHP-Framework in eigenen Scripten".
Wenn Sie eine Funktion innerhalb einer Weblication® Seite z.B. über das PHP-Quelltext Element oder in einem XSL-Template über wsl:php einbinden, muss das Framework über die grid.php nicht mehr referenziert werden.

FAQs

Wofür ist wAnalyzer::getData gedacht?: wAnalyzer::getData ermittelt Statistikdaten innerhalb eines angegebenen Zeitraums.
Ab welcher CMS-Version ist wAnalyzer::getData verfügbar?: Die Funktion ist verfügbar ab CMS-Version 016.001.131.000.
Wie lautet der Funktionsaufruf von wAnalyzer::getData?: Int getData(String $project, Array $options).
Welche Parameter werden bei wAnalyzer::getData benötigt?: Benötigt werden: - project: Projekt - options: Optionen zur Auswahl der Datentypen und zum Zeitraum (z. B. requests, impressions, visits, visitors).
Welche Datentypen können mit der Option options abgefragt werden?: Über options kann der Datentyp ausgewählt werden (type): - requests - impressions - visits - visitors.
Wie kann ich den Zeitraum für die Statistik festlegen (limitFrom/limitTo)?: Mit limitFrom und limitTo. Beide Werte können entweder als Datum (z. B. 2020-01-01) oder als Anzahl Tage angegeben werden (z. B. 30).
Wie funktioniert die Alternative zur Zeitraumangabe über limitFrom/limitTo (limit)?: Alternativ kann limit verwendet werden. Dabei wird der aktuelle Tag mitgerechnet. limit ist dabei eine Anzahl Tage (z. B. 30).
Kann ich die Auswertung auf bestimmte Pfade beschränken?: Ja. Über den Parameter path können nur Werte eines bestimmten Pfads ermittelt werden. Unterstützt werden dabei die Typen requests, impressions und visits.
Wozu dient die Option expiresCache?: Mit expiresCache (in Sekunden) kann festgelegt werden, wann der Cache abläuft. Es gibt außerdem eine Möglichkeit, den Cache ohne expires zu schreiben ("forceWriteCache").
Wie kann ich wAnalyzer::getData für serverseitige und clientseitige Aufrufe nutzen?: Typischerweise nutzt man den Datentyp je nach Kontext, z. B.: - serverseitig: type = requests - clientseitig: type = impressions jeweils mit identischem project und Zeitraum (limitFrom/limitTo oder limit).
Wie kann ich Statistikdaten für die letzten N Tage ermitteln?: Indem du limit auf die gewünschte Anzahl Tage setzt, z. B. limit = 30. Der aktuelle Tag wird dabei mitgerechnet. Danach kannst du z. B. requests, impressions, visits und visitors mit jeweils passendem type abfragen.