ニュース

プロジェクトを成功に導くための Matomo(Piwik) の活用とカスタマイズ方法

2014年12月03日 ブログ

目次
1. config/config.ini.php:Matomo(Piwik) コンフィグファイル
2. bootstrap.php:Matomo(Piwik) 実行前のカスタムコードの実行
3. Matomo(Piwik)PHP クラスのロードおよび PHP での API 呼び出し
4. php.ini と .htaccess について

このページは、config ファイルまたはカスタム PHP bootstrap.php ファイルを経由して Matomo(Piwik) をカスタマイズする方法を説明します。

config/config.ini.php :Matomo(Piwik) コンフィグファイル

Matomo(Piwik) インストールは、config/config.ini.php を作成します。
このファイルは、config/global.ini.php のデフォルト設定を上書きします。 Matomo(Piwik) のアップデート中、このファイルが書き換えられることはありません。

このファイルで、いくつかの設定をカスタマイズすることができます。
たとえば、デフォルトで戻された列の数や、プロキシ設定、管理アクセスの SSL の実行などです。

その他のカスタマイズ可能な設定については、FAQ でもご確認いただけます。

bootstrap.php:Matomo(Piwik) 実行前のカスタムコードの実行

トップレベルの Matomo(Piwik) フォルダが存在する場合、Matomo(Piwik) は、bootstrap.php をロードします。
このファイルは、その後のソフトウェアアップデートで上書きされません。

Matomo(Piwik) をあなたの地域要件に調整するために、正規の PHP を含ませるには、Bootstrap.php をカスタマイズしてください。またログプロセスのようなカスタムコードを開始することも可能です。

また一部の Matomo(Piwik) コア定数をカスタマイズするために、Bootstrap.php ファイルを使用することもできます。

・PIWIK_ENABLE_ERROR_HANDLER
0 に設定すると、呼び出しアプリケーションは、それ自体の例外/エラーハンドラを実行する必要があります。例)Index.php により戻される取得できない例外が取得できるかどうか、お試しください。

・PIWIK_SESSION_NAME
アプリケーションの Matomo(Piwik) 埋め込みおよびセッションデータの共有を許可します。デフォルトは、‘PIWIK_SESSID’ です。

・PIWIK_ENABLE_SESSION_START
デフォルトでは(有効)、ダッシュボードによりセッション(順次ウィジェットをロードするという副作用があります)が初期化および開始されます。独自のセッションハンドリングコードを持つもう一つの PHP スクリプトから Matomo(Piwik) を呼び出す際やレスポンシブを(部分的に並行なローディングを通して)より高めたい場合、0 に設定してください。
注:これには、より多くの MySQL 同時接続が必要になります。(my.cnf’s max_connections を参照してください)

・PIWIK_USER_PATH
Config と tmp ファイルをウェブドキュメントルートの外に移動するために、デフォルトを上書きします。これにより、PHP ファイルへの直接のアクセスを防止する 「 ベストプラクティス 」 が容易になります。
さらに、ユーザーアカウント固有の設定から共有コードを分離する共有ホスティングにとっても、役立ちます。
デフォルトは、PIWIK_DOCUMENT_ROOT と同じです。
注:open_basedir() の制限が適用される場合があります。

・PIWIK_INCLUDE_PATH
index.php と piwik.php によってロードされたファイルを移動するために、デフォルトを無効にします。(例えば include 、include_once 、require 、require_once 経由で)これは PHP ファイルへの直接のアクセスを防止する 「 ベストプラクティス 」 を容易にします。
デフォルトは、PIWIK_DOCUMENT_ROOT と同じです。
注:open_basedir() の制限が適用される場合があります。

ヒントを得るために、bootstrap.php ファイルサンプルもご確認ください。

Matomo(Piwik) PHP クラスのロードおよび PHP での API 呼び出し

Matomo(Piwik)Rest API の呼び出しに関するユーザードキュメントをご確認下さい。
または、http リクエストか内部ヘルパークラスのいづれかをご利用ください。

php.ini と .htaccess について

PHP と Apache 設定の概要は、このドキュメントの範囲外です。
設定の際は、以下の点に注意してください。

・mod_security 
偽の反応を避けるには、このエクステンションの有効化または Matomo(Piwik) の除外が必要です。

・http authentication
Matomo(Piwik).js と piwik.php へのアクセスが、非認証のリクエストに対して、ブロックされないことを保証します。

・PHP session_auto_start
Zend_Sessionと互換性がないため、Matomo(Piwik) では使用できません。


※この記事はMatomo(Piwik)公式サイト2014年10月1日時点の内容です
※掲載内容が古くなっている場合もありますので最新情報はMatomo(Piwik)公式サイトをご覧ください。

オリジナルの記事はこちら
http://piwik.org/docs/include-piwik-in-your-project/