PHP 디렉토리별 INI 설정

웹 서버가 여러 도메인을 제공할 때 INI 파일 예제의 구문을 사용하십시오. New Relic에서 이러한 각 도메인을 개별적으로 보려면:

1. 기본 도메인의 경우 전역 INI 파일에서 newrelic.appname = "My Main Domain" 을 설정합니다.

2. 가상 호스트 구성의 일부로 php_value 항목을 추가하여 각 가상 호스트의 값을 재정의합니다.

   중요

   PHP 설치에 적절한 모듈 이름을 사용했는지 확인하십시오. 아래 예에서 PHP_MODULE 을 설치된 PHP5 모듈의 이름으로 바꿉니다. 이 이름은 사용 중인 Linux 및/또는 PHP 배포판에 따라 다릅니다. 예를 들어, 일반 이름에는 php5_module , mod_php5 , php_module 등이 있습니다. 대문자 사용은 다를 수 있습니다.

   Apache 서버의 경우 다음 방법 중 하나로 모듈 이름을 찾을 수 있습니다. 각각은 설치된 모듈 목록을 생성합니다.

• 명령줄에서 다음을 실행합니다.

  bash

  카피

  $
  apachectl -t -D DUMP_MODULES

  OR

• 웹 페이지 내에서 다음을 사용합니다.

  <?php
    print_r(apache_get_modules());
  ?>

  카피

  도메인별 앱 이름 설정

  다음은 도메인을 분리하는 예입니다. 여기서 PHP_MODULE 은 PHP5 모듈의 이름입니다.

  <VirtualHost 192.168.42.43>
    ServerName www.myvhost1.com
    DocumentRoot "/path/to/vhost1/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 1"
    </IfModule>
  </VirtualHost>
  
  <VirtualHost 192.168.123.45>
    ServerName www.myvhost2.com
    DocumentRoot "/path/to/vhost2/"
    ...
    <IfModule PHP_MODULE>
      php_value newrelic.appname "Virtual Host 2"
    </IfModule>
  </VirtualHost>

  카피

  위의 예에서 newrelic.appname 은 각 가상 호스트에 대해 다른 값으로 설정됩니다.

  문자열 및 숫자 값의 경우 php_value name VALUE 를 사용합니다. 여기서:

• name PHP INI 설정 에 나열된 대로 수정할 INI 설정의 이름입니다.

• VALUE 특정 가상 호스트에 대해 설정하려는 값입니다.

  문자열 값은 따옴표 " 로 묶어야 합니다.

  부울 설정을 변경하려면 php_flag name VALUE 구문을 사용하십시오. 여기서 name 은 PHP INI 설정 에 나열된 변수 이름이고 VALUE 는 on 또는 off 입니다.

  가상 호스트에 대해 New Relic 에이전트를 완전히 비활성화하려면 부울 플래그를 사용합니다.

  <VirtualHost 192.168.56.78>
    ServerName www.myvhost3.com
    DocumentRoot "/path/to/vhost3/"
    ...
    <IfModule PHP_MODULE>
      php_flag newrelic.enabled off
    </IfModule>
  </VirtualHost>

  카피

.htaccess 파일 내에서 INI 파일 예제의 구문을 사용합니다. 예를 들어:

php_value newrelic.appname "My Blog App"

이를 통해 디렉토리 내에서 디렉토리별로 설정을 제어할 수 있습니다.

이 예에서 웹 서버의 문서 루트는 /data/webroot 입니다. 또한 특수 응용 프로그램을 위한 두 개의 하위 디렉터리가 있습니다.

• 귀하의

  /data/webroot/blog

  에는 블로그 애플리케이션이 포함되어 있습니다.

• 귀하의 /data/webroot/shop 에는 장바구니 애플리케이션이 포함되어 있습니다.

New Relic UI에서 사이트의 세 부분을 모두 별개의 애플리케이션으로 보고하려면:

