PHP basename() 함수란?
basename() 함수는 파일 경로(path)에서 파일명 부분만 추출해 주는 PHP 내장 함수입니다. 전체 경로 문자열을 매개변수로 전달하면 마지막에 위치한 파일 또는 디렉터리 이름을 반환하며, 파일 업로드 처리나 로그 기록 등 다양한 상황에서 유용하게 활용됩니다.
구문
basename(file_path, suffix)
매개변수
file_path − 확인하려는 파일 또는 디렉터리의 경로를 지정합니다. (필수)
suffix − 결과에서 제거할 파일의 확장자를 지정합니다. 값을 설정하면 해당 확장자가 제외된 파일명이 반환됩니다. (선택)
반환 값
basename() 함수는 경로에서 추출한 파일명(기본 이름)을 문자열 형태로 반환합니다.
예제 1: 확장자를 포함한 파일명 추출
다음은 "/backup/myfiles/new.php" 경로에서 파일명을 추출하는 예제입니다. suffix 매개변수를 지정하지 않았으므로 확장자(.php)까지 함께 출력됩니다.
<?php
$file_path = "/backup/myfiles/new.php";
// 확장자를 포함한 파일명 출력
echo basename($file_path);
?>
출력 결과
new.php
예제 2: 확장자를 제외한 파일명 추출
이번에는 두 번째 매개변수(suffix)에 ".php"를 지정하여 확장자를 제거한 순수한 파일명만 출력하는 예제입니다.
<?php
$file_path = "/backup/myfiles/new.php";
// 확장자를 제외한 파일명 출력
echo basename($file_path, ".php");
?>
출력 결과
new
참고 사항
basename() 함수는 Windows의 백슬래시(\)와 Unix 계열의 슬래시(/) 구분자를 모두 인식합니다. 따라서 어떤 운영체제 환경에서 생성된 경로 문자열이든 안전하게 파일명을 추출할 수 있습니다.