RPM(Red Hat Package Manager)でPHPエージェントをインストール

https://pkg.contrastsecurity.comからエージェントパッケージを取得します。以下のスクリプトをシェルで実行し、お使いのRPMベースのシステムにContrastのパッケージリポジトリを設定します。sudoの権限が必要になる場合があります。

tee /etc/yum.repos.d/contrast.repo <<-"EOF"
    [contrast]
    name=Contrast centos-$releasever repo
    baseurl=https://pkg.contrastsecurity.com/rpm-public/redhat-$releasever/
    gpgcheck=0
    enabled=1
    EOF

完了したら、以下のコマンドのいずれかを使用して、エージェントとサービスをインストールします。使用するコマンドは、エージェントをインストールするプラットフォームによって異なります。

sudo yum install contrast-php-agent

または

sudo dnf install contrast-php-agent

PHPエージェントが実行されているかを確認するには、Contrast Webインターフェイスを確認するか、(設定によっては)PHPエージェントのログ出力を確認するなどしてください。

contrast-php-utilコマンドを使用します。このコマンドはPHPエージェントと一緒にインストールされ、コマンドラインから使用することで、お使いの環境でエージェントを有効にすることができます。

contrast-php-util enable-agent

これにより、PHPが拡張モジュールを管理するために使用するスキャンディレクトリにiniファイルが作成されます。

または

PHPの設定ファイルである、php.iniを編集します。ほとんどの場合、/usr/local/etc/php/にあります。

php-configコマンドが使える場合は、php-config --ini-pathを使用して設定ファイルのパスを見つけることができます。このパスに設定ファイルがまだ存在しない場合は、作成する必要があります。

echo "extension=/usr/local/lib/contrast/php/contrast.so" >> php-config --ini-path/php.ini

php-configコマンドが使えないシステムでは、 PHPを利用してiniファイルの場所を確認できます。

php -i | grep php.ini

実行結果の「Configuration File (php.ini) Path」行にアクティブなiniファイルが表示されます。そして、そのファイルを編集して、ファイルの末尾に以下を追加してください。

 extension=/usr/local/lib/contrast/php/contrast.so

環境によっては、PHPのコマンドラインインスタンスで使用されるiniファイルが、サーバ環境でロードされるファイルと異なる場合があることに注意してください。FPMは、多くの場合、/etc/php/<php version>/fpm/ディレクトリにあるiniファイルを使用します。適切なPHPインスタンスを動かしていることを確認してください。

セットアップの完了に進みます。

必要な拡張モジュールが有効になっていることを確認します。

PHPエージェントには、mbstring、json、curlのPHP拡張モジュールがインストールされ、有効になっている必要があります。これらの拡張モジュールが有効でない場合は、php.ini設定ファイルを編集して以下の行を追加してください。

extension=curl
extension=mbstring
extension=json

PHPエージェントのYAMLテンプレートか環境変数を使用して、PHPエージェントを設定します(まだ設定をしていない場合)。

通常の方法でアプリケーションを開始します。

アプリケーションの疎通やテストを行います。

PHPエージェントが実行されているかを確認するには、Contrast Webインターフェイスを確認するか、(設定によっては)PHPエージェントのログ出力を確認するなどしてください。