Active

인증된 제출자

watson/active

제출자 이우진

최신 v7.3.0라이센스 MIT배포 2026년 10월 4일

현재 라우트, 컨트롤러와 액션을 확인하는 Laravel 헬퍼

GitHub

Laravel용 Active

Active는 현재 경로나 라우트를 쉽게 확인할 수 있게 해 주는 Laravel 헬퍼 패키지입니다. Bootstrap에서 사용하는 것과 같은 active 클래스를 추가하거나, 특정 라우트가 활성 상태일 때만 동작을 수행하는 데 유용합니다. 현재 컨트롤러와 액션의 이름을 가져오는 헬퍼도 제공합니다.

설치

먼저 Composer로 패키지를 설치하세요.

composer require watson/active

Laravel 5.1을 사용하나요? 해당 버전에서 사용할 수 있는 이 패키지의 마지막 버전은 2.0.4입니다.

다음으로 config/app.php 파일에 서비스 프로바이더를 추가하세요.

Watson\Active\ActiveServiceProvider::class

헬퍼 함수 대신 파사드를 사용하려면 aliases 배열에 다음 항목을 추가하세요.

'Active' => Watson\Active\Facades\Active::class

Active 사용하기

헬퍼 함수

Active는 파사드나 별도 인스턴스 없이 사용할 수 있는 헬퍼 함수를 제공합니다.

active()
is_active()

`active()` 사용하기

현재 페이지와 비교할 라우트나 경로를 배열로 전달하세요. 하나라도 일치하면 Bootstrap에서 사용할 수 있는 active 문자열을 반환합니다. 두 번째 인수로 원하는 반환 문자열을 지정할 수도 있습니다.

active(['login', 'users/*', 'posts.*', 'pages.contact']); // 현재 라우트가 경로나 라우트 이름 중 하나와 일치하면 'active'를 반환합니다.

active(['login', 'logout'], 'active-class'); // 현재 라우트가 'login' 또는 'logout'이면 'active-class'를 반환합니다.

active(['login', 'logout'], 'active-class', 'fallback-class'); // 현재 라우트가 'login'도 'logout'도 아니면 'fallback-class'를 반환합니다.

첫 번째 예제에서는 현재 경로가 login이거나 users/로 시작할 때, 또는 현재 라우트 이름이 posts.create일 때 active를 반환합니다.

일반 경로 문자열, * 와일드카드가 포함된 경로, 이름이 지정된 라우트를 모두 인수로 사용할 수 있습니다.

링크의 클래스에 이 함수를 사용하면 현재 페이지에 해당하는 링크를 활성 상태로 표시할 수 있습니다.

<a href="{{ route('posts.index') }}" class="{{ active('posts.index') }}">All posts</a>

일치 여부를 판단할 때 특정 경로나 라우트를 제외할 수도 있습니다.

active(['pages/*', 'not:pages/contact'])

active(['pages.*', 'not:pages.contact'])

`is_active()` 사용하기

active()와 비슷하게 경로와 라우트를 전달하지만, 현재 페이지의 일치 여부를 문자열 대신 불리언으로 반환합니다.

@if (is_active('posts/*'))
    You're looking at a blog post!
@endif

추가 헬퍼

요청을 컨트롤러에서 처리하는 경우, 현재 컨트롤러와 액션 이름을 가져오는 두 가지 함수를 사용할 수 있습니다. 요청 메서드를 제외한 컨트롤러와 액션 이름을 소문자로 반환합니다. 다음은 FooController@getBar로 라우팅되는 요청의 예입니다.

$controller = controller_name(); // foo

$action = action_name(); // bar

라이선스

Laravel용 Active는 MIT 라이선스로 배포되는 무료 오픈소스 패키지입니다. 원하는 방식으로 사용할 수 있습니다.

이 패키지는 Treeware입니다. 운영 환경에서 사용한다면 개발에 대한 감사의 표시로 지구에 나무 한 그루를 선물해 주세요. Treeware 숲에 기여하면 현지 가족의 일자리를 만들고 야생동물 서식지를 복원하는 데 도움이 됩니다.