barryvdh/laravel-ide-helper

어떤 프로젝트인가요?

핵심 기능

• 01`ide-helper:generate`로 facade 자동 완성 파일을 생성합니다.
• 02컬럼, 관계, 접근자에 대한 모델 PHPDoc을 작성합니다.
• 03컨테이너 해석을 위한 PhpStorm 메타 파일을 생성합니다.
• 04mixin을 사용해 모델 문서를 별도 파일에 작성할 수 있습니다.
• 05매크로, Fluent 마이그레이션 메서드, factory builder를 처리합니다.

활용 사례

• PhpStorm에서 Eloquent 모델의 속성과 관계를 정확하게 자동 완성할 수 있습니다.
• 생성기를 다시 실행해 스키마나 의존성이 변경된 뒤에도 IDE 힌트를 최신 상태로 유지할 수 있습니다.
• Laravel 프로젝트에서 IDE가 facade와 컨테이너 바인딩을 이해하도록 도울 수 있습니다.

빠른 시작

1. 1

   Composer에서 패키지를 개발 의존성으로 설치하기

   composer require --dev barryvdh/laravel-ide-helper
2. 2

   Facade 자동 완성 파일 생성하기

   php artisan ide-helper:generate
3. 3

   모델용 PHPDoc을 생성해 모델 파일에 작성하기

   php artisan ide-helper:models -RW

사용 전 알아둘 점

• !모델 PHPDoc을 생성하려면 데이터베이스 연결이 정상적으로 작동해야 합니다.
• !3.x 브랜치는 Laravel 10 이상을 지원합니다. 이전 Laravel 버전에는 2.x 릴리스를 사용해야 합니다.

토픽

자주 묻는 질문

laravel-ide-helper은(는) 무엇인가요?

Laravel facade와 Eloquent 모델의 PHPDoc 파일을 생성해 PhpStorm 같은 IDE에서 정확한 자동 완성을 지원합니다. IDE Helper for Laravel은 프로젝트 자체 코드에서 헬퍼 파일을 생성해 에디터에서 정확한 자동 완성을 제공하는 Composer 개발 의존성입니다. `php artisan ide-helper:generate`를 실행하면 Laravel facade를 설명하는 파일이 생성되고, `ide-helper:models`는 테이블 컬럼, 관계, getter/setter를 바탕으로 Eloquent 모델의 PHPDoc을 작성합니다.

laravel-ide-helper은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

laravel-ide-helper은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

laravel-ide-helper은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. laravel-ide-helper의 마지막 커밋은 2026년 11월 3일입니다.

laravel-ide-helper은(는) 어디에 사용할 수 있나요?

PhpStorm에서 Eloquent 모델의 속성과 관계를 정확하게 자동 완성할 수 있습니다. 생성기를 다시 실행해 스키마나 의존성이 변경된 뒤에도 IDE 힌트를 최신 상태로 유지할 수 있습니다. Laravel 프로젝트에서 IDE가 facade와 컨테이너 바인딩을 이해하도록 도울 수 있습니다.

laravel-ide-helper는 어떻게 설치하나요?

Composer에서 패키지를 개발 의존성으로 설치하기: composer require --dev barryvdh/laravel-ide-helper Facade 자동 완성 파일 생성하기: php artisan ide-helper:generate 모델용 PHPDoc을 생성해 모델 파일에 작성하기: php artisan ide-helper:models -RW

laravel-ide-helper은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/barryvdh/laravel-ide-helper