PHP의 parse_ini_string() 함수 – ini 설정 문자열 파싱하기

parse_ini_string() 함수는 ini 형식으로 작성된 설정 문자열을 해석(파싱)하는 PHP 내장 함수입니다. 파싱에 성공하면 설정값들을 연관 배열(associative array) 형태로 반환하며, 실패하면 FALSE를 반환합니다.

이름이 비슷한 parse_ini_file() 함수가 파일 경로를 인자로 받는 것과 달리, parse_ini_string()은 문자열 그 자체를 인자로 받는다는 점에 유의하세요. 따라서 파일의 내용을 파싱하려면 file_get_contents() 등으로 먼저 문자열로 읽어 들인 뒤 이 함수에 전달해야 합니다.

문법

parse_ini_string(ini_string, process_sections, scanner_mode)

매개변수

ini_string − 파싱할 ini 형식의 설정 문자열입니다.
process_sections − TRUE로 설정하면 섹션 이름과 해당 설정값을 모두 포함하는 다차원 배열을 반환받을 수 있습니다.
scanner_mode − (선택 사항) 값의 스캔 방식을 지정합니다. 기본값은 INI_SCANNER_NORMAL이며, INI_SCANNER_RAW를 사용하면 값을 해석하지 않고 원본 그대로 반환합니다.

반환값

파싱에 성공하면 설정값들을 담은 연관 배열을 반환하고, 실패하면 FALSE를 반환합니다.

예제

다음과 같은 내용의 "demo.ini" 파일이 있다고 가정해 보겠습니다.

[names]
one = Anne
[urls]
host1 = "https://www.example1.com"

이 파일의 내용을 읽어 parse_ini_string()으로 파싱하는 예제입니다.

<?php
   $ini = file_get_contents("demo.ini");
   print_r(parse_ini_string($ini));
?>

출력 결과

Array
(
   [one] => Anne
   [host1] => https://www.example1.com
)

두 번째 매개변수인 process_sections를 TRUE로 지정하면 섹션 정보까지 포함된 다차원 배열 형태로 결과를 얻을 수 있으므로, 섹션이 많은 대규모 설정 파일을 다룰 때 특히 유용합니다.