ニュース

Piwik 3 開発アップデート #4 – 重要な注意事項および重大な変更

私たちは、以前の開発のアップデート#1#2#3で述べたように積極的にPiwik 3アップデートに取り組んでおり、最初のベータ版をすぐにリリースする予定です。このアップデートは、新機能やバグ修正を多くをもたらしますが、このブログ記事の詳細に、注意が必要ないくつかの重要な変更が付属しています。

データベースアップデート

できるだけ簡単なPiwikのアップグレードを維持するために、通常のPiwik 2.Xのリリースサイクルでテーブルに大きな影響を与えるデータベース・スキーマの変更を避けてきました。しかし、Piwik 3アップデートではバグを修正するために、データベーススキーマにいくつかの制限とデータベースの更新が必要になります。かなりの量のトラフィックおよび/または大規模なPiwikのデータベースを持っている場合は、コマンドラインでPiwik 3のデータベースの更新を実行することをお勧めします。

Piwikの更新が困難な場合は、Piwikサポートによるアップグレードのお見積を致します。

新しいサーバーとブラウザの要件

Piwik3は、サーバの要件を更新しました。推奨環境:

  • PHP 5.5.9 以降 (PHP 5.3以上が必要),
  • MySQL 5.5 以降、または MariaDB (MySQL 4.1以上が必要).

古いPHPとMySQLのバージョンが残っている場合は、PHP 7と最新のMySQLバージョン(MySQL 5.7+)に直接更新することを強くお勧めします。

また、Piwik 3では古いブラウザのIE 8とIE 9をサポートから除外します。

デフォルトのfilter_limitは今後、すべてのHTTP APIのメソッドに適用されます(#8458

従来は100行のデフォルトfilter_limitは、レポートを返すHTTP APIメソッドに適用していました。これがデフォルトであることを意味します:

  • SitesManager.getAllSitesUserManager.getUserまたはGoals.getGoals(報告されていない)のようなメソッドを要求したとき、これらははすべての行が返されました。
  • Actions.getPageUrlようなレポートを(レポートがある)フェッチするとき、結果が100行に制限されていました。

この動作には一貫性がなく、デフォルトの制限を適用しなかったどのメソッドも理解することが困難でした。今後は、デフォルトですべてのHTTP APIメソッドにデフォルトの制限を適用します。

APIのコンシューマやアプリがAPIメソッドのすべての結果をフェッチする必要がある場合は、URLに次のパラメータを追加することができます:&filter_limit=-1すべてのAPIのために自動的にデフォルトfilter_limitを変更したい場合あるいは、あなたのconfig/config.ini.phpファイル内API_datatable_default_limitコンフィグ設定を上書きすることができます。

使用できる様々なAPIパラメータの詳細については、Piwikの解析HTTP APIリファレンスを参照してください。

プロキシクライアントのIP検出(#10342

これはconfig/config.ini.php内にproxy_client_headers[]の設定をしている場合にのみ重要です。すなわち、あなたのPiwikのサーバがプロキシ経由であります。

PiwikのプロキシヘッダーからクライアントIPアドレスを取得するための設定であり、ヘッダに複数のIPアドレスが含まれている場合、これらは、最後のIPアドレスを使用するために使用されます。Piwik 3からは、これらはプロトコルの定義に沿ったものである最初のIPアドレスを使用することになります。HTTP_X_FORWARDED_FORは、複数のIPアドレスが含まれている場合たとえば、これらは今後、最後の1の代わりに、最初のIPを使用します。

書き込み可能なPiwikのJavaScriptのトラッカーファイルpiwik.js

Piwik 3からは、PHPとWebサーバプロセスがこのファイルを編集できるように、/piwik.js はPiwikのディレクトリに書き込み可能なファイルを持つことをお勧めします。Piwikがうまく機能するために、ファイルを書き込み可能にすることは要求されていませんが、私たちは、ファイルが書き込み可能である場合にのみ動作するいくつかの拡張機能に取り組んでいます。このファイルが書き込み可能であるかどうかわからない場合は、スーパーユーザーとして “Administration => System Check” に移動すると、ファイルが書き込み可能でない場合にPiwikの警告が表示されます。必要な場合は、コマンドライン(Linuxの場合)chmod 0755 piwik.jsまたはchown $webuser piwik.jsを実行して、ファイルを書き込み可能にすることができるかもしれません。

プラグイン開発者向けの変更点

以前の開発のアップデートでは、我々はすでにPiwikのプラグインの開発者に影響を与える変更の一部を導入しています。開発者が独自のプラグインをより促進するため、および彼らのプラグインのページを簡単に維持することができるマーケットプレイスに、いくつかの改善をしました。プラグインを Piwik 3に移行しやすくプラグイン開発者のための移行ガイドも用意しました。

すべての変更の一覧については、開発者の変更履歴をご覧ください。

次のPiwik 3の更新まで、Happy Analytics!


logo-piwik-square-150x150Piwikコアチーム

Piwikはプライバシー機能を内蔵したオープンプラットフォームを提供することでウェブ解析を自由にしています。
Piwikは、世界中で100万人以上のウェブサイトで使用され、53の言語に翻訳されています。
Marketplaceでは、ウェブ解析の世界でイノベーションを創出するためのコミュニティを可能にします。