PHP getbrowser() 함수 사용을 위한 browscap 설정 및 오류 해결 가이드

• 목록
• 스크랩

PHP get_browser() 함수 사용을 위한 browscap 설정 및 오류 해결 가이드

PHP 환경에서 get_browser() 함수를 활용해 방문자의 브라우저 및 OS 정보를 확인하려는 그누보드 운영자·개발자를 위해, php.ini 설정 방법부터 필수 라이브러리 연동 및 오류 대처법까지 구체적으로 안내합니다.

php.ini 파일의 browscap 설정 방법

PHP에서 get_browser() 함수를 사용하려면 PHP 매뉴얼에 따라 시스템의 php.ini 파일 내 browscap 설정이 올바른 browscap.ini 파일의 경로를 가리키도록 설정해야 한다.

1. 설정 전 확인 사항

• get_browser() 함수는 기본적으로 제공되지 않으며, php.ini에 browscap.ini 경로가 올바르게 지정되어야 정상 작동한다.
• browscap.ini 파일은 PHP에 번들로 포함되어 있지 않으므로 별도로 준비해야 한다.

2. php.ini 설정 변경

• 서버의 php.ini 파일에서 browscap 항목을 찾아 파일이 위치한 실제 시스템 경로(예: /etc/browscap.ini 등)로 지정한다.
• 예시:

  browscap = "/경로/상세/browscap.ini"

3. 적용 후 확인

• 설정을 변경한 뒤에는 웹 서버를 재시작하고 phpinfo() 등을 통해 browscap 설정값이 올바르게 적용되었는지 확인한다.

php_browscap.ini 파일 다운로드 및 서버 저장 위치

PHP의 get_browser() 함수를 사용하려면 php_browscap.ini 또는 lite_php_browscap.ini 파일이 필요하다. 2개 파일이 모두 필요한 것은 아니며 사용 용도에 따라 선택하여 사용할 수 있다.

다운로드 방법

• php_browscap.ini 또는 lite_php_browscap.ini 파일을 다운로드하여 준비한다. 파일은 사용자 업데이트를 기반으로 데이터베이스가 유지된다.

서버 저장 위치

• 다운로드받은 파일을 PHP의 lib 디렉토리에 저장하거나, 웹서버 설정 경로(/usr/local/apache/conf/ 등)에 위치시킬 수 있다.
• 파일을 저장한 뒤에는 시스템의 php.ini 파일 설정에서 해당 파일의 올바른 경로를 가리키도록 지정해야 한다.

그누보드 환경에서 Browscap 업데이트 및 기능 활용

그누보드 관리자 페이지와 설정 파일에서 Browscap 관련 기능을 활용하여 접속 브라우저, OS, 접속 기기 등의 상세 정보를 관리할 수 있습니다.

1. 관련 설정 및 버전 조건

• PHP 버전 확인: Browscap 라이브러리는 PHP 5.3 이상 버전에서만 사용할 수 있으며, 하위 버전의 PHP를 사용하는 경우에는 Browscap 업데이트 메뉴가 활성화되지 않습니다.
• 환경설정 파일(config.php):
  • define('G5_BROWSCAP_USE', true); 항목을 통해 Browscap 사용 여부를 설정합니다.
  • 접속자 기록 시 항상 Browscap으로 업데이트하여 정보를 처리하려면 define('G5_VISIT_BROWSCAP_USE', false); 부분을 true로 변경하여 활용할 수 있습니다.

2. 관리자 메뉴 및 기능

• Browscap 업데이트 (adm/browscap.php): 최고관리자로 로그인 후 관리자 페이지의 관련 메뉴를 통해 라이브러리를 최신 버전으로 유지할 수 있습니다.
• 접속로그 변환 (adm/browscap_convert.php): 저장된 접속 로그를 변환하는 기능을 제공하며, 필요에 따라 처리할 갯수를 지정하는 등의 커스텀 팁을 적용할 수 있습니다.

상황별 판단 및 행동 지침

내 상황	선택 기준	다음 행동
PHP get_browser() 실행 시 오류 발생	php.ini 내 browscap 경로 설정 누락 또는 파일 부재	php_browscap.ini 파일을 서버에 저장하고 php.ini에 해당 경로를 지정한 뒤 웹서버 재시작
그누보드에서 Browscap 업데이트 메뉴가 보이지 않음	PHP 버전이 5.3 미만인지 확인	PHP 버전 업그레이드 또는 config.php 내 G5_BROWSCAP_USE 설정값 확인
접속 로그 변환이 너무 느리거나 번거로움	대량의 로그 처리 필요	adm/browscap_convert.php 호출 시 URL 파라미터(?rows=숫자)를 활용하여 처리 단위 조정

실전 FAQ

Q. php_browscap.ini와 lite_php_browscap.ini 중 무엇을 써야 하나요?

• 두 파일 모두 필수인 것은 아니며, 용도에 따라 선택합니다. 가벼운 환경에서는 lite 버전을 사용해도 무방합니다.

Q. 설정 후에도 함수가 작동하지 않는다면?

• 설정 변경 후 웹서버를 재시작했는지 확인하십시오. phpinfo()를 통해 browscap 항목에 실제 파일 경로가 올바르게 로드되었는지 확인하는 것이 가장 정확합니다.

Q. php_browscap.ini 파일 내 세미콜론(;)으로 인한 구문 오류가 발생합니다.

• 일부 환경에서 parse_ini_file 사용 시 세미콜론이 오류를 유발할 수 있습니다. 이 경우 해당 파일 내 [ ] 괄호 안의 세미콜론 앞에 역슬래시(\)를 붙여 이스케이프 처리를 시도해 볼 수 있습니다.

참고자료

기타 참고자료

• m.blog.naver.com — 브라우저 정보 및 OS정보를 가져오자. get_browser() : 네이버 블로그
• phpschool.com — PHPSCHOOL-Class > Tip&Tech
• https://xinet.kr/?p=3196
• sir.kr — 그누보드5 매뉴얼
• sir.kr — Browscap 업데이트란 무엇 인가요 - SIR - 개발자 커뮤니티
• sir.kr — browscap 업데이트 처리할 갯수 지정하여 사용하기 - SIR - 개발자 커뮤니티
• sir.kr — 접속로그 적용 / Browscap 업데이트 접속로그 변환 자동스케줄링? - SIR - 개발자 커뮤니티
• lab.naminsik.com — php - Browscap.ini 사용시 php 5에서 syntax 에러 발생시 - 개발자 남인식 Lab.