Руководство пользователя CNStats 3.4

Назад | Оглавление | Вперед

Список параметров config.php

Настройки, хранимые в файле config.php:

$STATS_CONF["cnsoftwaredomain"] (обязательный параметр)

$STATS_CONF["cnsoftwaredomain"]="cnstats.com";

$STATS_CONF["sqlserver"] (обязательный параметр)

Программное обеспечение SQL сервера. На данный момент - только MySql.

Пример:

$STATS_CONF["sqlserver"]="MySql";

$STATS_CONF["dbname"] (обязательный параметр)

Имя базы данных, в которой CNStats хранит все данные. Имена таблиц CNStats имеют префикс "cns_", поэтому Вы можете использовать CNStats даже в том случае, если хостинг-провайдер предоставляет Вам только одну базу данных.

Пример:

$STATS_CONF["db_name"]="mysite_cnstats";

$STATS_CONF["sqlprefix"]

Префикс таблиц CNStats; используется при установке нескольких копий CNStats в одну базу данных. Значение по умолчанию - "cns_". При изменении префикса необходимо вручную изменить название всех таблиц CNStats.

Пример:

$STATS_CONF["sqlprefix"]="cns1_";

$STATS_CONF["sqlhost"] (обязательный параметр)

Адрес сервера баз данных. Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqlhost"]="localhost";

$STATS_CONF["sqluser"] (обязательный параметр)

Логин для доступа к серверу баз данных. Для корректной работы CNStats Вы должны обладать правами на создание и удаление таблиц. Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqluser"]="root";

$STATS_CONF["sqlpassword"] (обязательный параметр)

Пароль для доступа к серверу баз данных. Пароль может быть пустым (часто для пользователя root). Как правило, предоставляется хостинг-провайдером.

Пример:

$STATS_CONF["sqlpassword"]="";

$COUNTER["savelog"] (обязательный параметр)

Параметр задает период хранения полной статистики в днях. Чем дольше хранится полная статистика, тем больше места занимает база данных; как следствие - тем медленнее будут строиться отчеты.

Контролировать размер базы данных можно с помощью отчета "Размер базы данных".

Рекомендуемое значение - 40.

Пример:

$COUNTER["savelog"]=60;

Вы можете увеличить период хранения в любой момент. Не следует задавать слишком большой период хранения; как правило, для анализа достаточно 30-60 дней.

Вы можете также уменьшить период хранения в любой момент. Записи удаляются в полночь. В зависимости от настроек Вашей базы данных размер базы может не уменьшиться. Для уменьшения размера необходимо провести оптимизацию таблицы sql с помощью команды:

OPTIMIZE TABLE cns_log;

$COUNTER["type"] (обязательный параметр)

Тип счетчика.

0 - "GIF 1x1"
2 - "PHP-Include"
3 - "Комбинированный" ("PHP-Include" + "GIFx1x1")

Более подробно о типах счетчиков Вы можете узнать в разделе "Типы счетчиков"

Значение "1" не используется начиная с версии 3.0.

$COUNTER["excludeip"], $COUNTER["excludemask"]

Список исключаемых IP адресов и сетей. Можно задать один или несколько диапазонов. Задавать следует попарно - адрес, затем маска.

Пример:

Для одного адреса:

$COUNTER["excludeip"]="127.0.0.1";
$COUNTER["excludemask"]="255.255.255.255";

Для одного адреса и одной сети:

$COUNTER["excludeip"][]="127.0.0.1";
$COUNTER["excludemask"][]="255.255.255.255";
$COUNTER["excludeip"][]="192.168.0.1";
$COUNTER["excludemask"][]="255.255.255.0";

$COUNTER["disablepassword"]

Отключение авторизации CNStats ("yes" - отключить, "no" - не отключать).

При интеграции CNStats в движок сайта иногда удобнее самостоятельно организовывать авторизацию. В этом случае для предотвращения двойной авторизации можно отказаться от авторизации CNStats.

По умолчанию: "no"

Пример:

$COUNTER["disablepassword"]="yes"

$STATS_CONF["adminemail"]

E-Mail администратора. Используется в следующих моментах:

Адрес получателя уведомлений об ошибках, возникающих при работе CNStats (при условии включенной опции $COUNTER["senderrorsbymail"]);
Адрес, подставляемый в поля "Отправитель" и "Обратный адрес" в отчетах, посылаемых по электронной почте.

