기여하기

번역일: 2026년 6월 20일

기여하기

버그 리포트
지원 질문
코어 개발 논의
어느 브랜치로 보내야 하나요?
컴파일된 에셋
보안 취약점
코딩 스타일
- PHPDoc
- StyleCI
행동 강령

버그 리포트

Laravel은 단순한 버그 리포트보다 Pull Request를 통한 적극적인 협업을 권장합니다. Pull Request는 "ready for review" 상태로 표시되고 새 기능에 대한 모든 테스트가 통과될 때만 검토됩니다. "draft" 상태로 방치된 Pull Request는 며칠 후 자동으로 닫힙니다.

버그 리포트를 작성할 경우에는 명확한 제목과 문제 설명을 포함해야 합니다. 관련 정보를 최대한 상세히 기록하고, 버그를 재현할 수 있는 코드 예시를 함께 첨부해 주세요. 잘 작성된 버그 리포트는 다른 사람들이 동일한 문제를 재현하고 해결책을 찾는 데 큰 도움이 됩니다.

버그 리포트를 올린다고 해서 누군가 즉시 나타나 문제를 해결해 주리라고 기대하기는 어렵습니다. 리포트의 목적은 같은 문제를 겪는 사람들이 함께 해결책을 찾아갈 수 있는 출발점을 마련하는 것입니다. 직접 기여하고 싶다면 이슈 트래커에 등록된 버그 목록을 살펴보세요. Laravel의 전체 이슈를 보려면 GitHub에 로그인해야 합니다.

DocBlock 오류, PHPStan 경고, IDE 경고 등을 발견했다면 GitHub 이슈 대신 수정 Pull Request를 직접 제출해 주세요.

Laravel 소스 코드는 GitHub에서 관리되며, 각 프로젝트별 저장소는 다음과 같습니다.

지원 질문

GitHub 이슈 트래커는 Laravel 사용 방법에 대한 질문이나 지원 요청을 위한 공간이 아닙니다. 사용법 관련 질문은 아래 채널을 이용해 주세요.

코어 개발 논의

새로운 기능 제안이나 기존 동작 개선에 대한 아이디어는 Laravel 프레임워크 저장소의 GitHub 토론 게시판에 올릴 수 있습니다. 새 기능을 제안할 때는 해당 기능 구현에 필요한 코드의 일부라도 직접 작성할 의향이 있어야 합니다.

버그, 신기능, 기존 기능 구현에 관한 자유로운 토론은 Laravel Discord 서버의 #internals 채널에서 이루어집니다. Laravel 메인테이너인 Taylor Otwell은 평일 오전 8시~오후 5시(UTC-06:00, America/Chicago 기준)에 주로 채널에 상주하며, 그 외 시간에도 간헐적으로 참여합니다.

어느 브랜치로 보내야 하나요?

Pull Request를 어느 브랜치로 보낼지 헷갈린다면 아래 기준을 참고하세요.

버그 수정은 버그 수정을 지원하는 최신 버전 브랜치(현재 11.x)로 보내야 합니다. 다음 릴리스에만 존재하는 기능의 버그가 아닌 한, master 브랜치로 보내지 마세요.
완전한 하위 호환성을 갖춘 소규모 기능 추가는 최신 안정 브랜치(현재 11.x)로 보낼 수 있습니다.
파괴적 변경(breaking change)을 포함하는 주요 기능은 항상 다음 릴리스를 담당하는 master 브랜치로 보내야 합니다.

컴파일된 에셋

laravel/laravel 저장소의 resources/css나 resources/js 디렉터리처럼 컴파일된 파일에 영향을 주는 변경 사항을 제출할 때는, 컴파일된 파일을 커밋에 포함하지 마세요. 파일 크기가 크기 때문에 메인테이너가 실질적으로 검토하기 어려우며, 악성 코드를 Laravel에 심는 경로로 악용될 수 있습니다. 이를 방지하기 위해 모든 컴파일 파일은 Laravel 메인테이너가 직접 생성하고 커밋합니다.

보안 취약점

Laravel에서 보안 취약점을 발견했다면 GitHub 이슈 대신, Taylor Otwell에게 taylor@laravel.com으로 이메일을 보내 주세요. 모든 보안 취약점은 신속하게 처리됩니다.

코딩 스타일

Laravel은 PSR-2 코딩 표준과 PSR-4 오토로딩 표준을 따릅니다.

PHPDoc

아래는 Laravel에서 사용하는 올바른 PHPDoc 블록 예시입니다. @param 속성 뒤에 공백 두 칸, 인수 타입, 공백 두 칸, 변수명 순으로 작성하는 것에 주목하세요.

/**
 * 컨테이너에 바인딩을 등록합니다.
 *
 * @param  string|array  $abstract
 * @param  \Closure|string|null  $concrete
 * @param  bool  $shared
 * @return void
 *
 * @throws \Exception
 */
public function bind($abstract, $concrete = null, $shared = false)
{
    // ...
}

네이티브 타입 선언으로 인해 @param이나 @return이 불필요하게 중복되는 경우에는 생략할 수 있습니다.

/**
 * Job을 실행합니다.
 */
public function handle(AudioProcessor $processor): void
{
    //
}

단, 네이티브 타입이 제네릭인 경우에는 @param 또는 @return으로 제네릭 타입을 명시해야 합니다.

/**
 * 메시지의 첨부 파일 목록을 반환합니다.
 *
 * @return array<int, \Illuminate\Mail\Mailables\Attachment>
 */
public function attachments(): array
{
    return [
        Attachment::fromStorage('/path/to/file'),
    ];
}

StyleCI

코드 스타일이 완벽하지 않아도 걱정하지 마세요! StyleCI가 Pull Request가 머지된 후 자동으로 스타일을 수정해 줍니다. 덕분에 코드 스타일보다 기여의 내용 자체에 집중할 수 있습니다.

행동 강령

Laravel의 행동 강령은 Ruby의 행동 강령을 기반으로 합니다. 위반 사항은 Taylor Otwell(taylor@laravel.com)에게 신고할 수 있습니다.

참여자는 다양한 의견을 존중해야 합니다.
참여자는 개인 공격이나 타인에 대한 비하 발언을 삼가야 합니다.
다른 사람의 말과 행동을 해석할 때는 항상 선의를 가정해야 합니다.
합리적으로 괴롭힘으로 간주될 수 있는 행동은 용납되지 않습니다.