• 目次
    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/