HeuJung
d8ca281464
프록시 설정 추가분을 마이너(7.1.0)가 아닌 패치(7.0.8)로 내보낸다. 7.0.7 이후 변경된 코어·템플릿·플러그인·언어팩의 출시일을 2026-08-21 로 맞춘다. >=7.1.0 을 요구하던 본인인증 플러그인의 코어 최소 버전을 >=7.0.8 로 내린다 — 그대로 두면 존재하지 않는 버전을 요구해 플러그인이 자동 비활성화된다. 앞선 작업에서 누락된 package-lock.json 버전(1.0.3)도 함께 맞춘다.
117 lines
4.5 KiB
PHP
117 lines
4.5 KiB
PHP
<?php
|
|
|
|
namespace App\Services;
|
|
|
|
use App\Support\OutboundProxy;
|
|
use Illuminate\Support\Facades\Http;
|
|
use Illuminate\Support\Facades\Log;
|
|
|
|
/**
|
|
* 아웃바운드 프록시 연결 테스트.
|
|
*
|
|
* 운영자가 입력한 프록시가 실제로 동작하는지, 그리고 그 프록시를 거쳐 나갔을 때 상대편에
|
|
* 어떤 IP 로 보이는지 확인합니다. 출발지 IP 는 결제사·외부 서비스에 등록해야 하는 값이라
|
|
* 테스트의 핵심 산출물입니다 — 프록시를 켜기 전에 어떤 IP 를 등록해야 하는지 알 수 있어야
|
|
* 저장하고 나서 되짚는 일이 없습니다.
|
|
*
|
|
* 검사 대상은 **저장된 설정이 아니라 이번에 제출된 값**입니다. 그래서 전역 옵션에 의존하지
|
|
* 않고 요청마다 프록시를 명시합니다 — 저장 전에 확인하는 것이 목적이기 때문입니다.
|
|
*
|
|
* @since 7.0.8
|
|
*/
|
|
class OutboundProxyTester
|
|
{
|
|
/**
|
|
* 제출된 프록시 설정으로 외부 연결을 시도합니다.
|
|
*
|
|
* @param string $proxyUrl 검사할 프록시 주소
|
|
* @param array<int, string> $bypass 프록시 예외 목록
|
|
* @return array{success: bool, message_key: string, egress_ip: string|null, elapsed_ms: int, error: string|null} 검사 결과
|
|
*/
|
|
public function test(string $proxyUrl, array $bypass = []): array
|
|
{
|
|
// 적용 시와 같은 조립·정규화를 거친다 — 여기서 손으로 배열을 만들면 저장 전에
|
|
// 확인한 구성과 저장 후 실제로 적용되는 구성이 달라진다.
|
|
$proxyOptions = OutboundProxy::options($proxyUrl, $bypass);
|
|
|
|
if ($proxyOptions === null) {
|
|
return $this->result(false, 'settings.outbound_proxy_test_invalid_url', null, 0);
|
|
}
|
|
|
|
$urls = (array) config('core.outbound_proxy.egress_lookup_urls', []);
|
|
|
|
if ($urls === []) {
|
|
return $this->result(false, 'settings.outbound_proxy_test_no_lookup_url', null, 0);
|
|
}
|
|
|
|
$timeout = (int) config('core.outbound_proxy.test_timeout_seconds', 10);
|
|
$startedAt = microtime(true);
|
|
$lastError = null;
|
|
|
|
foreach ($urls as $url) {
|
|
try {
|
|
$response = Http::withOptions(['proxy' => $proxyOptions])
|
|
->withHeaders(['User-Agent' => 'curl/8'])
|
|
->timeout($timeout)
|
|
->get($url);
|
|
|
|
if (! $response->successful()) {
|
|
$lastError = 'HTTP '.$response->status();
|
|
|
|
continue;
|
|
}
|
|
|
|
$ip = trim($response->body());
|
|
|
|
if (filter_var($ip, FILTER_VALIDATE_IP) === false) {
|
|
$lastError = 'unexpected response body';
|
|
|
|
continue;
|
|
}
|
|
|
|
return $this->result(true, 'settings.outbound_proxy_test_success', $ip, $this->elapsedMs($startedAt));
|
|
} catch (\Throwable $e) {
|
|
// 개별 조회처 실패는 다음 후보로 넘어간다 — 한 곳이 죽어 있다고 프록시가
|
|
// 잘못됐다고 단정할 수 없기 때문이다.
|
|
$lastError = $e->getMessage();
|
|
}
|
|
}
|
|
|
|
Log::warning('아웃바운드 프록시 연결 테스트 실패', ['error' => $lastError]);
|
|
|
|
return $this->result(false, 'settings.outbound_proxy_test_failed', null, $this->elapsedMs($startedAt), $lastError);
|
|
}
|
|
|
|
/**
|
|
* 경과 시간을 밀리초로 환산합니다.
|
|
*
|
|
* @param float $startedAt 시작 시각 (microtime)
|
|
* @return int 경과 밀리초
|
|
*/
|
|
private function elapsedMs(float $startedAt): int
|
|
{
|
|
return (int) round((microtime(true) - $startedAt) * 1000);
|
|
}
|
|
|
|
/**
|
|
* 결과 배열을 구성합니다.
|
|
*
|
|
* @param bool $success 성공 여부
|
|
* @param string $messageKey 다국어 메시지 키
|
|
* @param string|null $egressIp 프록시를 거친 출발지 IP
|
|
* @param int $elapsedMs 경과 밀리초
|
|
* @param string|null $error 실패 원인 원문 (관리자 진단용)
|
|
* @return array{success: bool, message_key: string, egress_ip: string|null, elapsed_ms: int, error: string|null}
|
|
*/
|
|
private function result(bool $success, string $messageKey, ?string $egressIp, int $elapsedMs, ?string $error = null): array
|
|
{
|
|
return [
|
|
'success' => $success,
|
|
'message_key' => $messageKey,
|
|
'egress_ip' => $egressIp,
|
|
'elapsed_ms' => $elapsedMs,
|
|
'error' => $error,
|
|
];
|
|
}
|
|
}
|