파일 작업

CodeIgniter는 SplFileInfo 클래스를 감싸는 File 클래스를 제공하고 추가적으로 편리한 메소드를 제공합니다. 이 클래스는 업로드 파일과 images의 기본(base) 클래스입니다.

파일 인스턴스 얻기 

생성자의 파일 경로를 전달하여 새 File 인스턴스를 만듭니다. 기본적으로 파일은 존재하지 않아도 됩니다. 그러나 추가 인수로 “true”를 전달하여 파일이 존재하는지 확인하고, 파일이 없으면 FileNotFoundException()을 던질 수 있습니다.

<?php

$file = new \CodeIgniter\Files\File($path);

Spl의 장점 활용 

인스턴스가 있으면 다음을 포함하여 SplFileInfo 클래스의 모든 기능을 사용할 수 있습니다.

<?php

// Get the file's basename
echo $file->getBasename();
// Get last modified time
echo $file->getMTime();
// Get the true real path
echo $file->getRealPath();
// Get the file permissions
echo $file->getPerms();

// Write CSV rows to it.
if ($file->isWritable()) {
    $csv = $file->openFile('w');

    foreach ($rows as $row) {
        $csv->fputcsv($row);
    }
}

새로운 기능 

SplFileInfo 클래스의 모든 메소드 외에도 몇 가지 새로운 도구가 제공됩니다.

getRandomName()

getRandomName() 메소드를 사용하여 현재 타임 스탬프와 미리 지정된 암호로 안전한 임의의 파일 이름을 생성할 수 있습니다. 파일을 이동할 때 파일 이름을 알아볼 수 없도록 이름을 바꾸는 데 특히 유용합니다.

<?php

// Generates something like: 1465965676_385e33f741.jpg
$newName = $file->getRandomName();

getSize()

업로드된 파일의 크기를 바이트 단위로 반환합니다.

<?php

$size = $file->getSize(); // 256901

getSizeByUnit()

업로드된 파일의 기본 크기를 바이트 단위로 반환합니다. 첫 번째 매개 변수로 ‘kb’ 또는 ‘mb’를 전달하여 킬로바이트 또는 메가 바이트로 변환할 수 있습니다.

<?php

$bytes     = $file->getSizeByUnit(); // 256901
$kilobytes = $file->getSizeByUnit('kb'); // 250.880
$megabytes = $file->getSizeByUnit('mb'); // 0.245

getMimeType()

파일의 미디어 타입 (mime type)을 얻어 옵니다. 파일 유형을 결정할 때 가능한 한 안전한 것으로 간주되는 메소드를 사용합니다

<?php

$type = $file->getMimeType();

echo $type; // image/png

guessExtension()

신뢰할 수 있는 getMimeType() 메소드를 기반으로 파일 확장자를 판별합니다. MIME 형식을 알 수 없으면 null을 반환합니다. 이 방법은 파일 이름으로 제공되는 확장자를 사용하는 것보다 더 신뢰할 수 있습니다. 확장을 결정하기 위해 app/Config/Mimes.php의 값을 사용합니다

<?php

// Returns 'jpg' (WITHOUT the period)
$ext = $file->guessExtension();

파일 이동 

각 파일은 적절하게 이름이 지정된 move() 메소드를 사용하여 새 위치로 이동할 수 있습니다. 이것은 디렉토리를 사용하여 파일을 첫 번째 매개 변수로 이동시킵니다

<?php

$file->move(WRITEPATH . 'uploads');

기본적으로 원래 파일 이름이 사용됩니다. 두 번째 매개 변수에 새 파일 이름을 지정할 수 있습니다

<?php

$newName = $file->getRandomName();
$file->move(WRITEPATH . 'uploads', $newName);

move() 메소드는 재배치된 파일에 대한 새 File 인스턴스를 리턴하므로 이동된 위치가 필요한 경우 결과를 캡처해야 합니다.

<?php

$file = $file->move(WRITEPATH . 'uploads');

