scandir 함수

(PHP 5, PHP 7, PHP 8)

scandir — 지정된 경로 내의 파일 및 디렉토리 나열


설명

scandir(string $directory, int $sorting_order = SCANDIR_SORT_ASCENDING, ?resource $context = null): array|false

directory에서 파일 및 디렉토리의 배열을 반환합니다.


매개변수

directory
스캔할 디렉터리입니다.
sorting_order
기본적으로 정렬된 순서는 알파벳 오름차순입니다. 선택적 sorting_orderSCANDIR_SORT_DESCENDING으로 설정된 경우 정렬 순서는 알파벳 내림차순입니다. SCANDIR_SORT_NONE으로 설정하면 결과가 정렬되지 않습니다.
context
context 매개변수에 대한 설명은 매뉴얼의 스트림 섹션을 참조하십시오.

반환 값

성공하면 파일 이름 배열을 반환하고 실패하면 false를 반환합니다. directory가 디렉토리가 아니면 부울 false가 리턴되고 레벨 E_WARNING의 오류가 생성됩니다.


변경 로그

버전 설명
8.0.0 context는 이제 nullable입니다.

Examples

예제 #1 간단한 scandir() 예제

                  
<?php
$dir    = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, 1);

print_r($files1);
print_r($files2);
?>
                  
                

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

Array
(
    [0] => .
    [1] => ..
    [2] => bar.php
    [3] => foo.txt
    [4] => somedir
)
Array
(
    [0] => somedir
    [1] => foo.txt
    [2] => bar.php
    [3] => ..
    [4] => .
)
                

메모

fopen 래퍼가 활성화된 경우 URL을 이 함수와 함께 파일 이름으로 사용할 수 있습니다. 파일 이름을 지정하는 방법에 대한 자세한 내용은 fopen()을 참조하십시오. 다양한 래퍼가 가지고 있는 기능, 사용법에 대한 참고 사항, 제공할 수 있는 사전 정의된 변수에 대한 정보에 대한 링크는 지원되는 프로토콜 및 래퍼를 참조하세요.


기타

  • opendir() - 디렉토리 핸들 열기
  • readdir() - 디렉토리 핸들에서 항목 읽기
  • glob() - 패턴과 일치하는 경로 이름 찾기
  • is_dir() - 파일 이름이 디렉토리인지 여부를 알려줍니다.
  • sort() - 배열을 오름차순으로 정렬