技術情報

Windows で Matomo 用に PHP をインストールし、設定するにはどうすればよいですか？

2025年01月21日 Matomo On-Premise(セルフホスト) Windows インストール＆メンテナンス

Windows上でMatomo用のMySQLをセットアップしたら、以下のステップバイステップガイドを参照してPHPのセットアップを続けましょう。

PHPのインストール

  • PHP Thread Safeをダウンロードし、適切なプロセッサ・アーキテクチャ（64ビットまたは32ビット）を選択します。

  • このファイルの内容を、データドライブのルートのPHPディレクトリに展開します：C: \PHP

  • システムのパス環境変数にphp.exeを追加する。
    コマンドプロンプト（管理者）から実行する：

C:\>setx PATH "%PATH%;C:\PHP" /M

この結果、以下のような結果が返ってくるはずです：

SUCCESS: Specified value was saved.

次のように入力して Windows コマンド ラインを終了します。

C:\>exit

Windows コマンドラインから PHP を実行できることを確認します。

PHPのインストールが成功したかどうかをテストするには、コマンドラインプロンプトから以下を実行してください：

php -m

phpを実行しようとすると、次のようなエラー画面が表示されることがあります。:

その場合、以下のリンクからVisual C++ Redistributable for Visual Studio 2015をダウンロードしてインストールしてください：https://www.microsoft.com/en-us/download/details.aspx?id=48145.

PHPを設定し、必要なPHP拡張機能をすべてロードする。

Matomo Enterprise を実行するには、いくつかの PHP 拡張モジュールが必要です。PHP7 では、必要な拡張モジュールのほとんど (すべてではありません) がデフォルトで有効になっています。必要な拡張モジュールは以下のとおりです：PDO with MySQL driver, GD, json, libxml, dom, SimpleXML, zlib, SPL, iconv, mbstring, Reflection。

以下の手順に従って、PHP を設定して Matomo をインストールしてください：

  • PHPフォルダに移動してphp.ini-productionファイルをコピーしてphp.iniにリネームする。

  • お気に入りのテキストエディタでC:\PHP\php.iniファイルを開きます。

  • extension_dirディレクティブを見つけ、’ext’フォルダーを正しく探すように変更します：

extension_dir = "C:\PHP\ext"
  • 同様に、テンポラリフォルダを指すようにセッションパスを設定します：
session.save_path = "C:\Windows\Temp"
  • 次に、メモリ制限を設定します：
memory_limit = 2G
  • 次に、最大実行時間を設定します：
max_execution_time = 600
  • 次に、エラーログファイルへのエラーのロギングを有効にします：
log_errors = On
  • 次に、画面上のエラーログを無効にします：
display_errors=Off

  • MatomoがPHPで使用する以下の拡張機能を有効にします。

    ファイル上部のPHPセクションに次の行を追加します：

    (注意: PHP 8.0以降では、php_gd2.dllよりもphp_gd.dllを使用してください)

; Activate PHP extensions required by Matomo
    
    extension=php_curl.dll
    extension=php_gd2.dll
    extension=php_mbstring.dll
    extension=php_mysqli.dll
    ​extension=php_openssl.dll
    extension=php_pdo_mysql.dll
  • ファイルをphp.iniとして保存します。

これで、Windowsのコマンドラインからコマンドを実行することで、PHPがまだ動作することをテストすることができます：

php -m

インストールプロセスの開始時に、Matomo は必要な PHP 拡張モジュールがシステムにないかどうかを自動的に報告します。また、Matomo のインストールが完了したら、Matomo > 管理 > 診断 > システムチェック でいつでもシステムチェックを開くことができます。

これで、Windowsサーバー上でPHPのセットアップが成功したはずです。

次に、Windows上でMatomo用にIISをセットアップする方法を説明します：WindowsにIISをインストールし、Matomo用に設定するにはどうすればよいですか？
まだMySQLをセットアップしていない場合は、こちらのWindows用MySQLセットアップガイドの手順に従ってください：WindowsにMatomo用のMySQLをインストールして設定するには？
すべてのセットアップが完了したら、次のことをお忘れなく。Matomoでレポートをアーカイブするためのスケジュールタスクを設定する.