371 lines
14 KiB
PHP
371 lines
14 KiB
PHP
<?php
|
|
|
|
namespace Tests\Unit\Helpers;
|
|
|
|
use App\Extension\Helpers\FilePermissionHelper;
|
|
use Illuminate\Support\Facades\File;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* FilePermissionHelper 단위 테스트
|
|
*
|
|
* copyDirectory의 퍼미션 보존, excludes 처리, removeOrphans 동작을 검증합니다.
|
|
*/
|
|
class FilePermissionHelperTest extends TestCase
|
|
{
|
|
/**
|
|
* 테스트에서 사용하는 임시 디렉토리 목록 (tearDown에서 정리)
|
|
*
|
|
* @var array<string>
|
|
*/
|
|
private array $tempDirs = [];
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
foreach ($this->tempDirs as $dir) {
|
|
if (File::isDirectory($dir)) {
|
|
File::deleteDirectory($dir);
|
|
}
|
|
}
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
/**
|
|
* 테스트용 임시 디렉토리를 생성합니다.
|
|
*
|
|
* @return string 생성된 디렉토리 경로
|
|
*/
|
|
private function createTempDir(): string
|
|
{
|
|
$dir = storage_path('test_fileperm_'.uniqid());
|
|
File::ensureDirectoryExists($dir);
|
|
$this->tempDirs[] = $dir;
|
|
|
|
return $dir;
|
|
}
|
|
|
|
// ========================================================================
|
|
// removeOrphans 기본 동작 (false) — 소스에 없는 파일 유지
|
|
// ========================================================================
|
|
|
|
/**
|
|
* removeOrphans 기본값(false)일 때 소스에 없는 대상 파일이 유지되는지 검증합니다.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_directory_does_not_remove_orphans_by_default(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
// 소스: file_a.txt만 존재
|
|
File::put($source.DIRECTORY_SEPARATOR.'file_a.txt', 'source_a');
|
|
|
|
// 대상: file_a.txt + orphan.txt (소스에 없는 파일)
|
|
File::put($dest.DIRECTORY_SEPARATOR.'file_a.txt', 'old_a');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'orphan.txt', 'orphan_content');
|
|
|
|
FilePermissionHelper::copyDirectory($source, $dest);
|
|
|
|
// file_a.txt는 소스 내용으로 덮어쓰기
|
|
$this->assertEquals('source_a', File::get($dest.DIRECTORY_SEPARATOR.'file_a.txt'));
|
|
|
|
// orphan.txt는 유지 (기본 동작)
|
|
$this->assertTrue(File::exists($dest.DIRECTORY_SEPARATOR.'orphan.txt'));
|
|
$this->assertEquals('orphan_content', File::get($dest.DIRECTORY_SEPARATOR.'orphan.txt'));
|
|
}
|
|
|
|
// ========================================================================
|
|
// removeOrphans=true — 소스에 없는 파일 삭제
|
|
// ========================================================================
|
|
|
|
/**
|
|
* removeOrphans=true일 때 소스에 없는 파일이 삭제되는지 검증합니다.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_directory_removes_orphans_when_enabled(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
// 소스: file_a.txt만 존재
|
|
File::put($source.DIRECTORY_SEPARATOR.'file_a.txt', 'source_a');
|
|
|
|
// 대상: file_a.txt + orphan.txt
|
|
File::put($dest.DIRECTORY_SEPARATOR.'file_a.txt', 'old_a');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'orphan.txt', 'orphan_content');
|
|
|
|
FilePermissionHelper::copyDirectory($source, $dest, removeOrphans: true);
|
|
|
|
// file_a.txt는 소스 내용으로 덮어쓰기
|
|
$this->assertEquals('source_a', File::get($dest.DIRECTORY_SEPARATOR.'file_a.txt'));
|
|
|
|
// orphan.txt는 삭제됨
|
|
$this->assertFalse(File::exists($dest.DIRECTORY_SEPARATOR.'orphan.txt'));
|
|
}
|
|
|
|
// ========================================================================
|
|
// removeOrphans=true — 소스에 없는 디렉토리도 재귀 삭제
|
|
// ========================================================================
|
|
|
|
/**
|
|
* removeOrphans=true일 때 소스에 없는 디렉토리가 재귀 삭제되는지 검증합니다.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_directory_removes_orphan_directories(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
// 소스: subdir_a/file.txt만 존재
|
|
File::ensureDirectoryExists($source.DIRECTORY_SEPARATOR.'subdir_a');
|
|
File::put($source.DIRECTORY_SEPARATOR.'subdir_a'.DIRECTORY_SEPARATOR.'file.txt', 'content');
|
|
|
|
// 대상: subdir_a/ + orphan_dir/ (소스에 없는 디렉토리)
|
|
File::ensureDirectoryExists($dest.DIRECTORY_SEPARATOR.'subdir_a');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'subdir_a'.DIRECTORY_SEPARATOR.'file.txt', 'old');
|
|
File::ensureDirectoryExists($dest.DIRECTORY_SEPARATOR.'orphan_dir');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'orphan_dir'.DIRECTORY_SEPARATOR.'deep.txt', 'deep_content');
|
|
|
|
FilePermissionHelper::copyDirectory($source, $dest, removeOrphans: true);
|
|
|
|
// subdir_a는 유지되고 내용 덮어쓰기
|
|
$this->assertTrue(File::isDirectory($dest.DIRECTORY_SEPARATOR.'subdir_a'));
|
|
$this->assertEquals('content', File::get($dest.DIRECTORY_SEPARATOR.'subdir_a'.DIRECTORY_SEPARATOR.'file.txt'));
|
|
|
|
// orphan_dir는 재귀 삭제
|
|
$this->assertFalse(File::isDirectory($dest.DIRECTORY_SEPARATOR.'orphan_dir'));
|
|
}
|
|
|
|
// ========================================================================
|
|
// removeOrphans=true — 하위 디렉토리 내 orphan 파일도 삭제
|
|
// ========================================================================
|
|
|
|
/**
|
|
* removeOrphans=true일 때 하위 디렉토리 내 소스에 없는 파일도 삭제되는지 검증합니다.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_directory_removes_orphans_in_subdirectories(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
// 소스: sub/keep.txt만 존재
|
|
File::ensureDirectoryExists($source.DIRECTORY_SEPARATOR.'sub');
|
|
File::put($source.DIRECTORY_SEPARATOR.'sub'.DIRECTORY_SEPARATOR.'keep.txt', 'keep');
|
|
|
|
// 대상: sub/keep.txt + sub/orphan.txt
|
|
File::ensureDirectoryExists($dest.DIRECTORY_SEPARATOR.'sub');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'sub'.DIRECTORY_SEPARATOR.'keep.txt', 'old');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'sub'.DIRECTORY_SEPARATOR.'orphan.txt', 'orphan');
|
|
|
|
FilePermissionHelper::copyDirectory($source, $dest, removeOrphans: true);
|
|
|
|
// keep.txt는 덮어쓰기
|
|
$this->assertEquals('keep', File::get($dest.DIRECTORY_SEPARATOR.'sub'.DIRECTORY_SEPARATOR.'keep.txt'));
|
|
|
|
// sub/orphan.txt는 삭제
|
|
$this->assertFalse(File::exists($dest.DIRECTORY_SEPARATOR.'sub'.DIRECTORY_SEPARATOR.'orphan.txt'));
|
|
}
|
|
|
|
// ========================================================================
|
|
// removeOrphans=true + excludes — 제외 대상은 삭제하지 않음
|
|
// ========================================================================
|
|
|
|
/**
|
|
* removeOrphans=true이더라도 excludes 대상은 삭제하지 않는지 검증합니다.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_directory_preserves_excluded_orphans(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
// 소스: file_a.txt만 존재
|
|
File::put($source.DIRECTORY_SEPARATOR.'file_a.txt', 'source_a');
|
|
|
|
// 대상: file_a.txt + vendor/ + node_modules/ (excludes 대상)
|
|
File::put($dest.DIRECTORY_SEPARATOR.'file_a.txt', 'old_a');
|
|
File::ensureDirectoryExists($dest.DIRECTORY_SEPARATOR.'vendor');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'vendor'.DIRECTORY_SEPARATOR.'autoload.php', 'vendor_content');
|
|
File::ensureDirectoryExists($dest.DIRECTORY_SEPARATOR.'node_modules');
|
|
File::put($dest.DIRECTORY_SEPARATOR.'node_modules'.DIRECTORY_SEPARATOR.'package.json', 'nm_content');
|
|
|
|
$excludes = ['vendor', 'node_modules'];
|
|
|
|
FilePermissionHelper::copyDirectory($source, $dest, excludes: $excludes, removeOrphans: true);
|
|
|
|
// excludes 대상은 삭제되지 않음
|
|
$this->assertTrue(File::isDirectory($dest.DIRECTORY_SEPARATOR.'vendor'));
|
|
$this->assertTrue(File::isDirectory($dest.DIRECTORY_SEPARATOR.'node_modules'));
|
|
$this->assertTrue(File::exists($dest.DIRECTORY_SEPARATOR.'vendor'.DIRECTORY_SEPARATOR.'autoload.php'));
|
|
}
|
|
|
|
// ========================================================================
|
|
// 기존 파일 퍼미션 보존 확인
|
|
// ========================================================================
|
|
|
|
/**
|
|
* 기존 파일의 퍼미션이 보존되는지 검증합니다. (Linux/Mac에서만 의미있음)
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_copy_file_preserves_permissions_on_existing_files(): void
|
|
{
|
|
$source = $this->createTempDir();
|
|
$dest = $this->createTempDir();
|
|
|
|
$srcFile = $source.DIRECTORY_SEPARATOR.'script.sh';
|
|
$destFile = $dest.DIRECTORY_SEPARATOR.'script.sh';
|
|
|
|
File::put($srcFile, '#!/bin/bash\necho new');
|
|
File::put($destFile, '#!/bin/bash\necho old');
|
|
|
|
// Windows에서는 chmod가 제한적이므로 기본 동작만 검증
|
|
$originalPerms = fileperms($destFile);
|
|
|
|
FilePermissionHelper::copyFile($srcFile, $destFile);
|
|
|
|
// 내용은 소스로 교체
|
|
$this->assertStringContainsString('new', File::get($destFile));
|
|
|
|
// 퍼미션 복원 시도 확인 (Windows에서는 값이 같을 수 있음)
|
|
$this->assertEquals($originalPerms, fileperms($destFile));
|
|
}
|
|
|
|
// ========================================================================
|
|
// syncGroupWritability — sudo 업데이트 시 발생한 그룹 쓰기 권한 비대칭 정상화
|
|
// (코어 7.0.0-beta.3 도입)
|
|
//
|
|
// 배경: sudo root 로 실행된 코어 업데이트가 storage/framework/cache 하위에
|
|
// umask 022 로 신규 디렉토리(0755 drwxr-xr-x) 를 생성한 뒤 chownRecursive 가
|
|
// 소유자만 jjh:www-data 로 복원하면, www-data 그룹에 쓰기 권한이 없어
|
|
// php-fpm 이 cache 파일 생성 실패 (Permission denied).
|
|
//
|
|
// 정책: 루트가 g+w 면 하위 항목 중 g-w 인 디렉토리·파일을 g+w 로 승격.
|
|
// 다른 비트 무변경. 루트가 g-w 면 no-op (운영자 정책 보존).
|
|
//
|
|
// 검증 대상은 chmod / fileperms 가 의미를 갖는 POSIX 환경 전용. Windows
|
|
// 로컬은 자동 스킵하며, 실제 Linux CI / 운영 서버에서 의미 있는 검증 수행.
|
|
// ========================================================================
|
|
|
|
/**
|
|
* Linux/macOS 환경 감지. Windows / chmod 미지원 환경은 스킵.
|
|
*/
|
|
private function assertPosixOrSkip(): void
|
|
{
|
|
if (DIRECTORY_SEPARATOR !== '/' || ! function_exists('posix_getuid')) {
|
|
$this->markTestSkipped('chmod 검증은 POSIX 환경 전용 (Windows 로컬 자동 스킵)');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 루트 0775 + 자식·손자 0755 + 파일 0644 → 호출 후 자식·손자·파일 모두 g+w 승격.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_sync_group_writability_recovers_child_dirs_and_files(): void
|
|
{
|
|
$this->assertPosixOrSkip();
|
|
|
|
$root = $this->createTempDir();
|
|
chmod($root, 0775);
|
|
|
|
$child = $root.DIRECTORY_SEPARATOR.'cache_hash_2c';
|
|
mkdir($child, 0755);
|
|
|
|
$grandchild = $child.DIRECTORY_SEPARATOR.'ab';
|
|
mkdir($grandchild, 0755);
|
|
|
|
$file = $grandchild.DIRECTORY_SEPARATOR.'cachekey';
|
|
file_put_contents($file, 'data');
|
|
chmod($file, 0644);
|
|
|
|
$changed = FilePermissionHelper::syncGroupWritability($root);
|
|
|
|
// 루트 정책 (0775) 그대로 + 하위 모두 g+w 승격
|
|
$this->assertSame(0775, fileperms($root) & 0777, '루트는 변경되지 않음');
|
|
$this->assertSame(0775, fileperms($child) & 0777, '자식 디렉토리 g+w 승격');
|
|
$this->assertSame(0775, fileperms($grandchild) & 0777, '손자 디렉토리 g+w 승격');
|
|
$this->assertSame(0664, fileperms($file) & 0777, '파일 g+w 승격 (0644 → 0664)');
|
|
$this->assertSame(3, $changed, 'changed 카운트 = 자식 + 손자 + 파일');
|
|
}
|
|
|
|
/**
|
|
* 루트가 g-w (0755) 인 경우 — no-op. 운영자 정책 보존.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_sync_group_writability_respects_root_policy_without_group_write(): void
|
|
{
|
|
$this->assertPosixOrSkip();
|
|
|
|
$root = $this->createTempDir();
|
|
chmod($root, 0755);
|
|
|
|
$child = $root.DIRECTORY_SEPARATOR.'sub';
|
|
mkdir($child, 0755);
|
|
|
|
$changed = FilePermissionHelper::syncGroupWritability($root);
|
|
|
|
$this->assertSame(0755, fileperms($root) & 0777);
|
|
$this->assertSame(0755, fileperms($child) & 0777, '루트가 g-w 면 자식 변경 없음');
|
|
$this->assertSame(0, $changed);
|
|
}
|
|
|
|
/**
|
|
* 이미 정상 (자식·손자 모두 g+w) → no-op (멱등).
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_sync_group_writability_is_idempotent(): void
|
|
{
|
|
$this->assertPosixOrSkip();
|
|
|
|
$root = $this->createTempDir();
|
|
chmod($root, 0775);
|
|
|
|
$child = $root.DIRECTORY_SEPARATOR.'ok';
|
|
mkdir($child, 0775);
|
|
|
|
$file = $root.DIRECTORY_SEPARATOR.'fine.txt';
|
|
file_put_contents($file, 'x');
|
|
chmod($file, 0664);
|
|
|
|
$changed = FilePermissionHelper::syncGroupWritability($root);
|
|
|
|
$this->assertSame(0775, fileperms($child) & 0777);
|
|
$this->assertSame(0664, fileperms($file) & 0777);
|
|
$this->assertSame(0, $changed, '이미 정상 → changed=0');
|
|
}
|
|
|
|
/**
|
|
* 다른 비트(other, owner, sticky 등) 무변경 — g+w 만 OR.
|
|
*
|
|
* @return void
|
|
*/
|
|
public function test_sync_group_writability_only_adds_group_write_bit(): void
|
|
{
|
|
$this->assertPosixOrSkip();
|
|
|
|
$root = $this->createTempDir();
|
|
chmod($root, 0775);
|
|
|
|
// 0700 = owner rwx만, group/other 무권한. 그룹에 w만 추가되어 0720이 되어야 함
|
|
$file = $root.DIRECTORY_SEPARATOR.'restricted.bin';
|
|
file_put_contents($file, '');
|
|
chmod($file, 0700);
|
|
|
|
$changed = FilePermissionHelper::syncGroupWritability($root);
|
|
|
|
// 0700 → 0720 (g+w 만 OR, owner/other 비트 무변경)
|
|
$this->assertSame(0720, fileperms($file) & 0777, 'g+w 만 추가, 다른 비트 무변경');
|
|
$this->assertSame(1, $changed);
|
|
}
|
|
}
|