1. INI 파일에서 기본 응용 프로그램의 이름을 설정합니다.
2. 각 특수 디렉토리에 있는 .htaccess 파일을 사용하여 해당 이름을 재정의합니다.

특정 .htaccess 파일이 없는 웹 서버의 모든 부분(예: /data/webroot/something )은 INI 파일에 정의된 전역 애플리케이션 이름을 사용합니다.

.htaccess 파일 사용 및 보안에 대한 자세한 내용은 Apache HTTP 서버 튜토리얼을 참조하세요.

pool 해당 풀에 대한 요청만 처리하는 전용 작업자 하위 집합입니다. 전용 작업자 하위 항목이 필요하기 때문에 개별 옵션을 설정하려는 가상 호스트나 애플리케이션이 많은 경우 PHP-FPM은 제대로 확장되지 않습니다.

디렉토리별로 PHP-FPM을 구성하려면:

1. INI 파일에서 기본 응용 프로그램 이름을 설정합니다.

2. 두 개의 추가 응용 프로그램에 대해 두 개의 풀을 설정합니다.

3. 해당 풀에서 응용 프로그램 이름 설정을 재정의합니다.

   각 풀에는 고유한 연결 메커니즘이 있어야 합니다(따라서 웹 서버 구성 파일에서 사용할 풀을 식별할 수 있음). 다음은 php-fpm.conf 의 예입니다.

   [app1]
   listen=/tmp/pool-app1.sock
   php_value[newrelic.appname] = "My App 1"
   
   [app2]
   listen=/tmp/pool-app2.sock
   php_value[newrelic.appname] = "My App 2"
   
   [app3]
   listen=/tmp/pool-app3.sock
   php_flag[newrelic.enabled] = off

   카피

   풀당 변수 설정의 일반 형식은 문자열 또는 숫자 변수의 경우 php_value[name] = VALUE 이고 부울 값의 경우 php_flag[name] = VALUE 입니다. 문자열 값은 항상 인용 부호 " 로 묶습니다. 부울 값은 on 또는 off 여야 합니다.

   구성 파일이 설정되면 웹 서버에 웹 사이트의 다른 부분에 대해 다른 풀을 사용하도록 지시해야 합니다. 자세한 내용은 웹 서버 설명서를 참조하십시오.

.user.ini 파일의 CGI/FastCGI에 대한 INI 파일 예제의 구문을 사용할 수 있습니다. 이것은 Apache의 .htaccess 파일과 유사하지만 PHP-FPM에 고유합니다. PHP가 실행되는 디렉토리에서 .user.ini 파일을 검색합니다. 이 기능에 대한 자세한 내용은 PHP user.ini 파일 문서 에서 확인할 수 있습니다.

웹 페이지의 루트 디렉터리에서 다음 단계를 사용하여 앱 이름을 변경합니다.

1. .user.ini 파일 만들기

2. 변경하려는 설정 추가
   newrelic.appname = "New Appname"

3. 파일을 저장합니다.

   기본적으로 .user.ini file 는 5분마다 읽히므로 다시 시작할 필요가 없습니다.

   이는 다음 시나리오에서 유용합니다.

4. 서버 구성이 작동하지 않습니다. NGINX/PHP-FPM 설정에서 FastCGI와 PHP 간의 통신이 부족할 수 있으며
   fastcgi_param PHP_VALUE newrelic.appname="Appname"
   PHP에 도달하지 않습니다.

5. PHP가 suPHP로 구현된 경우와 같이 .htaccess 이(가) 작동하지 않습니다.

다음은 NGINX 위치를 기반으로 FastCGI 관리자에 값을 전달하는 일반적인 절차를 보여주는 NGINX 구성 파일의 작은 부분입니다.

location /blog {
  fastcgi_param PHP_VALUE "newrelic.appname=My Blog";
  ...
}

location /shop {
  fastcgi_param PHP_VALUE "newrelic.appname=Shopping Cart";
  ...
}

location /admin{
  fastcgi_param PHP_VALUE "newrelic.enabled=false";
  ...
}