파일 Collections

파일 그룹을 사용하는 작업은 번거로울 수 있으므로 파일 시스템 전체에서 파일 그룹을 쉽게 찾고 작업할 수 있는 FileCollection 클래스를 제공합니다. 가장 기본적인 FileCollection은 사용자가 설정하거나 빌드하는 파일의 색인(index)입니다.

<?php

$files = new FileCollection([
    FCPATH . 'index.php',
    ROOTPATH . 'spark',
]);
$files->addDirectory(APPPATH . 'Filters');

작업할 파일을 입력한 후 파일을 제거하거나 필터링 명령을 사용하여 특정 정규식 또는 글로벌 스타일 패턴과 일치하는 파일을 제거하거나 유지할 수 있습니다.

<?php

$files->removeFile(APPPATH . 'Filters/DevelopToolbar');

$files->removePattern('#\.gitkeep#');
$files->retainPattern('*.php');

수집이 완료되면 get()을 사용하여 최종 파일 경로 목록을 검색하거나 FileCollection을 통해 파일의 수를 알 수 있고, 각 파일에 직접 작업할 수 있습니다.

<?php

echo 'My files: ' . implode(PHP_EOL, $files->get());
echo 'I have ' . count($files) . ' files!';

foreach ($files as $file) {
    echo 'Moving ' . $file->getBasename() . ', ' . $file->getSizeByUnit('mb');
    $file->move(WRITABLE . $file->getRandomName());
}

다음은 FileCollection을 사용하는 구체적인 방법입니다.

Collection 

__construct(string[] $files = [])

생성자에 collection으로 사용할 파일 경로를 옵션 배열로 지정 할 수 있습니다. 지정된 파일은 add() 메소드에 전달되며 $files의 자식 클래스에서 제공한 파일은 그대로 유지됩니다.

define()

자식 클래스가 자신의 초기 파일을 정의할 수 있습니다. 이 메서드는 생성자에 의해 호출되며 메소드를 사용할 필요 없이 미리 정의된 컬렉션을 허용합니다.

<?php

use CodeIgniter\Files\FileCollection;

class ConfigCollection extends FileCollection
{
    protected function define(): void
    {
        $this->add(APPPATH . 'Config', true)->retainPattern('*.php');
    }
}

이제 ConfigCollection을 사용하여 매번 collection 메소드를 다시 호출할 필요 없이 앱의 모든 구성(config) 파일에 액세스할 수 있습니다.

<?php

$files = new FileCollection();
$files->add(APPPATH . 'Config', true); // Adds all Config files and directories

$files->removePattern('*tion.php'); // Would remove Encryption.php, Validation.php, and boot/production.php
$files->removePattern('*tion.php', APPPATH . 'Config/boot'); // Would only remove boot/production.php

$files->retainPattern('#A.+php$#'); // Would keep only Autoload.php
$files->retainPattern('#d.+php$#', APPPATH . 'Config/boot'); // Would keep everything but boot/production.php and boot/testing.php

파일 검색 

get(): string[]

로드된 모든 입력 파일의 배열을 반환합니다.

Note

FileCollection은 IteratorAggregate 이므로 직접 사용할 수 있습니다 (예: foreach ($collection as $file)).

파일 작업

파일 인스턴스 얻기 

Spl의 장점 활용 

새로운 기능 

getRandomName()

getSize()

getSizeByUnit()

getMimeType()

guessExtension()

파일 이동 

파일 Collections

Collection 

__construct(string[] $files = [])

define()

set(array $files)

Inputting Files 

add(string[]|string $paths, bool $recursive = true)

addFile(string $file) / addFiles(array $files)

removeFile(string $file) / removeFiles(array $files)

addDirectory(string $directory, bool $recursive = false)

addDirectories(array $directories, bool $recursive = false)

파일 필터링 

removePattern(string $pattern, string $scope = null)

retainPattern(string $pattern, string $scope = null)

파일 검색 

get(): string[]