Пример:

$STATS_CONF["adminemail"]="jonh@example.com"

$COUNTER["senderrorsbymail"]

Если указан параметр "yes", то ошибки, возникающие при работе CNStats, отправляются на E-Mail, указанный с помощью параметра $STATS_CONF["cnsoftwarelogin"].

Если "no", то ошибки по почте не отправляются.

Пример:

$COUNTER["senderrorsbymail"]="yes";

$COUNTER["sqlwritelog"]

Дополнение к SQL запросу записи в лог-таблицу. Вставляется в SQL инструкцию в чистом виде между "INSERT" и именем таблицы.

ПРИМЕЧАНИЕ: Неверно заданный параметр может повредить базу данных.

Пример:

$COUNTER["sqlwritelog"]="DELAYED";

$STATS_CONF["sqlinstructions"]

Массив SQL инструкций, выполняемых сразу после соединения с сервером баз данных. Как правило, это опция используется для настройки локализации, если сервер баз данных по умолчанию настроен некорректно.

Пример:

$STATS_CONF["sqlinstructions"][]="SET NAMES cp1251";
$STATS_CONF["sqlinstructions"][]="SET CHARACTER SET cp1251";

$STATS_CONF["slow_reports_memory_limit"]

Ограничение на объем используемой памяти для медленных отчетов. К таким отчетам относятся на данный момент только "Точки выхода" и "Пути по сайту".

Если используется integer, значение измеряется байтами. Вы также можете использовать сокращённую запись - K (для Килобайт) и M (для Мегабайт)

Пример:

$STATS_CONF["slow_reports_memory_limit"]="32M";

$STATS_CONF["slow_reports_time_limit"]

Ограничение на время выполнения (в секундах) для медленных отчетов. К таким отчетам относятся на данный момент только "Точки выхода" и "Пути по сайту".

Пример:

$STATS_CONF["slow_reports_time_limit"]=1800;

$STATS_CONF["hello string"]

Параметр задает текстовую строку, которая выводится в диалоге ввода логина и пароля. Можно использовать HTML код. По умолчанию строка пустая.

Пример:

$STATS_CONF["hello string"]="Для просмотра статистики

используйте логин <B>guest</B> и пароль

<B>guest</B>.";

$COUNTER["timeoffset"] (функция работает в экспериментальном режиме)

Смещение времени на сервере в секундах. Параметр задается в случае если сервер, на котором расположен Ваш сайт, находится в другом часовом поясе.

Пример:

$COUNTER["timeoffset"]=-1800;

$COUNTER["HTTPheaders"]

Массив дополнительных HTTP-заголовков, отправляемых клиенту при использовании следующих типов счетчика:

Комбинированный;
GIF 1x1;
PNG 88x31.

С помощью этого параметра можно установить дополнительные Cookies, язык, P3P данные и другую информацию, передаваемую через HTTP-заголовки.

Пример:

$COUNTER["HTTPheaders"]["Language"]="ru";

$COUNTER["HTTPheaders"]["P3P"]="policyref=\"/w3c/p3p.xml\", CP=\"UNI\"";

$COUNTER["excludeurl"]

Шаблон для исключения страниц из статистики.

Пример:

$COUNTER["excludeurl"][]="PHPSESSID";

$COUNTER["excludeurl"][]="favicon.ico";

В данном примере из статистики исключены адреса, содержащие строки "PHPSESSID" и "favicon.ico".

$STATS_CONF["redirect"]

Тип автоматического перенаправления (редирект) в интерфейсе просмотра статистики CNStats. Возможные значения:

header (по умолчанию) - использовать HTTP-заголовок Location для автоматических перенаправлений.
meta - использовать META-теги для автоматических перенаправлений; рекомендуется при использовании сервера IIS/5.0.

Данная опция была добавлена из-за неверной обработки Cookies во время перенаправлений сервером IIS/5.0. Более подробно об этой проблеме можно прочитать на сервере поддержки Microsoft.

$STATS_CONF["quiet"]

Режим умолчания в SQL запросах; при включении этого режима информация о ошибках SQL сервера не выводится.

Yes - режим включен. Рекомендуется использовать только в крайних случаях при нестабильной работе SQL сервера;
No (по умолчанию) - режим выключен.

Пример:

$STATS_CONF["quiet"]="no";

$STATS_CONF["codegeneration"]

