fix(core,extensions): 확장 쓰기 경로 공통화 · HTMLPurifier 정의 캐시 storage 이전

https://github.com/gnuboard/g7/issues/125 — 상품 상세설명을 HTML 로 저장할 때
HTMLPurifier 가 모듈 vendor 폴더 안에 정의 캐시를 만들려다 실패해 저장이 매번 500 으로
끝나던 문제를 고친다. vendor 를 읽기 전용으로 두는 표준 배포에서 그 쓰기는 예외가 아니라
PHP 경고로 나오고 Laravel 이 이를 ErrorException 으로 승격시킨다. 캐시는 설정 해시당 1회만
기록되므로 캐시가 영영 생기지 않아 재시도해도 같은 결과였다.

캐시 경로를 storage 아래로 옮기고, 그 경로마저 확보하지 못하면 캐시만 끄고 정화는 그대로
수행한다 — 캐시는 성능 장치이고 정화는 보안 장치라, 전자의 실패가 후자를 건너뛰게 만들면
안 된다. 저장은 성공하므로 운영자에게 도달하는 흔적이 로그 하나뿐이라 error 수준으로 남긴다
(출하 기본 로그 수준이 error 라 warning 은 기본 설치 상태에서 파일에 남지 않는다).

그 과정에서 갈라져 있던 두 축을 코어 한 곳으로 모은다.

- 쓰기 디렉토리 확보: 억제 생성·chmod·setgid·소유권 상속·쓰기 판정 절차가 정적 게시와
 정의 캐시 두 곳에 서로 다른 하드닝으로 복제돼 있었다(억제 mkdir·setgid·clearstatcache 가
 사본마다 한쪽씩 빠져 있었다). FilePermissionHelper 의 ensureWritableDirectory 와
 hardenDirectory 로 통합하고, 실패 사유는 out 파라미터로 올려 정책(조용한 성능 저하 대
 시끄러운 실패)은 호출부가 정하게 둔다.

- 확장 저장 경로: storage_path('app/modules/…') 손조립이 30곳에 흩어져 있어 테스트 격리
 분기를 넣으려면 사본마다 복제해야 했고, 한 곳만 빠뜨려도 그 확장의 테스트가 운영 설정
 파일을 덮어쓴다. 디스크 root 를 단일 출처로 읽는 ExtensionStoragePath 로 전환하고 테스트
 분기는 config/filesystems.php 한 줄에서 끝낸다.

함께 고친 것

- 테스트가 운영 라우트 캐시로 부팅해 확장 allowlist 가 라우트 축에서 통째로 무력화되던
 문제. 삭제가 아니라 경로를 돌린다 — 라우트 캐시는 확장 작업 전까지 재생성되지 않아,
 삭제하면 운영 사이트가 그때까지 라우트 파일 스캔 경로로 떨어진다.
- PHPUnit 프로세스가 확장 vendor 의 제3자 composer 패키지를 오토로드하지 않아 그 패키지를
 쓰는 코드 경로가 통째로 테스트 불가였던 문제. 확장 자신의 오토로더를 그대로 쓰면 활성
 디렉토리가 _bundled 를 이기고 base path 유추까지 깨지므로, 생성된 맵에서 제3자 항목만
 골라 별도 로더로 등록한다.
- 게시 폴더가 setgid 를 갖지 않아, 명령줄과 웹이 번갈아 만든 하위 폴더를 다른 쪽이 쓰지
 못하던 문제.
- 관리자 템플릿이 HTML 정화 라이브러리를 직접 지정하지 않아 전이 의존으로 딸려온 구버전이
 쓰이던 문제.

동반 산출물

- 규정 표(·AGENTS.md) 6행 + storage-driver/service-repository/testing-guide 문서
- audit 룰 2종 + coverage 6항목. 저장소가 이미 전량 전환돼 전수 실행이 공허 통과하므로
 판정식은 픽스처 36건이 잠근다
- INSTALL.md 에 설치 후 파일 권한 절 추가 (vendor 쓰기 권한 불요를 명시)
This commit is contained in:
HeuJung committed 2026-08-28 15:22:22 +09:00
1 parent fc27a6edf6
commit 85e266d361
88 files changed
+1913 -332

No files matched your search

