1
namespace App\Services;
2

3
use App\Models\User;
4
use App\Exceptions\NotEnoughPointsException;
5

6
class OrderService
7
{
8
    public function purchase(User $user, int $amount): void
9
    {
10
        // 비즈니스 규칙 "포인트가 결제 금액보다 적으면 결제 할 수 없다."
11
        if ($user->points < $amount) {
12
            throw new NotEnoughPointsException("포인트가 부족합니다."); // 비즈니스 예외 throw
13
        }
14
        // 실제 결제 로직...
15
        $user->points -= $amount;
16
        $user->save();
17
    }
18
}

1
namespace App\Services;
2

3
use App\Models\User;
4
use Illuminate\Database\QueryException;
5
use RuntimeException;
6

7
class UserService
8
{
9
    public function updateEmail(int $userId, string $newEmail): void
10
    {
11
        try {
12
            $user = User::findOrFail($userId);
13
            $user->email = $newEmail;
14
            $user->save();
15
        } catch (QueryException $e) {
16
            // DB 연결 오류, SQL 구문 오류 등
17
            throw new RuntimeException("이메일 저장 중 시스템 오류 발생", 0, $e);
18
        }
19
    }
20
}

1
function throwExceptionDynamically(string $exceptionClass, string $message): void
2
{
3
    throw new $exceptionClass($message); // ← 여기서 어떤 예외가 던져질지 IDE가 추론 못함
4
}
5

6
// 호출부
7
throwExceptionDynamically(\RuntimeException::class, '뭔가 잘못됐음');

1
/**
2
 * @throws \App\Exceptions\DomainException
3
 */
4
function throwMatchedException(string $type): void
5
{
6
    $exception = match ($type) {
7
        'runtime' => new \RuntimeException('런타임 예외'),
8
        'logic'   => new \LogicException('로직 예외'),
9
        'custom'  => new \App\Exceptions\DomainException('비즈니스 예외'), // IDE에서 추론 가능
10
        default   => throw new \InvalidArgumentException("Unknown type"),
11
    };
12

13
    throw $exception;
14
}
15

16
/**
17
 * @throws \App\Exceptions\DomainException // 호출부도 추론 가능
18
 */
19
throwMatchedException($type);

1
namespace App\Services;
2

3
use App\Pipes;
4
use App\Repositories\CommentRepository;
5
use Illuminate\Pipeline\Pipeline;
6

7
class CommentService
8
{
9
    protected $repository;
10
    protected $pipeline;
11

12
    public function __construct(CommentRepository $repository, Pipeline $pipeline)
13
    {
14
        $this->repository = $repository;
15
        $this->pipeline = $pipeline;
16
    }
17

18
    // 개발자가 추론해서 @throws 태그를 명시해야 하지만, 실수할 여지가 생김
19
    public function save(int $userId, string $message): Comment
20
    {
21
        return $this->pipeline
22
            ->send($message)
23
            ->through([
24
                // 개별 Pipe 안에서 비즈니스 예외가 발생해도 IDE가 추론 불가능
25
                Pipes\RemoveBadWords::class,
26
                Pipes\RemoveScripts::class,
27
                Pipes\GenerateLinks::class,
28
                // ...
29
            ])
30
            ->then(function (string $message) use ($userId) {
31
                return $this->repository->save([
32
                    'message' => $message,
33
                    'user_id' => $userId,
34
                ])
35
            });
36
    }
37
}

1
use Illuminate\Support\Facades\DB;
2
use App\Exceptions\PointLackException;
3
use App\Exceptions\CouponExpiredException;
4
use Throwable;
5

6
/**
7
 * @throws PointLackException
8
 * @throws CouponExpiredException
9
 * @throws Throwable // IDE 경고를 막기 위해 실제 비즈니스 로직과 관계없는 예외까지 명시함
10
 */
11
public function applyDiscountWithStrictSpec(int $userId): void
12
{
13
    DB::transaction(function () use ($userId) {
14
        $user = $this->userRepository->findById($userId);
15

16
        if ($user->point < 1000) {
17
            throw new PointLackException("포인트 부족");
18
        }
19

20
        if ($user->coupon->isExpired()) {
21
            throw new CouponExpiredException("쿠폰 만료");
22
        }
23

24
        $user->applyDiscount();
25
    });
26
}

1
use Illuminate\Support\Facades\DB;
2
use App\Exceptions\PointLackException;
3
use App\Exceptions\CouponExpiredException;
4
use Throwable;
5

6
/**
7
 * @throws PointLackException
8
 * @throws CouponExpiredException
9
 */
10
public function applyDiscount(int $userId): void
11
{
12
    try {
13
        DB::transaction(function () use ($userId) {
14
            $user = $this->userRepository->findById($userId);
15

16
            if ($user->point < 1000) {
17
                throw new PointLackException("포인트 부족");
18
            }
19

20
            if ($user->coupon->isExpired()) {
21
                throw new CouponExpiredException("쿠폰 만료");
22
            }
23

24
            $user->applyDiscount();
25
        });
26
    } catch (Throwable $e) {
27
        // IDE 경고를 우회하기 위한 런타임 오버헤드 발생
28
        throw wrapException($e) // 비즈니스 예외는 그대로 다시 throw, 나머진 언체크드 예외로 래핑해서 throw
29
    }
30
}