README
, (*1)
The RequestLab Xiti Analytics library provides a way to use the AT Internet Analytics Data Query API., (*2)
It's inspired by the Wid'op Google Analytics library, (*3)
Documentation
Installation
To install the RequestLab Xiti Analytics library, you will need Composer. It's a PHP 5.3+
dependency manager which allows you to declare the dependent libraries your project needs and it will install &
autoload them for you., (*4)
Set up Composer
Composer comes with a simple phar file. To easily access it from anywhere on your system, you can execute:, (*5)
$ curl -s https://getcomposer.org/installer | php
$ sudo mv composer.phar /usr/local/bin/composer
Define dependencies
Create a composer.json
file at the root directory of your project and simply require the
requestlab/xiti-analytics
package:, (*6)
{
"require": {
"requestlab/xiti-analytics": "*"
}
}
Install dependencies
Now, you have define your dependencies, you can install them:, (*7)
$ composer install
Composer will automatically download your dependencies & create an autoload file in the vendor
directory., (*8)
Autoload
So easy, you just have to require the generated autoload file and you are already ready to play:, (*9)
``` php
, (*10)
The RequestLab Xiti Analytics library follows the [PSR-0 Standard](https://github.com/php-fig/fig-standards/blob/master/accepted/PSR-0.md).
If you prefer install it manually, it can be autoload by any convenient autoloader.
### Usage
#### Query
First, in order to request the ATInternet Analytics Query service, simply create a request and configure it according to your needs:
``` php
setStartDate(new \DateTime('-1 Day'));
$query->setEndDate(new \DateTime('-1 Day'));
$query->setSpace(99999);
$query->setColumns(array('m_visits', 'm_page_loads'));
$query->setSort(array('-m_visits'));
?>
Client
A client allows you to request the service with your login and password., (*11)
``` php
setLogin('Login');
$client->setPassword('Password');
?>, (*12)
#### Service
``` php
query($query);
?>
Response
The response is a RequestLab\XitiAnalytics\Response object which wraps all available informations:, (*13)
php
getColumns();
$rows = $response->getRows();
$totals = $response->getTotals();
?>
, (*14)
Testing
The library is fully unit tested by PHPUnit. To execute the test suite, check the travis configuration., (*15)
Contribute
The library is open source, propose a PR!, (*16)
License
The RequestLab Xiti Analytics library is under the MIT license. For the full copyright and license information, please
read the LICENSE file that was distributed with this, (*17)
source code., (*18)