@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftCkeditor5\V1_0_2\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -30,11 +31,6 @@ use Illuminate\Support\Facades\File;
*/
final class SeedUnusedImageCleanupSettings implements DataMigration
{
/**
* 플러그인 설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/plugins/sirsoft-ckeditor5/settings/setting.json';
/**
* 백필할 기본값 (키 => 기본값).
*
@@ -62,7 +58,9 @@ final class SeedUnusedImageCleanupSettings implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 플러그인 설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-ckeditor5', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[sirsoft-ckeditor5] 설정 파일 없음 — 설치 시 defaults.json 이 시드하므로 skip');
@@ -108,7 +108,7 @@ abstract class PluginTestCase extends TestCase
* 플러그인 스토리지('plugins' 디스크)를 테스트 전용 임시 디렉토리로 격리한다.
*
* 설정 저장 테스트(PluginSettingsService::save)는 코어 'plugins' 디스크
* (root = storage_path('app/plugins'))에 setting.json 을 쓴다. 격리하지 않으면
* (root = `plugins` 디스크, config/filesystems.php)에 setting.json 을 쓴다. 격리하지 않으면
* 테스트가 실제 로컬 런타임 설정 파일을 덮어써 검수 모드/자격증명이 오염된다
* (RefreshDatabase 는 DB 만 롤백하고 파일시스템은 되돌리지 않음). 디스크 root 를
* 임시 경로로 바꾸고 resolved 인스턴스를 purge 하여 실제 파일을 원천적으로 못
@@ -7,6 +7,7 @@
## [1.1.2] - 2026-08-22
### Changed
- 코어 최소 요구 버전을 7.0.10 으로 상향
- 코어 최소 요구 버전을 7.0.8 로 상향했습니다.
@@ -13,7 +13,7 @@
"ko": "KG 이니시스 결제 게이트웨이 (표준결제창 연동, 일본결제 지원)",
"en": "KG Inicis payment gateway (standard payment window, Japan payment support)"
},
"g7_version": ">=7.0.8",
"g7_version": ">=7.0.10",
"dependencies": {
"modules": {
"sirsoft-ecommerce": ">=1.1.0"
@@ -5,9 +5,10 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayKginicis\Tests\Unit\Upgrades;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use App\Upgrades\Data\Ext\Plugins\SirsoftPayKginicis\V1_0_1\Migrations\BackfillEasyPayPgProvider;
use Illuminate\Support\Facades\File;
use Tests\TestCase;
use Plugins\Sirsoft\PayKginicis\Tests\PluginTestCase;
require_once dirname(__DIR__, 3).'/upgrades/data/1.0.1/migrations/BackfillEasyPayPgProvider.php';
@@ -18,7 +19,7 @@ require_once dirname(__DIR__, 3).'/upgrades/data/1.0.1/migrations/BackfillEasyPa
* 있다. 서버가 이 값을 보고 간편결제 주문을 "PG 결제가 아닌 주문" 으로 오인해 결제 실패
* 시 관리자 알림 오발송 + 임시주문 삭제(재결제 불가) 를 일으켰다.
*/
class BackfillEasyPayPgProviderTest extends TestCase
class BackfillEasyPayPgProviderTest extends PluginTestCase
{
private string $settingsPath;
@@ -30,7 +31,7 @@ class BackfillEasyPayPgProviderTest extends TestCase
{
parent::setUp();
$this->settingsPath = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$this->settingsPath = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
$this->hadOriginalSettings = File::exists($this->settingsPath);
$this->originalSettings = $this->hadOriginalSettings ? File::get($this->settingsPath) : null;
@@ -5,6 +5,7 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayKginicis\Tests\Unit\Upgrades;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use App\Upgrades\Data\Ext\Plugins\SirsoftPayKginicis\V1_0_0\Migrations\MigrateNaverpayBrandButtonKey;
use Illuminate\Support\Facades\File;
use Plugins\Sirsoft\PayKginicis\Tests\PluginTestCase;
@@ -23,7 +24,7 @@ class MigrateNaverpayBrandButtonKeyTest extends PluginTestCase
{
parent::setUp();
$this->settingsPath = storage_path('app/plugins/sirsoft-pay_kginicis/settings/setting.json');
$this->settingsPath = ExtensionStoragePath::plugin('sirsoft-pay_kginicis', 'settings').'/setting.json';
$this->hadOriginalSettings = File::exists($this->settingsPath);
$this->originalSettings = $this->hadOriginalSettings ? File::get($this->settingsPath) : null;
@@ -6,6 +6,7 @@ namespace Plugins\Sirsoft\PayKginicis\Upgrades;
use App\Contracts\Extension\UpgradeStepInterface;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -37,8 +38,6 @@ use Illuminate\Support\Facades\File;
*/
class Upgrade_1_0_0_beta_4 implements UpgradeStepInterface
{
private const ECOMMERCE_SETTINGS_PATH = 'app/modules/sirsoft-ecommerce/settings/order_settings.json';
private const EASY_PAY_IDS = [
'kginicis_samsung_pay',
'kginicis_naverpay',
@@ -48,7 +47,9 @@ class Upgrade_1_0_0_beta_4 implements UpgradeStepInterface
public function run(UpgradeContext $context): void
{
$path = storage_path(self::ECOMMERCE_SETTINGS_PATH);
// 이커머스 모듈의 주문설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로
// 조립한다 — 확장마다 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 건드린다.
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! File::exists($path)) {
$context->logger->info('[v1.0.0-beta.4] 이커머스 order_settings.json 없음 — 첫 진입 시 자동 생성되므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayKginicis\V1_0_0\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -20,8 +21,6 @@ use Illuminate\Support\Facades\File;
*/
final class MigrateNaverpayBrandButtonKey implements DataMigration
{
private const SETTINGS_PATH = 'app/plugins/sirsoft-pay_kginicis/settings/setting.json';
private const OLD_KEY = 'easy_pay_naverpay_brand_button';
private const NEW_KEY = 'easy_pay_show_brand_button';
@@ -43,7 +42,9 @@ final class MigrateNaverpayBrandButtonKey implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 설정 파일 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-pay_kginicis', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[v1.0.0] KG 이니시스 설정 파일 없음 — 기본값으로 동작하므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayKginicis\V1_0_1\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -30,11 +31,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillEasyPayPgProvider implements DataMigration
{
/**
* 이커머스 모듈의 주문설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/modules/sirsoft-ecommerce/settings/order_settings.json';
/**
* 이 플러그인이 등록하는 간편결제 수단의 ID 접두사.
*/
@@ -62,7 +58,9 @@ final class BackfillEasyPayPgProvider implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이커머스 모듈의 주문설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! File::exists($path)) {
$context->logger->info('[kginicis] 이커머스 주문설정 파일 없음 — 기본값으로 동작하므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayKginicis\V1_1_0\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -34,11 +35,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillShopBaseRedirectUrls implements DataMigration
{
/**
* 이 플러그인의 설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/plugins/sirsoft-pay_kginicis/settings/setting.json';
/**
* 예전 기본값 => 새 기본값. 저장값이 좌변과 정확히 같을 때만 우변으로 바꾼다.
*
@@ -66,7 +62,9 @@ final class BackfillShopBaseRedirectUrls implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이 플러그인의 설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-pay_kginicis', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[kginicis] 설정 파일 없음 — 새 기본값으로 동작하므로 skip');
@@ -11,6 +11,10 @@
- 관리자 주문 조회·에스크로 배송등록 API가 세부 권한을 검사하도록 수정했습니다. 이전에는 관리자 계정이면 주문 권한이 없어도 주문번호·결제정보·수령인 연락처와 주소를 조회하고 배송등록까지 할 수 있었습니다. 이제 조회는 주문 조회 권한, 배송등록은 주문 수정 권한이 필요하며, 다른 결제대행사 연동과 같은 기준이 적용됩니다. (KISA 측에서 제보해주셨습니다 — KVE-2026-1893)
- 가상계좌 입금통보 주소 조회와 시스템 점검 API에도 설정 조회 권한 검사를 추가했습니다.
### Changed
- 코어 최소 요구 버전을 7.0.10 으로 상향
## [1.0.2] - 2026-08-19
### Security
@@ -13,7 +13,7 @@
"ko": "NHN KCP 결제 게이트웨이 (Standard Pay 연동)",
"en": "NHN KCP payment gateway (Standard Pay integration)"
},
"g7_version": ">=7.0.5",
"g7_version": ">=7.0.10",
"dependencies": {
"modules": {
"sirsoft-ecommerce": ">=1.1.0"
@@ -5,6 +5,7 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayNhnkcp\Listeners;
use App\Contracts\Extension\HookListenerInterface;
use App\Support\ExtensionStoragePath;
class RegisterPgProviderListener implements HookListenerInterface
{
@@ -139,7 +140,7 @@ class RegisterPgProviderListener implements HookListenerInterface
private function isNhnKcpDefaultPg(): bool
{
$path = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! file_exists($path)) {
return false;
@@ -5,9 +5,10 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayNhnkcp\Tests\Unit\Upgrades;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use App\Upgrades\Data\Ext\Plugins\SirsoftPayNhnkcp\V1_0_0_beta_4\Migrations\BackfillEasyPayPgProvider;
use Illuminate\Support\Facades\File;
use Tests\TestCase;
use Plugins\Sirsoft\PayNhnkcp\Tests\PluginTestCase;
require_once dirname(__DIR__, 3).'/upgrades/data/1.0.0-beta.4/migrations/BackfillEasyPayPgProvider.php';
@@ -18,7 +19,7 @@ require_once dirname(__DIR__, 3).'/upgrades/data/1.0.0-beta.4/migrations/Backfil
* 있다. 서버가 이 값을 보고 간편결제 주문을 "PG 결제가 아닌 주문" 으로 오인해 결제 실패
* 시 관리자 알림 오발송 + 임시주문 삭제(재결제 불가) 를 일으켰다.
*/
class BackfillEasyPayPgProviderTest extends TestCase
class BackfillEasyPayPgProviderTest extends PluginTestCase
{
private string $settingsPath;
@@ -30,7 +31,7 @@ class BackfillEasyPayPgProviderTest extends TestCase
{
parent::setUp();
$this->settingsPath = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$this->settingsPath = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
$this->hadOriginalSettings = File::exists($this->settingsPath);
$this->originalSettings = $this->hadOriginalSettings ? File::get($this->settingsPath) : null;
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayNhnkcp\V1_0_0_beta_4\Migration
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -30,11 +31,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillEasyPayPgProvider implements DataMigration
{
/**
* 이커머스 모듈의 주문설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/modules/sirsoft-ecommerce/settings/order_settings.json';
/**
* 이 플러그인이 등록하는 간편결제 수단의 ID 접두사.
*/
@@ -62,7 +58,9 @@ final class BackfillEasyPayPgProvider implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이커머스 모듈의 주문설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! File::exists($path)) {
$context->logger->info('[nhnkcp] 이커머스 주문설정 파일 없음 — 기본값으로 동작하므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayNhnkcp\V1_0_1\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -34,11 +35,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillShopBaseRedirectUrls implements DataMigration
{
/**
* 이 플러그인의 설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/plugins/sirsoft-pay_nhnkcp/settings/setting.json';
/**
* 예전 기본값 => 새 기본값. 저장값이 좌변과 정확히 같을 때만 우변으로 바꾼다.
*
@@ -66,7 +62,9 @@ final class BackfillShopBaseRedirectUrls implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이 플러그인의 설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-pay_nhnkcp', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[nhnkcp] 설정 파일 없음 — 새 기본값으로 동작하므로 skip');
@@ -11,6 +11,7 @@
- 가상계좌 환불·에스크로 배송등록·결제 서명 요청의 입력값에 형식·길이 검증을 추가했습니다. 잘못된 형식의 환불 계좌 정보(계좌번호·은행코드·예금주)는 PG 호출 전에 차단됩니다.
### Changed
- 코어 최소 요구 버전을 7.0.10 으로 상향
- 결제 서명(SignData) 요청의 필수값 누락 응답이 표준 검증 응답(422)으로 통일되었습니다.
- 주문·결제 정보 조회가 데이터베이스 표 이름을 직접 쓰지 않고 쇼핑몰 모듈의 정의를 따르도록 내부 정리했습니다. 표시되는 내용과 동작은 종전과 동일합니다.
@@ -13,7 +13,7 @@
"ko": "나이스페이먼츠 결제 게이트웨이 (통합결제창 연동)",
"en": "NicePayments gateway (integrated payment window)"
},
"g7_version": ">=7.0.5",
"g7_version": ">=7.0.10",
"dependencies": {
"modules": {
"sirsoft-ecommerce": ">=1.1.0"
@@ -5,6 +5,7 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayNicepayments\Listeners;
use App\Contracts\Extension\HookListenerInterface;
use App\Support\ExtensionStoragePath;
class RegisterPgProviderListener implements HookListenerInterface
{
@@ -109,7 +110,7 @@ class RegisterPgProviderListener implements HookListenerInterface
private function isNicepayDefaultPg(): bool
{
$path = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! file_exists($path)) {
return false;
@@ -5,9 +5,10 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\PayNicepayments\Tests\Unit\Upgrades;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use App\Upgrades\Data\Ext\Plugins\SirsoftPayNicepayments\V1_0_0_beta_4\Migrations\BackfillEasyPayPgProvider;
use Illuminate\Support\Facades\File;
use Tests\TestCase;
use Plugins\Sirsoft\PayNicepayments\Tests\PluginTestCase;
require_once dirname(__DIR__, 3).'/upgrades/data/1.0.0-beta.4/migrations/BackfillEasyPayPgProvider.php';
@@ -18,7 +19,7 @@ require_once dirname(__DIR__, 3).'/upgrades/data/1.0.0-beta.4/migrations/Backfil
* 있다. 서버가 이 값을 보고 간편결제 주문을 "PG 결제가 아닌 주문" 으로 오인해 결제 실패
* 시 관리자 알림 오발송 + 임시주문 삭제(재결제 불가) 를 일으켰다.
*/
class BackfillEasyPayPgProviderTest extends TestCase
class BackfillEasyPayPgProviderTest extends PluginTestCase
{
private string $settingsPath;
@@ -30,7 +31,7 @@ class BackfillEasyPayPgProviderTest extends TestCase
{
parent::setUp();
$this->settingsPath = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$this->settingsPath = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
$this->hadOriginalSettings = File::exists($this->settingsPath);
$this->originalSettings = $this->hadOriginalSettings ? File::get($this->settingsPath) : null;
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayNicepayments\V1_0_0_beta_4\Mig
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -30,11 +31,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillEasyPayPgProvider implements DataMigration
{
/**
* 이커머스 모듈의 주문설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/modules/sirsoft-ecommerce/settings/order_settings.json';
/**
* 이 플러그인이 등록하는 간편결제 수단의 ID 접두사.
*/
@@ -62,7 +58,9 @@ final class BackfillEasyPayPgProvider implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이커머스 모듈의 주문설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! File::exists($path)) {
$context->logger->info('[nicepayments] 이커머스 주문설정 파일 없음 — 기본값으로 동작하므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftPayNicepayments\V1_0_1\Migrations
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -34,11 +35,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillShopBaseRedirectUrls implements DataMigration
{
/**
* 이 플러그인의 설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/plugins/sirsoft-pay_nicepayments/settings/setting.json';
/**
* 예전 기본값 => 새 기본값. 저장값이 좌변과 정확히 같을 때만 우변으로 바꾼다.
*
@@ -66,7 +62,9 @@ final class BackfillShopBaseRedirectUrls implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이 플러그인의 설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-pay_nicepayments', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[nicepayments] 설정 파일 없음 — 새 기본값으로 동작하므로 skip');
@@ -12,6 +12,10 @@
- 결제 실패 시 이동하는 페이지 주소에 서버 내부 오류 원문이 그대로 실려 나가던 문제를 수정했습니다. 이제 안내 문구만 전달되며, 원인 파악에 필요한 원문은 서버 로그에만 기록됩니다.
- 플러그인 설정 저장이 실패했을 때 실패 사유 대신 일반 안내 문구만 표시되던 문제를 수정했습니다. 이제 서버가 알려준 사유가 그대로 안내됩니다.
### Changed
- 코어 최소 요구 버전을 7.0.10 으로 상향
## [1.0.1] - 2026-08-11
### Fixed
@@ -11,7 +11,7 @@
"ko": "토스페이먼츠 결제 게이트웨이 (통합결제창 연동)",
"en": "TossPayments gateway (integrated payment window)"
},
"g7_version": ">=7.0.0",
"g7_version": ">=7.0.10",
"dependencies": {
"modules": {
"sirsoft-ecommerce": ">=1.1.0"
@@ -5,6 +5,7 @@ declare(strict_types=1);
namespace Plugins\Sirsoft\Tosspayments\Tests\Unit\Upgrade;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use App\Upgrades\Data\Ext\Plugins\SirsoftTosspayments\V1_0_1\Migrations\BackfillTossPgProvider;
use Illuminate\Support\Facades\File;
use Plugins\Sirsoft\Tosspayments\Tests\PluginTestCase;
@@ -37,7 +38,7 @@ class BackfillTossPgProviderTest extends PluginTestCase
require_once base_path('plugins/_bundled/sirsoft-tosspayments/upgrades/data/1.0.1/migrations/BackfillTossPgProvider.php');
$this->settingsPath = storage_path('app/modules/sirsoft-ecommerce/settings/order_settings.json');
$this->settingsPath = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
$this->hadOriginalSettings = File::exists($this->settingsPath);
$this->originalSettings = $this->hadOriginalSettings ? File::get($this->settingsPath) : null;
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftTosspayments\V1_0_0\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -34,11 +35,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillShopBaseRedirectUrls implements DataMigration
{
/**
* 이 플러그인의 설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/plugins/sirsoft-tosspayments/settings/setting.json';
/**
* 예전 기본값 => 새 기본값. 저장값이 좌변과 정확히 같을 때만 우변으로 바꾼다.
*
@@ -66,7 +62,9 @@ final class BackfillShopBaseRedirectUrls implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이 플러그인의 설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::plugin('sirsoft-tosspayments', 'settings').'/setting.json';
if (! File::exists($path)) {
$context->logger->info('[tosspayments] 설정 파일 없음 — 새 기본값으로 동작하므로 skip');
@@ -7,6 +7,7 @@ namespace App\Upgrades\Data\Ext\Plugins\SirsoftTosspayments\V1_0_1\Migrations;
use App\Extension\Helpers\FilePermissionHelper;
use App\Extension\Upgrade\DataMigration;
use App\Extension\UpgradeContext;
use App\Support\ExtensionStoragePath;
use Illuminate\Support\Facades\File;
/**
@@ -29,11 +30,6 @@ use Illuminate\Support\Facades\File;
*/
final class BackfillTossPgProvider implements DataMigration
{
/**
* 이커머스 모듈의 주문설정 저장 경로.
*/
private const SETTINGS_PATH = 'app/modules/sirsoft-ecommerce/settings/order_settings.json';
/**
* 이 플러그인이 등록하는 주문서형 결제수단의 ID 접두사.
*/
@@ -61,7 +57,9 @@ final class BackfillTossPgProvider implements DataMigration
*/
public function run(UpgradeContext $context): void
{
$path = storage_path(self::SETTINGS_PATH);
// 이커머스 모듈의 주문설정 저장 경로. 절대 경로는 코어 해석기가 디스크 root 를 기준으로 조립한다 — 확장마다
// 경로를 직접 조립하면 테스트 환경에서 운영 설정 파일을 그대로 건드리게 된다.
$path = ExtensionStoragePath::module('sirsoft-ecommerce', 'settings').'/order_settings.json';
if (! File::exists($path)) {
$context->logger->info('[tosspayments] 이커머스 주문설정 파일 없음 — 기본값으로 동작하므로 skip');
@@ -110,7 +110,7 @@ abstract class PluginTestCase extends TestCase
* 플러그인 스토리지('plugins' 디스크)를 테스트 전용 임시 디렉토리로 격리한다.
*
* 설정 저장 테스트(PluginSettingsService::save)는 코어 'plugins' 디스크
* (root = storage_path('app/plugins'))에 setting.json 을 쓴다. 격리하지 않으면
* (root = `plugins` 디스크, config/filesystems.php)에 setting.json 을 쓴다. 격리하지 않으면
* 테스트가 실제 로컬 런타임 설정 파일을 덮어써 라이브 모드/자격증명이 오염된다
* (RefreshDatabase 는 DB 만 롤백하고 파일시스템은 되돌리지 않음). 디스크 root 를
* 임시 경로로 바꾸고 resolved 인스턴스를 purge 하여 실제 파일을 원천적으로 못