Режим генерации кода счетчика (только при использовании комбинированного типа счетчика).

html (по умолчанию) - генерировать и выводить JavaScript код;
variable - генерировать JavaScript код и записывать его в переменную $CNSTATS_JAVASCRIPT_CODE;
onlyid - генерировать только уникальный идентификатор обращения и записывать его в переменную $CNSTATS_JAVASCRIPT_CODE.

С помощью значения "variable" Вы можете вызвать PHP-часть счетчика в одном месте, а JavaScript-часть счетчика в другом месте. Например:

<?php

include "config.php";

// Вызов PHP-части кода счетчика

include "/../cnstats/cnt.php";

// Вывод HTTP-заголовка

header("Language: ".GetDocumentLanguage());

// Вывод верхней части документа

include "top.php";

// Вывод JavaScript-части

print $CNSTATS_JAVASCRIPT_CODE;

// Вывод тела документа

print DocumentBody();

// Вывод нижней части документа

include "bottom.php";

С помощью значения "onlyid" Вы можете полностью изменять JavaScript-часть кода счетчика и выводить ее в любом месте. Например, Вы можете использовать JavaScript-код, совместимый с XHTML:

<?php

include "config.php";

// Вызов PHP-части кода счетчика

include "/../cnstats/cnt.php";

// Вывод HTTP-заголовка

header("Language: ".GetDocumentLanguage());

// Вывод верхней части документа

include "top.php";

cnsd=document;

cnsd.cookie='b=b';

cnsc=cnsd.cookie?1:0;

cnst=escape(cnsd.title);

cnst=cnst.replace(/\+/g,'%2B');

cnsa=navigator.appName;

cnsn=(cnsa.substring(0,2)=='Mi')?0:1;

cnss=screen;cnspx=(cnsn==0)?cnss.colorDepth:cnss.pixelDepth;

if (cnsd.getElementById)

{

var i=cnsd.createElement('img');

var iurl='/cnstats/cntc.php?i=<?php echo $CNSTATS_JAVASCRIPT_CODE;?>';

iurl+='&c='+cnsc+'&e='+cnss.width+'.'+cnss.height+'&d='+cnspx;

iurl+='&r='+escape(cnsd.referrer)+'&p='+escape(cnsd.location)+'&t='+cnst;

i.src=iurl;

i.width=1;i.height=1;i.border=0;

cnsd.getElementById("m").appendChild(i);

}

</SCRIPT>

</a>

<?php

// Вывод тела документа

print DocumentBody();

// Вывод нижней части документа

include "bottom.php";

$STATS_CONF["gdversion"]

Параметр задает версию библиотеки GD:

"0" - GD не установлена;
"1" - Установлена GD версии 1.X;
"2" - Установлена GD версии 2.X;
"auto" - автоматическое определение версии GD (по умолчанию).

Пример:

$STATS_CONF["gdversion"]="auto";

$STATS_CONF["code"]

Формат кода счетчика.

"HTML" - код в формате HTML;
"XHTML" - код в формате XHTML.

Параметр влияет на код счетчика, выдаваемый в разделе Конфигурация - Код счетчика, а также на код, генерируемый системой при использовании комбинированного типа счетчика.

Пример:

$STATS_CONF["code"]="XHTML";

$STATS_CONF["cnstats_http_path"]

Относительный путь CNStats на Вашем сайте. Путь определяется автоматически во время установки CNStats. После установки эту настройку изменять нельзя.

Пример:

$STATS_CONF["cnstats_http_path"]="/cnstats/";

Пример файла config.php

<?php

// License domain. It should match the register key domain.

$STATS_CONF["cnsoftwaredomain"]="cnstats.com";

// SQL server software. So far only MySql is supported.

$STATS_CONF["sqlserver"]="MySql"

// Name of the database, where CNStats stores all data. Names of

// CNStats tables have $STATS_CONF["sqlprefix"] prefix, so it is

// possible to use CNStats even if your hosting-provider granted

// you access only to one database.

$STATS_CONF["dbname"]="my_cnstats";

// CNStats tables prefix

$STATS_CONF["sqlprefix"]="cns3_";

// Database server address. As a rule, it is granted by the

// hosting-provider.

$STATS_CONF["sqlhost"]="db12c.pair32.com";

// Database server login. You must have rights for creation and deletion

// of database tables for correct functioning of CNStats. These rights

// are usually granted by the hosting-provider.

