PHP dirname() 함수 완벽 정리 – 파일 경로에서 디렉터리 이름 추출하는 방법

PHP의 dirname() 함수는 지정된 파일 경로에서 디렉터리(폴더) 이름만 추출하여 반환하는 내장 함수입니다. 예를 들어 전체 파일 경로가 주어졌을 때, 파일명을 제외한 상위 디렉터리 경로를 손쉽게 얻을 수 있습니다.

만약 경로에 슬래시(/)가 포함되어 있지 않다면, 함수는 점('.')을 반환합니다. 이는 현재 작업 중인 디렉터리(current directory)를 의미합니다.

문법(Syntax)

dirname(file_path)

매개변수(Parameters)

• file_path − 디렉터리 이름을 확인할 대상 파일의 경로입니다. 필수로 지정해야 하는 값입니다.

반환값(Return)

dirname() 함수는 입력된 경로에서 추출한 디렉터리의 경로 문자열을 반환합니다.

예제 1: Windows 스타일 경로

<?php
   $file_path = "D:/amit/java.docx";
   $dir_name = dirname($file_path);
   echo "디렉터리 이름: $dir_name\n";
?>

출력 결과

디렉터리 이름: D:/amit

위 예제에서는 파일명 java.docx를 제외한 D:/amit라는 디렉터리 경로가 반환된 것을 확인할 수 있습니다.

이번에는 다른 예제를 살펴보겠습니다.

예제 2: 절대 경로(Absolute Path)

<?php
   $file_path = "/amit/java.docx";
   $dir_name = dirname($file_path);
   echo "디렉터리 이름: $dir_name\n";
?>

출력 결과

디렉터리 이름: /amit

참고 사항

dirname() 함수는 PHP 4 이상 모든 버전에서 사용할 수 있으며, PHP 7부터는 선택적인 두 번째 매개변수인 levels를 통해 몇 단계 위의 부모 디렉터리까지 거슬러 올라갈지 지정할 수도 있습니다. 예를 들어 dirname($path, 2)처럼 사용하면 두 단계 상위 디렉터리를 반환합니다.