321 lines
12 KiB
PHP
321 lines
12 KiB
PHP
<?php
|
|
|
|
namespace App\Extension\Vendor;
|
|
|
|
use App\Extension\Vendor\Exceptions\VendorInstallException;
|
|
use Illuminate\Support\Facades\File;
|
|
use Illuminate\Support\Facades\Log;
|
|
|
|
/**
|
|
* vendor-bundle.zip 을 대상 디렉토리로 추출하여 vendor/를 구성합니다.
|
|
*
|
|
* 공유 호스팅 친화적 설계:
|
|
* - targetDir 자체(프로젝트 루트)의 쓰기 권한은 요구하지 않음
|
|
* - vendor/ 디렉토리 자체는 유지하고 **내부 항목만 조작**
|
|
* - 기존 내용은 vendor/.bundle_backup_{ts}/ 로 이동 (vendor/ 쓰기 권한만으로 가능)
|
|
* - 추출 실패 시 백업에서 복원, 성공 시 백업 삭제
|
|
*
|
|
* 이 접근은 웹 서버 사용자가 프로젝트 루트에는 쓰기 권한이 없지만
|
|
* vendor/ 디렉토리에만 권한이 부여된 전형적 공유 호스팅 환경을 지원합니다.
|
|
*/
|
|
class VendorBundleInstaller
|
|
{
|
|
public function __construct(
|
|
private readonly VendorIntegrityChecker $integrityChecker,
|
|
) {}
|
|
|
|
/**
|
|
* 번들 zip을 대상 디렉토리에 추출합니다.
|
|
*
|
|
* @param string $sourceDir vendor-bundle.zip 이 위치한 디렉토리
|
|
* @param string $targetDir vendor/가 배치될 디렉토리 (일반적으로 sourceDir과 동일)
|
|
*
|
|
* @throws VendorInstallException
|
|
*/
|
|
public function install(string $sourceDir, string $targetDir): VendorInstallResult
|
|
{
|
|
$startTime = microtime(true);
|
|
|
|
// 1. ZipArchive 확장 확인
|
|
if (! class_exists(\ZipArchive::class)) {
|
|
throw new VendorInstallException('zip_archive_not_available');
|
|
}
|
|
|
|
// 2. 무결성 검증
|
|
$integrity = $this->integrityChecker->verify($sourceDir);
|
|
if (! $integrity->valid) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'bundle_integrity_failed',
|
|
context: ['details' => implode(', ', $integrity->errorMessages())],
|
|
);
|
|
}
|
|
|
|
$zipPath = $sourceDir.DIRECTORY_SEPARATOR.VendorIntegrityChecker::ZIP_FILENAME;
|
|
$vendorDir = $targetDir.DIRECTORY_SEPARATOR.'vendor';
|
|
$backupDirName = '.bundle_backup_'.date('Ymd_His');
|
|
$backupDir = $vendorDir.DIRECTORY_SEPARATOR.$backupDirName;
|
|
|
|
// 3. 쓰기 권한 유연 검사 — vendor/ 가 있으면 vendor/ 권한만, 없으면 targetDir 권한 필요
|
|
$this->validateTargetWritable($targetDir, $vendorDir);
|
|
|
|
// 4. zip slip 방지 사전 검증
|
|
$this->validateZipContents($zipPath);
|
|
|
|
// 5. 기존 vendor/ 내부 항목을 vendor/.bundle_backup_{ts}/ 로 이동
|
|
// (vendor/ 디렉토리 자체는 유지 — targetDir 쓰기 권한 불필요)
|
|
$hasBackup = false;
|
|
if (is_dir($vendorDir)) {
|
|
$hasBackup = $this->moveVendorContentsToBackup($vendorDir, $backupDir, $backupDirName);
|
|
} else {
|
|
// vendor/ 없음 — 신규 생성 (targetDir 쓰기 권한 필요, 위에서 이미 검증)
|
|
if (! @mkdir($vendorDir, 0755, true) && ! is_dir($vendorDir)) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'target_not_writable',
|
|
context: ['path' => $vendorDir],
|
|
);
|
|
}
|
|
}
|
|
|
|
// 6. 추출
|
|
try {
|
|
$zip = new \ZipArchive;
|
|
$openResult = $zip->open($zipPath);
|
|
if ($openResult !== true) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'extraction_failed',
|
|
context: ['message' => 'ZipArchive::open failed (code: '.$openResult.')'],
|
|
);
|
|
}
|
|
|
|
$extracted = $zip->extractTo($targetDir);
|
|
$zip->close();
|
|
|
|
if (! $extracted) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'extraction_failed',
|
|
context: ['message' => 'ZipArchive::extractTo returned false'],
|
|
);
|
|
}
|
|
|
|
// 7. 성공: 백업 디렉토리 삭제 (vendor/.bundle_backup_{ts}/)
|
|
if ($hasBackup && is_dir($backupDir)) {
|
|
File::deleteDirectory($backupDir);
|
|
}
|
|
|
|
$duration = microtime(true) - $startTime;
|
|
$packageCount = (int) ($integrity->meta['package_count'] ?? 0);
|
|
$zipSize = @filesize($zipPath) ?: 0;
|
|
|
|
Log::info('Vendor 번들 추출 성공', [
|
|
'source_dir' => $sourceDir,
|
|
'target_dir' => $targetDir,
|
|
'package_count' => $packageCount,
|
|
'zip_size' => $zipSize,
|
|
'duration_seconds' => round($duration, 2),
|
|
]);
|
|
|
|
return new VendorInstallResult(
|
|
mode: VendorMode::Bundled,
|
|
strategy: 'bundled',
|
|
packageCount: $packageCount,
|
|
durationSeconds: $duration,
|
|
details: [
|
|
'zip_size' => $zipSize,
|
|
'source_dir' => $sourceDir,
|
|
],
|
|
);
|
|
} catch (\Throwable $e) {
|
|
// 실패: 백업에서 복원
|
|
if ($hasBackup && is_dir($backupDir)) {
|
|
$this->restoreVendorFromBackup($vendorDir, $backupDir, $backupDirName);
|
|
}
|
|
|
|
if ($e instanceof VendorInstallException) {
|
|
throw $e;
|
|
}
|
|
|
|
throw new VendorInstallException(
|
|
errorKey: 'extraction_failed',
|
|
context: ['message' => $e->getMessage()],
|
|
previous: $e,
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 쓰기 권한 검사 — vendor/ 가 존재하면 vendor/ 권한만, 없으면 targetDir 권한 필요.
|
|
*
|
|
* 공유 호스팅 환경에서 targetDir (프로젝트 루트) 에는 쓰기 권한이 없고
|
|
* vendor/ 에만 권한이 부여된 케이스를 지원한다.
|
|
*
|
|
* @throws VendorInstallException
|
|
*/
|
|
private function validateTargetWritable(string $targetDir, string $vendorDir): void
|
|
{
|
|
if (is_dir($vendorDir)) {
|
|
if (! is_writable($vendorDir)) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'target_not_writable',
|
|
context: $this->buildPermissionContext($vendorDir),
|
|
);
|
|
}
|
|
|
|
return;
|
|
}
|
|
|
|
// vendor/ 없음 — 생성을 위해 targetDir 에 쓰기 권한 필요
|
|
if (! is_dir($targetDir) || ! is_writable($targetDir)) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'target_not_writable',
|
|
context: $this->buildPermissionContext($targetDir),
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 권한 거부 컨텍스트에 소유권 정보를 포함합니다.
|
|
*
|
|
* 공유 호스팅에서 FTP 사용자와 PHP 실행 사용자가 다른 경우 진단을 돕기 위해
|
|
* 현재 실행 사용자, 디렉토리 소유자, 권장 조치를 함께 반환합니다.
|
|
*/
|
|
private function buildPermissionContext(string $path): array
|
|
{
|
|
$context = ['path' => $path];
|
|
|
|
if (! function_exists('posix_geteuid') || ! function_exists('posix_getpwuid')) {
|
|
return $context;
|
|
}
|
|
|
|
$currentUid = posix_geteuid();
|
|
$currentUser = posix_getpwuid($currentUid)['name'] ?? (string) $currentUid;
|
|
$context['current_user'] = "{$currentUser}({$currentUid})";
|
|
|
|
if (file_exists($path)) {
|
|
$ownerUid = fileowner($path);
|
|
$ownerUser = posix_getpwuid($ownerUid)['name'] ?? (string) $ownerUid;
|
|
$context['owner'] = "{$ownerUser}({$ownerUid})";
|
|
|
|
if ($currentUid !== $ownerUid) {
|
|
$context['hint'] = __('exceptions.vendor.target_not_writable_owner_hint', [
|
|
'path' => $path,
|
|
'current_user' => $context['current_user'],
|
|
'current_user_name' => $currentUser,
|
|
'owner' => $context['owner'],
|
|
'owner_name' => $ownerUser,
|
|
]);
|
|
}
|
|
}
|
|
|
|
return $context;
|
|
}
|
|
|
|
/**
|
|
* 기존 vendor/ 내부 항목을 vendor/.bundle_backup_{ts}/ 로 이동합니다.
|
|
*
|
|
* vendor/ 디렉토리 자체는 유지하므로 targetDir 쓰기 권한이 필요하지 않습니다.
|
|
*
|
|
* @return bool 백업 성공 여부 (false 시 in-place overwrite 로 추출 진행)
|
|
*/
|
|
private function moveVendorContentsToBackup(string $vendorDir, string $backupDir, string $backupDirName): bool
|
|
{
|
|
if (! @mkdir($backupDir) && ! is_dir($backupDir)) {
|
|
Log::warning('Vendor 번들 백업 디렉토리 생성 실패 — in-place overwrite 로 진행', [
|
|
'vendor_dir' => $vendorDir,
|
|
'backup_dir' => $backupDir,
|
|
]);
|
|
|
|
return false;
|
|
}
|
|
|
|
$items = @scandir($vendorDir) ?: [];
|
|
foreach ($items as $item) {
|
|
if ($item === '.' || $item === '..' || $item === $backupDirName) {
|
|
continue;
|
|
}
|
|
|
|
$src = $vendorDir.DIRECTORY_SEPARATOR.$item;
|
|
$dst = $backupDir.DIRECTORY_SEPARATOR.$item;
|
|
@rename($src, $dst);
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 백업 디렉토리에서 vendor/ 로 내용을 복원합니다.
|
|
*
|
|
* 추출 중 실패한 경우 기존 상태로 되돌리기 위해 호출됩니다.
|
|
*/
|
|
private function restoreVendorFromBackup(string $vendorDir, string $backupDir, string $backupDirName): void
|
|
{
|
|
// 1. 추출로 이미 생성된 파일/디렉토리 정리 (백업 폴더 제외)
|
|
$items = @scandir($vendorDir) ?: [];
|
|
foreach ($items as $item) {
|
|
if ($item === '.' || $item === '..' || $item === $backupDirName) {
|
|
continue;
|
|
}
|
|
|
|
$path = $vendorDir.DIRECTORY_SEPARATOR.$item;
|
|
if (is_dir($path) && ! is_link($path)) {
|
|
File::deleteDirectory($path);
|
|
} elseif (file_exists($path)) {
|
|
@unlink($path);
|
|
}
|
|
}
|
|
|
|
// 2. 백업 항목을 원위치로 이동
|
|
$backupItems = @scandir($backupDir) ?: [];
|
|
foreach ($backupItems as $item) {
|
|
if ($item === '.' || $item === '..') {
|
|
continue;
|
|
}
|
|
|
|
$src = $backupDir.DIRECTORY_SEPARATOR.$item;
|
|
$dst = $vendorDir.DIRECTORY_SEPARATOR.$item;
|
|
@rename($src, $dst);
|
|
}
|
|
|
|
// 3. 빈 백업 디렉토리 제거
|
|
@rmdir($backupDir);
|
|
}
|
|
|
|
/**
|
|
* zip 내부 파일 경로의 안전성을 검증합니다 (zip slip 방지).
|
|
*
|
|
* @throws VendorInstallException
|
|
*/
|
|
private function validateZipContents(string $zipPath): void
|
|
{
|
|
$zip = new \ZipArchive;
|
|
if ($zip->open($zipPath) !== true) {
|
|
throw new VendorInstallException(
|
|
errorKey: 'extraction_failed',
|
|
context: ['message' => 'cannot open zip for validation'],
|
|
);
|
|
}
|
|
|
|
for ($i = 0; $i < $zip->numFiles; $i++) {
|
|
$name = $zip->getNameIndex($i);
|
|
if ($name === false) {
|
|
continue;
|
|
}
|
|
|
|
// 경로 탈출 방지
|
|
$normalized = str_replace('\\', '/', $name);
|
|
if (
|
|
str_contains($normalized, '../')
|
|
|| str_starts_with($normalized, '/')
|
|
|| preg_match('#^[A-Za-z]:/#', $normalized)
|
|
) {
|
|
$zip->close();
|
|
throw new VendorInstallException(
|
|
errorKey: 'bundle_contains_unsafe_path',
|
|
context: ['path' => $name],
|
|
);
|
|
}
|
|
}
|
|
|
|
$zip->close();
|
|
}
|
|
}
|