$STATS_CONF["sqluser"]="mystats_2";

// Database server password. It may be blank (often for "root" users).

// As a rule, it is granted by the hosting-provider.

$STATS_CONF["sqlpassword"]="677conduge";

// It sets period of complete statistics storage per days. The longer the

// period, the more space is required for the database. The database size

// influences the system performance, it slows down with larger database.

// Database size can be monitored in the report "Database size".

$COUNTER["savelog"]=60;

// Counter type. (For more information, please, refer to

// http://www.cnstats.com/en/support/manual/countercodehow.php

// 0 - Blank GIF image

// 2 - PHP-include

// 3 - Combined (PHP-include + GIF)

$COUNTER["type"]=3;

// List of excluded IP addresses and networks. It is possible to set one

// or several ranges. It should be set in couples: IP-address first,

// than network mask.

$COUNTER["excludeip"][]="0.0.0.0";

$COUNTER["excludemask"][]="255.255.255.255";

// CNStats authorization disabling. "Yes" - authorization is disabled,

// "no" - authorization is enabled. Sometimes it is more convenient

// to use "in-house" authorization when you install CNStats into existent

// software engine. In such cases you may switch off CNStats authorization

// to avoid double authorization.

$COUNTER["disablepassword"]="no";

// E-Mail address for the system errors notifications (provided that

// $COUNTER["senderrorsbymail"] option is enabled).

$STATS_CONF["adminemail"]="admin@cnstats.com";

// If it is set to "yes", then CNStats errors will be reported to the e-mail

// set in $STATS_CONF["adminemail"] parameter.

$COUNTER["senderrorsbymail"]="yes";

// Addition to the SQL request to write in the log-table. It is inserted in

// the SQL instruction in plain format between "INSERT" and the table name.

// Note: Incorrect parameter can damage the database.

// $COUNTER["sqlwritelog"]="";

// Array of SQL-instructions, performed upon connection to the database server.

// As a rule, this option is used to configure localization in case the database

// server has incorrect settings.

// $STATS_CONF["sqlinstructions"][]="";

// Memory volume limit for slow reports. There are two of them - "Entry pages"

// and "Trace browsing". If integer is used, the value is measured in bytes.

// It is possible to use abbreviations - K (for kilobytes)

// and M (for megabytes).

$STATS_CONF["slow_reports_memory_limit"]="8M";

// Time limit for slow reports (seconds). There are two of them - "Entry pages"

// and "Trace browsing".

$STATS_CONF["slow_reports_time_limit"]="30";

// The parameter sets a text string which is displayed in the login dialogue.

// HTML code may be used. The string is blank by default.

$STATS_CONF["hello string"]="";

// The parameter sets guest login, which allows viewing statistics and using

// filters (creating, deleting). Other settings are not available for a guest.

// $STATS_CONF["HTTPheaders"]["0"]="";

// Template for pages exclusion from the statistics.

// $STATS_CONF["excludeurl"][]="";

// Automatic redirection type at the CNStats statistics interface.

// Possible values:

// - header (by default) - Location HTTP-header is used for automatic

// redirections.

// - meta - META-tags are used for automatic redirections; it is

// recommended in case IIS/5.0 server is used.

$STATS_CONF["redirect"]="meta";

// SQL requests hiding mode; when it is activated, SQL error data are not

// displayed.

// yes - the mode is enabled. It is recommended to use only in emergency

// cases, if SQL server is unstable;

// no (by default) - the mode is disabled.

$STATS_CONF["quiet"]="no";

// Counter code generation mode (only for combined counter type).

// html (by default) - JavaScript code is generated and displayed;

// variable - JavaScript code is generated and recorded to

// variable;

// onlyid - only request unique identifier is generated and

// recorded to variable.

$STATS_CONF["codegeneration"]="html";

// GD library version

// "0" - GD is not set

// "1" - GD version 1.X is set

// "2" - GD version 2.X is set

// "auto" - Automatic definition of GD version (by default)

$STATS_CONF["gdversion"]="auto";

// Counter code

// "HTML" - HTML friendly counter code

// "XHTML" - XHTML friendly counter code

$STATS_CONF["code"]="HTML";

// The catalogue, in which CNStats is installed.

$STATS_CONF["cnstats_http_path"]="/cnstats/";

Назад | Оглавление | Вперед

Документация

Наши продукты

Руководство пользователя CNStats 3.4