패키지 뷰의 덮어쓰기와 업데이트

​

등록과 배포는 별개의 처리

<?php

namespace Acme\Courier;

use Illuminate\Support\ServiceProvider;

class CourierServiceProvider extends ServiceProvider
{
    public function boot(): void
    {
        $this->loadViewsFrom(__DIR__.'/../resources/views', 'courier');

        $this->publishes([
            __DIR__.'/../resources/views' => resource_path('views/vendor/courier'),
        ], 'courier-views');
    }
}

return view('courier::deliveries.show', [
    'trackingCode' => 'TRACK-001',
]);

<p>추적 번호: {{ $trackingCode }}</p>

​

파일 단위로 덮어쓰기 대상을 찾는다

​

필요한 뷰만 커스터마이즈하기

php artisan vendor:publish --provider="Acme\Courier\CourierServiceProvider" --tag=courier-views

​

재배포는 차이를 병합하지 않는다

​

뷰도 공개 API로서 유지보수하기

• 네임스페이스와 deliveries.show 같은 뷰 이름을 부주의하게 변경하지 않는다.
• 전달하는 변수, 타입, 필수 여부를 기록한다.
• @include나 @extends의 참조 대상, Blade 컴포넌트의 props도 변경 사항에 포함한다.
• 수정한 뷰와, 배포된 구버전에 적용해야 할 변경을 릴리스 노트에 기재한다.

​

Blade 캐시는 덮어쓰기 파일을 업데이트하지 않는다

php artisan view:cache

php artisan view:clear

​

검색 결과 캐시와 구분하기

​

릴리스 전에 확인할 사항

• 배포하지 않은 상태에서 패키지의 뷰가 렌더링된다.
• 하나만 덮어쓰면 그 파일만 우선되고, 나머지는 패키지로 폴백된다.
• 구버전의 배포된 템플릿을 남긴 상태에서도 신버전이 전달하는 데이터로 렌더링할 수 있다.
• 일반 재배포에서 커스터마이즈가 유지되고, 배포되지 않은 파일의 추가도 의도한 대로 이루어진다.
• 덮어쓰기 파일 변경 후 view:cache가 성공하고, 새로 기동하면 변경 후의 표시가 된다.

​

관련 페이지

​

참조한 1차 자료

• Laravel 공식 문서: 패키지의 뷰
• ServiceProvider: 뷰 경로 등록
• FileViewFinder: 검색 순서와 검색 결과 보관
• VendorPublishCommand: 파일 배포 조건
• ViewCacheCommand: 뷰 경로 수집과 컴파일
• ViewClearCommand: 컴파일된 파일 삭제
• Compiler: 수정 시각 확인