Filament를 활용한 Laravel 사용자 관리 및 이메일 인증 기능 강화

핵심 기술

본 문서는 PHP 프레임워크인 Laravel과 함께 제공되는 관리자 패널 도구인 Filament를 사용하여 사용자 관리 기능을 강화하는 방법을 안내합니다. 특히, 사용자 등록 시 이메일 인증을 필수로 설정하고, 관리자 패널에서 사용자 이메일 인증 상태를 필터링하며, 미인증 사용자에게 재인증 메일을 발송하는 기능을 구현하는 데 초점을 맞춥니다.

기술적 세부사항

• 이메일 인증 활성화:
  • IlluminateFoundationAuthUser 클래스를 상속받는 User 모델에 MustVerifyEmail 인터페이스를 구현합니다.
  • FilamentProvidersPanelProvider에서 emailVerification() 메서드를 호출하여 패널에 이메일 인증 기능을 등록합니다.
• 사용자 리소스 생성:
  • php artisan make:filament-resource User 명령어를 사용하여 User 모델에 대한 Filament 리소스를 생성합니다.
• 테이블 컬럼 설정:
  • User 리소스의 테이블에 name, email, email_verified_at, created_at 컬럼을 표시합니다.
  • email_verified_at 및 created_at 컬럼은 가독성을 높이기 위해 d m Y H:i 형식으로 포맷팅합니다.
• 필터 구현:
  • TablesFiltersFilter를 사용하여 이메일 인증 상태(email_verified_at이 null인지 아닌지)에 따라 사용자를 필터링하는 기능을 추가합니다.
  • TablesFiltersTernaryFilter를 사용하여 email_verified_at 속성에 대해 null과 not null 값을 전환하며 필터링하는 더 간결한 방법을 제공합니다.
• 테이블 액션 구현:
  • TablesActionsAction을 사용하여 이메일이 인증되지 않은 사용자에게 재인증 메일을 발송하는 resend_verification_email 액션을 추가합니다.
  • authorize 옵션을 사용하여 이메일이 이미 인증된 사용자에게는 이 액션이 표시되지 않도록 제어합니다.
  • filament()->getVerifyEmailUrl($record)을 사용하여 이메일 발송 URL을 생성하고, VerifyEmail 알림을 통해 메일을 전송합니다.
  • 사용자의 현재 패널에 맞는 재인증 URL을 가져오는 방법을 명시합니다.

개발 임팩트

• 사용자 등록 과정에서 이메일 유효성을 검증하여 계정의 신뢰도를 높일 수 있습니다.
• 관리자 패널을 통해 사용자 데이터를 효과적으로 관리하고, 특정 조건의 사용자를 신속하게 찾을 수 있습니다.
• 미인증 사용자에 대한 자동화된 재인증 메일 발송 기능으로 사용자 경험을 개선하고 관리자의 수작업 부담을 줄일 수 있습니다.

커뮤니티 반응

원문에는 커뮤니티 참여를 독려하는 내용(Join the community on filamentmastery.com — it's free!)이 포함되어 있습니다.