pathinfo 함수

(PHP 4 >= 4.0.3, PHP 5, PHP 7, PHP 8)

pathinfo — 파일 경로에 대한 정보를 반환합니다.


설명

pathinfo(string $path, int $flags = PATHINFO_ALL): array|string

pathinfo()path에 대한 정보를 반환합니다. flags에 따라 연관 배열 또는 문자열입니다.

메모: 현재 경로 정보를 검색하는 방법에 대한 정보는 사전 정의된 예약 변수 섹션을 참조하십시오.

메모: pathinfo()는 입력 문자열에 대해 순진하게 작동하며 실제 파일 시스템이나 ".."와 같은 경로 구성 요소를 인식하지 못합니다.

주의 pathinfo()는 로케일을 인식하므로 멀티바이트 문자가 포함된 경로를 올바르게 구문 분석하려면 setlocale() 함수를 사용하여 일치하는 로케일을 설정해야 합니다.


매개변수

path
구문 분석할 경로입니다.
flags
있는 경우 반환할 특정 요소를 지정합니다. PATHINFO_DIRNAME, PATHINFO_BASENAME, PATHINFO_EXTENSION 또는 PATHINFO_FILENAME 중 하나입니다.

flags를 지정하지 않으면 사용 가능한 모든 요소를 ​​반환합니다.


반환 값

flags 매개변수가 전달되지 않으면 dirname, basename, extension(있는 경우) 및 filename 요소를 포함하는 연관 배열이 반환됩니다.

참고: path에 둘 이상의 확장자가 있는 경우 PATHINFO_EXTENSION은 마지막 확장자만 반환하고 PATHINFO_FILENAME은 마지막 확장자만 제거합니다. (아래 첫 번째 예 참조).

참고: path에 확장자가 없으면 확장 요소가 반환되지 않습니다(아래 두 번째 예 참조).

참고: path의 기본 이름이 점으로 시작하는 경우 다음 문자는 확장자로 해석되고 파일 이름은 비어 있습니다(아래 세 번째 예 참조).

flags가 있는 경우 요청된 요소가 포함된 문자열을 반환합니다.


Examples

예제 #1 pathinfo() 예제

                  
<?php
$path_parts = pathinfo('/www/htdocs/inc/lib.inc.php');

echo $path_parts['dirname'], "\n";
echo $path_parts['basename'], "\n";
echo $path_parts['extension'], "\n";
echo $path_parts['filename'], "\n";
?>
                  
                

위의 예는 다음을 출력합니다.

/www/htdocs/inc
lib.inc.php
php
lib.inc
                

예제 #2 null과 확장 없음의 차이를 보여주는 pathinfo() 예제

                  
<?php
$path_parts = pathinfo('/path/emptyextension.');
var_dump($path_parts['extension']);

$path_parts = pathinfo('/path/noextension');
var_dump($path_parts['extension']);
?>
                  
                

위의 예는 다음과 유사한 결과를 출력합니다.

string(0) ""

Notice: Undefined index: extension in test.php on line 6
NULL
                

예제 #3 점 파일에 대한 pathinfo() 예제

                  
<?php
print_r(pathinfo('/some/path/.test'));
?>
                  
                

위의 예는 다음과 유사한 결과를 출력합니다.

Array
(
    [dirname] => /some/path
    [basename] => .test
    [extension] => test
    [filename] =>
)
                

기타

  • dirname() - 상위 디렉토리의 경로를 반환
  • basename() - 경로의 후행 이름 구성 요소를 반환합니다.
  • parse_url() - URL을 구문 분석하고 해당 구성 요소를 반환합니다.
  • realpath() - 정규화된 절대 경로 이름을 반환합니다.