Files
sam-sales/etax/dev.md
aweso 2ab3534278 바로빌 전자세금계산서 솔루션 연결
🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-14 09:15:03 +09:00

28 lines
1.1 KiB
Markdown

# Etax 개발 노트
## API 오류 해결 가이드
### 바로빌 SOAP 클라이언트 미설치 오류 (500 Error)
**문제 상황:**
서버에 PHP SOAP 확장 모듈이 설치되어 있지 않은 경우(`Class 'SoapClient' not found`), `new SoapClient()` 호출 시 치명적인 오류(Fatal Error)가 발생하여 HTTP 500 상태 코드를 반환합니다.
**해결 방법:**
`soapClient` 생성 로직을 `try-catch` 블록으로 감싸되, `Exception`이 아닌 **`Throwable`**을 catch해야 합니다. PHP 7+에서는 치명적인 오류가 `Error` 객체로 던져지며, 이는 `Exception`이 아닌 `Throwable` 인터페이스를 구현하기 때문입니다.
**수정 예시:**
```php
$barobillSoapClient = null;
try {
$barobillSoapClient = new SoapClient($url, $options);
} catch (Throwable $e) {
// Class not found 등의 Fatal Error도 여기서 잡힘
error_log('SOAP Client 생성 실패: ' . $e->getMessage());
// 이후 로직에서 $barobillSoapClient가 null일 경우의 대체 로직(예: 시뮬레이션 모드) 수행
}
```
**적용 파일:**
- `etax/api/barobill_config.php`
- `etax/api/issue.php` (전역 에러 핸들링)