HOWTO · PHP
PHP에서 루트 디렉토리 경로 찾기
이 튜토리얼에서는 PHP 프로젝트의 루트 디렉토리 경로를 찾는 방법을 소개합니다.
이 페이지의 내용
PHP 애플리케이션에서 ‘루트’라고 부르는 경로는 여러 가지일 수 있습니다. 프로젝트 루트는 애플리케이션이 기준으로 삼는 디렉터리이고, 현재 파일 디렉터리는 PHP 스크립트가 있는 위치이며, 웹 문서 루트는 웹 서버가 요청에 공개하는 디렉터리입니다. 이 경로들은 서로 다를 수 있습니다. 표현식 하나가 언제나 프로젝트 루트를 반환한다고 가정하지 말고, 찾으려는 파일에 맞는 경로를 선택하세요.
예시에서는 프로젝트가 /var/www/html/project에 있고, 최상위에 index.php가 있으며 login.php는 master/ 안에 있다고 가정합니다. 예시 서버의 문서 루트는 /var/www/html입니다. 이 경로들은 예시일 뿐, 실제 서버에서 측정한 값이 아닙니다.
프로젝트 루트와 웹 문서 루트 구분하기
프로젝트 루트는 PHP 설정값이 아니라 애플리케이션에서 정하는 기준입니다. 이 디렉터리에는 애플리케이션 코드와 설정 파일, 그 밖의 파일이 들어갈 수 있습니다. 웹 문서 루트는 서버에서 설정하며 공개 웹 파일을 제공할 위치를 결정합니다. 이 예시에서는 프로젝트가 문서 루트 아래에 있지만, 배포 환경에 따라 프로젝트가 다른 위치에 있거나 공개용 하위 디렉터리가 문서 루트로 설정될 수 있습니다.
두 경로의 차이를 기억하세요. __DIR__와 dirname()는 PHP 파일의 위치를 바탕으로 경로를 계산하지만, $_SERVER['DOCUMENT_ROOT']는 현재 요청에 적용되는 서버 설정을 나타냅니다. 이 값들 중 어느 것도 애플리케이션별 루트를 자동으로 찾아 주지는 않습니다.
현재 파일의 디렉터리를 __DIR__로 가져오기
__DIR__ 매직 상수는 해당 상수가 쓰인 파일이 들어 있는 디렉터리의 절대 경로입니다. 따라서 master/login.php에서는 /var/www/html/project가 아니라 /var/www/html/project/master를 나타냅니다. 스크립트의 위치를 기준으로 결정되므로, 다른 작업 디렉터리에서 이 스크립트를 포함해도 값은 바뀌지 않습니다. 스크립트와 같은 디렉터리나 그 아래에 있는 파일의 경로를 만들 때 사용하세요. 필요하다면 PHP의 경로 구분자를 사용해 상대 경로를 덧붙이면 됩니다.
다음은 단독 실행 예시입니다. 제공된 실행에서는 PHP 파일을 /work에 저장했으므로 두 표현식 모두 해당 디렉터리로 해석되었습니다.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
<?php
echo "Current file directory: ", __DIR__, PHP_EOL;
echo "Directory from __FILE__: ", dirname(__FILE__), PHP_EOL;
?>
Current file directory: /work
Directory from __FILE__: /work
__FILE__는 현재 파일의 전체 경로이고, dirname(__FILE__)는 그 파일이 들어 있는 디렉터리를 반환합니다. 따라서 후자는 구버전 PHP 코드에서 유용한 대안이 될 수 있으며, __DIR__는 의도를 더 직접적으로 나타냅니다. 바이트 그대로 보존된 예제와 출력의 레이블은 영어로 표시됩니다.
dirname()로 상위 디렉터리 찾기
dirname()를 사용하면 알고 있는 파일 경로에서 상위 디렉터리로 이동할 수 있습니다. master/login.php의 __FILE__를 기준으로 한 번 호출하면 master 디렉터리가 나오고, 한 번 더 적용하면 프로젝트 디렉터리가 나옵니다. 예시 디렉터리 구조에서 각 결과는 /var/www/html/project/master와 /var/www/html/project입니다. 중첩 호출은 각 단계를 명확하게 보여 주며, PHP 버전에 따라 사용 가능 여부가 달라지는 선택적 levels 인수에 의존하지 않아도 됩니다.
이 함수는 경로 구성 요소를 따라 위쪽으로 이동합니다. 폴더 이름을 검색하거나 하위 디렉터리로 내려가지는 않습니다. 프로젝트 구조가 바뀌면 필요한 상위 단계의 수도 달라질 수 있습니다. 그 관계를 코드 가까이에 두거나, 여러 파일에서 사용한다면 설정에 프로젝트별 기준 경로를 정의하세요.
$_SERVER['DOCUMENT_ROOT']로 웹 서버의 문서 루트 읽기
웹 요청 중 $_SERVER['DOCUMENT_ROOT']에는 해당 서버에 설정된 문서 루트가 들어 있습니다. 예시 환경에서는 /var/www/html이며, 프로젝트 루트는 /var/www/html/project입니다. 설정된 디렉터리를 기준으로 경로를 만드는 경우처럼 서버의 공개 웹 루트가 필요할 때 이 값을 사용하세요. 프로젝트 루트와 같은 뜻으로 사용하면 안 됩니다.
이 서버 변수는 요청 환경과 서버 설정에 따라 달라집니다. 명령줄 스크립트에서는 없거나 적절하지 않을 수 있고, 배포 환경마다 값이 다를 수 있습니다. 웹 요청 밖에서도 실행될 수 있는 코드라면 이 값이 있는지 확인하세요. 필요한 경로가 서버의 공개 디렉터리가 아니라 프로젝트에 속한다면 __DIR__나 설정된 애플리케이션 기준 경로를 사용하세요.
요약하면, 현재 PHP 파일이 들어 있는 디렉터리에는 __DIR__를 사용하고, 프로젝트 디렉터리처럼 알고 있는 상위 디렉터리에 도달하려면 dirname()를 중첩해 호출하세요. 웹 서버에 설정된 문서 루트가 필요할 때만 $_SERVER['DOCUMENT_ROOT']를 읽으세요. 예시 경로는 설명용으로 취급하고, 스크립트를 실행하는 환경에서 배포별 설정을 확인하세요.