프로세스 목록 */ public static function findLockingProcesses(string $directoryPath, int $maxFiles = 30, ?\Closure $onOutput = null): array { $output = $onOutput ?? function () {}; if (! self::isWindows()) { $output('[lock-detect] Windows 환경이 아니므로 잠금 감지를 건너뜁니다.'); return []; } $allProcesses = []; // 1순위: WMI CommandLine + 프로세스 모듈 검색 $output('[lock-detect] 1단계: WMI 프로세스 CommandLine + 모듈 검색...'); $wmiResults = self::detectViaWmi($directoryPath, $onOutput); foreach ($wmiResults as $proc) { $allProcesses[$proc['pid']] = $proc; } // 2순위: Restart Manager API (파일 수준 잠금) $files = self::sampleFiles($directoryPath, $maxFiles); if (! empty($files)) { $output('[lock-detect] 2단계: Restart Manager API ('.count($files).'개 파일)...'); $rmResults = self::detectViaRestartManager($files, $onOutput); foreach ($rmResults as $proc) { if (! isset($allProcesses[$proc['pid']])) { $allProcesses[$proc['pid']] = $proc; } } } // 3순위: handle.exe 폴백 if (empty($allProcesses)) { $output('[lock-detect] 3단계: handle.exe 폴백...'); $handleResults = self::detectViaHandle($directoryPath, $onOutput); foreach ($handleResults as $proc) { if (! isset($allProcesses[$proc['pid']])) { $allProcesses[$proc['pid']] = $proc; } } } // 현재 PHP 프로세스 제외 $currentPid = self::currentPid(); unset($allProcesses[$currentPid]); $filtered = array_values($allProcesses); if (! empty($filtered)) { $output('[lock-detect] 감지된 잠금 프로세스: '.count($filtered).'개'); foreach ($filtered as $proc) { $output("[lock-detect] PID {$proc['pid']}: {$proc['name']} ({$proc['app']})"); } } else { $output('[lock-detect] 잠금 프로세스를 감지하지 못했습니다.'); } return $filtered; } /** * 잠금 프로세스를 종료합니다. * * @param array $processes 종료할 프로세스 목록 * @return array{killed: array, failed: array} 종료 결과 */ public static function killProcesses(array $processes): array { $killed = []; $failed = []; foreach ($processes as $proc) { $pid = $proc['pid']; $name = $proc['name']; // 시스템 프로세스 보호 if (self::isSystemProcess($name)) { $failed[] = array_merge($proc, ['reason' => '시스템 프로세스는 종료할 수 없습니다']); continue; } if (self::isWindows()) { $result = self::killWindowsProcess($pid); } else { $result = self::killUnixProcess($pid); } if ($result) { $killed[] = $proc; } else { $failed[] = array_merge($proc, ['reason' => '프로세스 종료 실패']); } } return ['killed' => $killed, 'failed' => $failed]; } /** * 디렉토리 잠금을 감지하고 해제합니다. * * @param string $directoryPath 잠금 해제할 디렉토리 경로 * @param \Closure|null $onOutput 출력 콜백 (string $message) * @return bool 잠금 해제 성공 여부 (잠금이 없었거나, 모두 해제된 경우 true) */ public static function releaseLocks(string $directoryPath, ?\Closure $onOutput = null): bool { $output = $onOutput ?? function () {}; $output(''); $output('🔍 파일 잠금 감지 시작: '.$directoryPath); $processes = self::findLockingProcesses($directoryPath, 30, $onOutput); if (empty($processes)) { $output(''); $output('ℹ️ 잠금 프로세스가 감지되지 않았습니다.'); $output(' 수동 해결: 해당 디렉토리를 참조하는 프로세스를 닫은 후 재시도하세요.'); $output(''); return false; } $output(''); $output('⚠️ 파일 잠금 프로세스 감지됨 ('.count($processes).'개):'); foreach ($processes as $proc) { $output(" - PID {$proc['pid']}: {$proc['name']} ({$proc['app']})"); } $output(''); $output('🔧 잠금 프로세스 종료 시도...'); $result = self::killProcesses($processes); foreach ($result['killed'] as $proc) { $output(" ✅ PID {$proc['pid']} ({$proc['name']}) 종료 완료"); } foreach ($result['failed'] as $proc) { $output(" ❌ PID {$proc['pid']} ({$proc['name']}) 종료 실패: {$proc['reason']}"); } if (! empty($result['failed'])) { $output(''); $output('❌ 일부 프로세스를 종료하지 못했습니다. 수동으로 종료 후 재시도하세요.'); Log::warning('파일 잠금 해제 실패', [ 'directory' => $directoryPath, 'failed' => $result['failed'], ]); return false; } // 프로세스 종료 후 핸들 해제 대기 $output(''); $output('⏳ 핸들 해제 대기 중 (500ms)...'); usleep(500_000); // 500ms $output('✅ 잠금 해제 완료 — 디렉토리 이동 재시도합니다.'); $output(''); Log::info('파일 잠금 해제 완료', [ 'directory' => $directoryPath, 'killed' => $result['killed'], ]); return true; } // ======================================================================== // 탐지 전략 1: WMI CommandLine + 프로세스 모듈 검색 // ======================================================================== /** * WMI로 해당 디렉토리 경로를 참조하는 프로세스를 탐지합니다. * * Get-CimInstance Win32_Process의 CommandLine에 디렉토리 경로가 포함된 프로세스와, * Get-Process의 Modules에서 해당 디렉토리 내 DLL을 로드한 프로세스를 찾습니다. * Node.js 워처, IDE, 파일 탐색기 등 프로세스 종류 무관하게 감지합니다. * * @param string $directoryPath 디렉토리 경로 * @param \Closure|null $onOutput 진단 출력 콜백 * @return array 프로세스 목록 */ private static function detectViaWmi(string $directoryPath, ?\Closure $onOutput = null): array { $output = $onOutput ?? function () {}; if (! function_exists('exec')) { $output('[WMI] exec() 함수 사용 불가'); return []; } $normalizedPath = str_replace('/', '\\', $directoryPath); // PowerShell에서 안전하게 사용할 수 있도록 이스케이프 $escapedPath = str_replace("'", "''", $normalizedPath); // 간결한 인라인 PowerShell — 임시 파일 불필요 $psCommand = implode('; ', [ '$ErrorActionPreference = "SilentlyContinue"', '$p = "'.addcslashes($escapedPath, '"').'"', '$pl = $p.ToLower()', '$r = @{}', // Strategy 1: CommandLine search 'Get-CimInstance Win32_Process | ForEach-Object { if ($_.CommandLine) { $cl = $_.CommandLine.ToLower().Replace("/","\\"); if ($cl.Contains($pl)) { $r[$_.ProcessId] = "$($_.ProcessId)|$($_.Name)|$($_.CommandLine.Substring(0,[Math]::Min(120,$_.CommandLine.Length)))" } } }', // Strategy 2: Modules search 'Get-Process | ForEach-Object { if (-not $r.ContainsKey($_.Id)) { try { foreach ($m in $_.Modules) { if ($m.FileName -and $m.FileName.ToLower().StartsWith($pl)) { $r[$_.Id] = "$($_.Id)|$($_.ProcessName)|module:$($m.FileName)"; break } } } catch {} } }', // Output 'foreach ($v in $r.Values) { Write-Output $v }', ]); $cmdOutput = []; $exitCode = 0; exec( 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -Command '.escapeshellarg($psCommand).' 2>NUL', $cmdOutput, $exitCode ); $output("[WMI] PowerShell exit code: {$exitCode}, 출력: ".count($cmdOutput).'줄'); if (! empty($cmdOutput)) { foreach ($cmdOutput as $line) { $output("[WMI] → {$line}"); } } return self::parseProcessOutput($cmdOutput); } // ======================================================================== // 탐지 전략 2: Restart Manager API (파일 수준 잠금) // ======================================================================== /** * Windows Restart Manager API를 사용하여 잠금 프로세스를 탐지합니다. * * PowerShell에서 인라인 C# 코드로 Restart Manager API를 호출합니다. * 외부 도구(handle.exe 등)가 필요 없으며, Windows Vista+ 내장 API입니다. * 파일 수준 잠금만 감지 가능 (디렉토리 핸들은 감지 불가). * * @param string[] $filePaths 검사할 파일 경로 목록 * @param \Closure|null $onOutput 진단 출력 콜백 * @return array 프로세스 목록 */ private static function detectViaRestartManager(array $filePaths, ?\Closure $onOutput = null): array { $output = $onOutput ?? function () {}; if (! function_exists('exec')) { $output('[RestartManager] exec() 함수 사용 불가'); return []; } $tempScript = tempnam(sys_get_temp_dir(), 'g7lock_'); $scriptPath = $tempScript.'.ps1'; rename($tempScript, $scriptPath); $escapedFiles = array_map( fn ($f) => "'".str_replace("'", "''", str_replace('/', '\\', $f))."'", $filePaths ); $fileListPs = '@('.implode(',', $escapedFiles).')'; $psScript = self::getRestartManagerScript($fileListPs); file_put_contents($scriptPath, $psScript); $stderrPath = $scriptPath.'.err'; try { $cmdOutput = []; $exitCode = 0; exec( 'powershell.exe -NoProfile -NonInteractive -ExecutionPolicy Bypass -File '.escapeshellarg($scriptPath).' 2>'.escapeshellarg($stderrPath), $cmdOutput, $exitCode ); $output("[RestartManager] exit code: {$exitCode}, 출력: ".count($cmdOutput).'줄'); if (file_exists($stderrPath)) { $stderr = trim(file_get_contents($stderrPath)); if (! empty($stderr)) { $lines = array_slice(explode("\n", $stderr), 0, 3); foreach ($lines as $line) { $output('[RestartManager] stderr: '.trim($line)); } } } return self::parseProcessOutput($cmdOutput); } finally { @unlink($scriptPath); @unlink($stderrPath); } } /** * Restart Manager API를 호출하는 PowerShell 스크립트를 생성합니다. * * @param string $fileListPs PowerShell 배열 형식의 파일 목록 * @return string PowerShell 스크립트 내용 */ private static function getRestartManagerScript(string $fileListPs): string { return <<<'PSHEADER' $ErrorActionPreference = 'SilentlyContinue' Add-Type -TypeDefinition @" using System; using System.Collections.Generic; using System.Diagnostics; using System.Runtime.InteropServices; using System.Runtime.InteropServices.ComTypes; public class RmLockDetector { [StructLayout(LayoutKind.Sequential)] struct RM_UNIQUE_PROCESS { public int dwProcessId; public FILETIME ProcessStartTime; } [StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)] struct RM_PROCESS_INFO { public RM_UNIQUE_PROCESS Process; [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 256)] public string strAppName; [MarshalAs(UnmanagedType.ByValTStr, SizeConst = 64)] public string strServiceShortName; public int ApplicationType; public uint AppStatus; public uint TSSessionId; [MarshalAs(UnmanagedType.Bool)] public bool bRestartable; } [DllImport("rstrtmgr.dll", CharSet = CharSet.Unicode)] static extern int RmStartSession(out uint pSessionHandle, int dwSessionFlags, string strSessionKey); [DllImport("rstrtmgr.dll")] static extern int RmEndSession(uint pSessionHandle); [DllImport("rstrtmgr.dll", CharSet = CharSet.Unicode)] static extern int RmRegisterResources(uint pSessionHandle, uint nFiles, string[] rgsFilenames, uint nApplications, [In] RM_UNIQUE_PROCESS[] rgApplications, uint nServices, string[] rgsServiceNames); [DllImport("rstrtmgr.dll")] static extern int RmGetList(uint dwSessionHandle, out uint pnProcInfoNeeded, ref uint pnProcInfo, [In, Out] RM_PROCESS_INFO[] rgAffectedApps, ref uint lpdwRebootReasons); public static string[] FindLockingProcesses(string[] filePaths) { uint handle; string key = Guid.NewGuid().ToString(); int res = RmStartSession(out handle, 0, key); if (res != 0) return new string[0]; try { res = RmRegisterResources(handle, (uint)filePaths.Length, filePaths, 0, null, 0, null); if (res != 0) return new string[0]; uint pnProcInfoNeeded = 0; uint pnProcInfo = 0; uint lpdwRebootReasons = 0; res = RmGetList(handle, out pnProcInfoNeeded, ref pnProcInfo, null, ref lpdwRebootReasons); if (pnProcInfoNeeded == 0) return new string[0]; RM_PROCESS_INFO[] processInfo = new RM_PROCESS_INFO[pnProcInfoNeeded]; pnProcInfo = pnProcInfoNeeded; res = RmGetList(handle, out pnProcInfoNeeded, ref pnProcInfo, processInfo, ref lpdwRebootReasons); if (res != 0) return new string[0]; var results = new List(); var seen = new HashSet(); for (int i = 0; i < pnProcInfo; i++) { int pid = processInfo[i].Process.dwProcessId; if (seen.Contains(pid)) continue; seen.Add(pid); try { var proc = Process.GetProcessById(pid); results.Add(pid + "|" + proc.ProcessName + "|" + processInfo[i].strAppName); } catch { } } return results.ToArray(); } finally { RmEndSession(handle); } } } "@ PSHEADER ."\$files = {$fileListPs}\n" .<<<'PSFOOTER' $results = [RmLockDetector]::FindLockingProcesses($files) foreach ($r in $results) { Write-Output $r } PSFOOTER; } // ======================================================================== // 탐지 전략 3: handle.exe (Sysinternals) 폴백 // ======================================================================== /** * handle.exe (Sysinternals)를 사용하여 잠금 프로세스를 탐지합니다. * * @param string $directoryPath 디렉토리 경로 * @param \Closure|null $onOutput 진단 출력 콜백 * @return array 프로세스 목록 */ private static function detectViaHandle(string $directoryPath, ?\Closure $onOutput = null): array { $logOutput = $onOutput ?? function () {}; if (! function_exists('exec')) { $logOutput('[handle.exe] exec() 함수 사용 불가'); return []; } $cmdOutput = []; $exitCode = 0; $dirPath = str_replace('/', '\\', $directoryPath); exec( 'handle.exe -nobanner -accepteula '.escapeshellarg($dirPath).' 2>NUL', $cmdOutput, $exitCode ); if ($exitCode !== 0 || empty($cmdOutput)) { $logOutput("[handle.exe] 사용 불가 (exit code: {$exitCode})"); return []; } $logOutput('[handle.exe] '.count($cmdOutput).'줄 출력 수신'); return self::parseHandleOutput($cmdOutput); } // ======================================================================== // 파서/유틸리티 // ======================================================================== /** * 디렉토리 내 파일을 샘플링합니다. * * @param string $directoryPath 디렉토리 경로 * @param int $maxFiles 최대 파일 수 * @return string[] 파일 경로 목록 */ private static function sampleFiles(string $directoryPath, int $maxFiles): array { if (! is_dir($directoryPath)) { return []; } $files = []; $iterator = new \RecursiveIteratorIterator( new \RecursiveDirectoryIterator($directoryPath, \RecursiveDirectoryIterator::SKIP_DOTS), \RecursiveIteratorIterator::SELF_FIRST ); foreach ($iterator as $file) { if ($file->isFile()) { $files[] = $file->getPathname(); if (count($files) >= $maxFiles) { break; } } } return $files; } /** * "PID|ProcessName|AppName" 형식의 출력을 파싱합니다. * * @param string[] $output 프로세스 출력 라인 * @return array 프로세스 목록 */ private static function parseProcessOutput(array $output): array { $processes = []; $seen = []; foreach ($output as $line) { $line = trim($line); if (empty($line) || str_starts_with($line, 'ERROR:')) { continue; } $parts = explode('|', $line, 3); if (count($parts) < 2) { continue; } $pid = (int) $parts[0]; if ($pid <= 0 || isset($seen[$pid])) { continue; } $seen[$pid] = true; $processes[] = [ 'pid' => $pid, 'name' => $parts[1] ?? 'unknown', 'app' => $parts[2] ?? $parts[1] ?? 'unknown', ]; } return $processes; } /** * handle.exe 출력을 파싱합니다. * * @param string[] $output handle.exe 출력 * @return array 프로세스 목록 */ private static function parseHandleOutput(array $output): array { $processes = []; $seen = []; foreach ($output as $line) { if (preg_match('/^(.+?)\s+pid:\s*(\d+)\s/', $line, $matches)) { $name = trim($matches[1]); $pid = (int) $matches[2]; if ($pid <= 0 || isset($seen[$pid])) { continue; } $seen[$pid] = true; $processes[] = [ 'pid' => $pid, 'name' => $name, 'app' => $name, ]; } } return $processes; } /** * 시스템 프로세스 여부를 확인합니다. * * @param string $processName 프로세스명 * @return bool 시스템 프로세스이면 true */ private static function isSystemProcess(string $processName): bool { $systemProcesses = [ 'System', 'svchost', 'csrss', 'wininit', 'winlogon', 'services', 'lsass', 'smss', 'explorer', 'dwm', 'RuntimeBroker', 'SearchHost', 'StartMenuExperienceHost', ]; return in_array($processName, $systemProcesses, true); } /** * Windows 프로세스를 종료합니다. * * @param int $pid 프로세스 ID * @return bool 종료 성공 여부 */ private static function killWindowsProcess(int $pid): bool { if (! function_exists('exec')) { return false; } $output = []; $exitCode = 0; exec("taskkill /PID {$pid} /F 2>NUL", $output, $exitCode); return $exitCode === 0; } /** * Unix 프로세스를 종료합니다. * * @param int $pid 프로세스 ID * @return bool 종료 성공 여부 */ private static function killUnixProcess(int $pid): bool { if (function_exists('posix_kill')) { return posix_kill($pid, 9); // SIGKILL } if (function_exists('exec')) { $output = []; $exitCode = 0; exec("kill -9 {$pid} 2>/dev/null", $output, $exitCode); return $exitCode === 0; } return false; } }