Files
Gnuboard7/app/Providers/PluginServiceProvider.php
T
2026-07-01 10:30:32 +09:00

112 lines
3.9 KiB
PHP

<?php
namespace App\Providers;
use App\Extension\ExtensionManager;
use App\Extension\Testing\ExtensionTestAllowlist;
use Illuminate\Support\Facades\File;
use Illuminate\Support\ServiceProvider;
/**
* 플러그인 ServiceProvider 자동 발견 및 등록
*
* plugins 디렉토리를 스캔하여 모든 플러그인의 ServiceProvider를 자동으로 등록합니다.
* register() 시점에 실행되어 타이밍 이슈 없이 Repository 바인딩이 가능합니다.
*/
class PluginServiceProvider extends ServiceProvider
{
/**
* 플러그인 ServiceProvider들을 등록합니다.
*/
public function register(): void
{
$pluginsPath = base_path('plugins');
if (! File::exists($pluginsPath)) {
return;
}
$allowlistActive = ExtensionTestAllowlist::isActive();
foreach ($this->discoverPluginServiceProviders($pluginsPath) as $provider) {
// 테스트 환경 확장 격리: allowlist 밖 플러그인의 ServiceProvider 등록 차단
if ($allowlistActive && ! ExtensionTestAllowlist::isAllowed('plugin', $provider['name'])) {
continue;
}
$this->app->register($provider['class']);
}
}
/**
* plugins 디렉토리를 스캔하여 모든 플러그인의 ServiceProvider 클래스들을 발견합니다.
*
* 각 항목은 플러그인 디렉토리명('name')과 ServiceProvider 클래스명('class')을
* 함께 담습니다. 디렉토리명은 테스트 환경 확장 격리 가드에 사용됩니다.
*
* @param string $pluginsPath 플러그인 디렉토리 경로
* @return array<array{name: string, class: string}> ServiceProvider 정보 배열
*/
protected function discoverPluginServiceProviders(string $pluginsPath): array
{
$providers = [];
$directories = File::directories($pluginsPath);
foreach ($directories as $directory) {
$pluginName = basename($directory);
$providersPath = $directory.'/src/Providers';
if (! File::exists($providersPath)) {
continue;
}
// Providers 디렉토리 내 모든 PHP 파일 스캔
$providerFiles = File::glob($providersPath.'/*.php');
foreach ($providerFiles as $providerFile) {
$providerClass = $this->resolveProviderClass($pluginName, $providerFile);
if ($providerClass && class_exists($providerClass)) {
$providers[] = ['name' => $pluginName, 'class' => $providerClass];
}
}
}
return $providers;
}
/**
* 파일 경로에서 ServiceProvider 클래스명을 추론합니다.
*
* @param string $pluginName 플러그인 디렉토리명 (예: sirsoft-payment)
* @param string $providerFile Provider 파일 경로
* @return string|null ServiceProvider 클래스명 또는 null
*/
protected function resolveProviderClass(string $pluginName, string $providerFile): ?string
{
$fileName = pathinfo($providerFile, PATHINFO_FILENAME);
// ServiceProvider로 끝나는 파일만 처리
if (! str_ends_with($fileName, 'ServiceProvider')) {
return null;
}
// vendor-plugin 형식을 네임스페이스로 변환
// sirsoft-payment -> Sirsoft\Payment
$namespace = $this->convertDirectoryToNamespace($pluginName);
return "Plugins\\{$namespace}\\Providers\\{$fileName}";
}
/**
* 디렉토리명(vendor-plugin)을 네임스페이스(Vendor\Plugin)로 변환합니다.
*
* @param string $directoryName 디렉토리명 (예: sirsoft-payment)
* @return string 네임스페이스 (예: Sirsoft\Payment)
*/
protected function convertDirectoryToNamespace(string $directoryName): string
{
return ExtensionManager::directoryToNamespace($directoryName);
}
}