套件是將功能添加到 Laravel 的主要方式。套件可以是任何東西，從像 Carbon 這樣的處理日期的絕佳方式，或者像 Spatie 的 Laravel Media Library 這樣的套件，讓您將檔案與 Eloquent 模型關聯。
有不同類型的套件。有些套件是獨立的，這意味著它們可以與任何 PHP 框架一起使用。Carbon 和 Pest 是獨立套件的例子。這些套件中的任何一個都可以通過在您的 composer.json 檔案中要求它們來與 Laravel 一起使用。
另一方面，其他套件專門用於與 Laravel 一起使用。這些套件可能具有路由、控制器、視圖和組態，專門用於增強 Laravel 應用程式。本指南主要涵蓋了那些專為 Laravel 特定而開發的套件。
在撰寫 Laravel 應用程式時，通常不管您使用合約還是 Facades，因為兩者提供基本相同的可測試性水平。但是，在撰寫套件時，您的套件通常不會具有訪問 Laravel 的所有測試輔助工具。如果您希望能夠撰寫套件測試，就好像該套件安裝在典型的 Laravel 應用程式中一樣，您可以使用 Orchestral Testbench 套件。
一個 Laravel 應用程式的 bootstrap/providers.php 檔案包含了應該由 Laravel 載入的服務提供者清單。然而，您可以將提供者定義在您套件的 composer.json 檔案的 extra 部分中，而不是要求使用者手動將您的服務提供者添加到清單中，這樣 Laravel 就會自動載入它。除了服務提供者，您也可以列出您想要註冊的任何 facades：
"extra": {
"laravel": {
"providers": [
"Barryvdh\\Debugbar\\ServiceProvider"
],
"aliases": {
"Debugbar": "Barryvdh\\Debugbar\\Facade"
}
}
},一旦您的套件已配置為可被發現，當安裝時 Laravel 將自動註冊其服務提供者和 facades，為您套件的使用者提供方便的安裝體驗。
如果您是一個套件的使用者並且想要為一個套件停用套件發現，您可以在您應用程式的 composer.json 檔案的 extra 部分中列出套件名稱：
"extra": {
"laravel": {
"dont-discover": [
"barryvdh/laravel-debugbar"
]
}
},您可以使用 * 字元在您應用程式的 dont-discover 指示詞中停用所有套件的套件發現：
"extra": {
"laravel": {
"dont-discover": [
"*"
]
}
},服務提供者 是您的套件與 Laravel 之間的連接點。一個服務提供者負責將東西綁定到 Laravel 的 服務容器 中，並告知 Laravel 要在哪裡載入套件資源，例如視圖、組態和語言檔案。
一個服務提供者擴展了 Illuminate\Support\ServiceProvider 類別並包含兩個方法：register 和 boot。基礎的 ServiceProvider 類別位於 illuminate/support Composer 套件中，您應該將其添加到您自己套件的相依性中。要了解更多關於服務提供者的結構和目的，請查看它們的文件。
通常，您需要將您的套件組態檔發佈到應用程式的 config 目錄中。這將允許您的套件使用者輕鬆覆蓋您的預設組態選項。為了讓您的組態檔可以被發佈，請在您的服務提供者的 boot 方法中調用 publishes 方法：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->publishes([
__DIR__.'/../config/courier.php' => config_path('courier.php'),
]);
}現在，當您的套件使用者執行 Laravel 的 vendor:publish 指令時，您的檔案將被複製到指定的發佈位置。一旦您的組態已被發佈，其值可以像任何其他組態檔一樣被存取：
$value = config('courier.option');Warning
您不應在您的組態檔中定義閉包。當使用者執行 config:cache Artisan 指令時，閉包無法正確序列化。
您也可以將您自己的套件組態檔與應用程式發佈的副本合併。這將允許您的使用者僅在組態檔的發佈副本中定義他們實際想要覆蓋的選項。要合併組態檔值，請在您的服務提供者的 register 方法中使用 mergeConfigFrom 方法。
mergeConfigFrom 方法接受您的套件組態檔的路徑作為第一個引數，應用程式組態檔的名稱作為第二個引數：
/**
* Register any application services.
*/
public function register(): void
{
$this->mergeConfigFrom(
__DIR__.'/../config/courier.php', 'courier'
);
}Warning
此方法僅合併組態陣列的第一層。如果您的使用者部分定義多維組態陣列，缺少的選項將不會被合併。
如果您的套件包含路由，您可以使用 loadRoutesFrom 方法加載它們。此方法將自動確定應用程式的路由是否已被快取，如果路由已經被快取，則不會加載您的路由檔案：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->loadRoutesFrom(__DIR__.'/../routes/web.php');
}如果您的套件包含資料庫遷移，您可以使用publishesMigrations方法通知 Laravel 指定的目錄或檔案包含遷移。當 Laravel 發佈遷移時，它將自動更新其檔名中的時間戳記以反映當前日期和時間：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->publishesMigrations([
__DIR__.'/../database/migrations' => database_path('migrations'),
]);
}如果您的套件包含語言檔，您可以使用loadTranslationsFrom方法告知 Laravel 如何加載它們。例如，如果您的套件名稱為courier，您應該將以下內容添加到服務提供者的boot方法中：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->loadTranslationsFrom(__DIR__.'/../lang', 'courier');
}套件翻譯行使用package::file.line語法慣例進行引用。因此，您可以像這樣從messages檔案中加載courier套件的welcome行：
echo trans('courier::messages.welcome');您可以使用loadJsonTranslationsFrom方法為您的套件註冊 JSON 翻譯檔。此方法接受包含您的套件 JSON 翻譯檔的目錄路徑：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->loadJsonTranslationsFrom(__DIR__.'/../lang');
}如果您想要將您的套件語言檔發佈到應用程式的lang/vendor目錄中，您可以使用服務提供者的publishes方法。publishes方法接受一個包含套件路徑及其所需發佈位置的陣列。例如，要發佈courier套件的語言檔，您可以執行以下操作：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->loadTranslationsFrom(__DIR__.'/../lang', 'courier');
$this->publishes([
__DIR__.'/../lang' => $this->app->langPath('vendor/courier'),
]);
}現在，當您的套件使用 Laravel 的vendor:publish Artisan 命令時，您的套件語言檔將被發佈到指定的發佈位置。
要將您的套件的視圖註冊到 Laravel，您需要告訴 Laravel 視圖的位置。您可以使用服務提供者的loadViewsFrom方法來執行此操作。loadViewsFrom方法接受兩個參數：您的視圖模板的路徑和您的套件名稱。例如，如果您的套件名稱為courier，您應該將以下內容添加到服務提供者的boot方法中：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->loadViewsFrom(__DIR__.'/../resources/views', 'courier');
}套件視圖是使用 package::view 語法慣例來引用的。因此，一旦您的視圖路徑在服務提供者中註冊，您可以像這樣從 courier 套件加載 dashboard 視圖：
Route::get('/dashboard', function () {
return view('courier::dashboard');
});當您使用 loadViewsFrom 方法時，Laravel 實際上為您的視圖註冊了兩個位置：應用程式的 resources/views/vendor 目錄和您指定的目錄。因此，以 courier 套件為例，Laravel 首先會檢查開發人員是否在 resources/views/vendor/courier 目錄中放置了視圖的自定義版本。然後，如果視圖未被自定義，Laravel 將搜索您在 loadViewsFrom 中指定的套件視圖目錄。這使得套件使用者可以輕鬆自定義 / 覆蓋您套件的視圖。
如果您希望將您的視圖可用於發佈到應用程式的 resources/views/vendor 目錄，您可以使用服務提供者的 publishes 方法。publishes 方法接受一個套件視圖路徑及其所需的發佈位置的陣列：
/**
* Bootstrap the package services.
*/
public function boot(): void
{
$this->loadViewsFrom(__DIR__.'/../resources/views', 'courier');
$this->publishes([
__DIR__.'/../resources/views' => resource_path('views/vendor/courier'),
]);
}現在，當您的套件使用者執行 Laravel 的 vendor:publish Artisan 命令時，您的套件視圖將被複製到指定的發佈位置。
如果您正在建立一個使用 Blade 元件或將元件放置在非傳統目錄中的套件，您需要手動註冊您的元件類別及其 HTML 標籤別名，以便 Laravel 知道在哪裡找到該元件。通常應在套件服務提供者的 boot 方法中註冊您的元件：
use Illuminate\Support\Facades\Blade;
use VendorPackage\View\Components\AlertComponent;
/**
* Bootstrap your package's services.
*/
public function boot(): void
{
Blade::component('package-alert', AlertComponent::class);
}一旦您的元件被註冊，它可以使用其標籤別名來呈現：
<x-package-alert/>或者，您可以使用 componentNamespace 方法按照慣例自動載入元件類別。例如，一個 Nightshade 套件可能包含在 Nightshade\Views\Components 命名空間中的 Calendar 和 ColorPicker 元件：
use Illuminate\Support\Facades\Blade;
/**
* Bootstrap your package's services.
*/
public function boot(): void
{
Blade::componentNamespace('Nightshade\\Views\\Components', 'nightshade');
}這將允許使用 package-name:: 語法通過其供應商命名空間使用套件元件：
<x-nightshade::calendar />
<x-nightshade::color-picker />Blade 將自動檢測與此元件相關聯的類別，方法是將元件名稱轉換為帕斯卡大小寫。子目錄也支持使用「點」表示法。
如果您的套件包含匿名元件，則必須將它們放在套件的「views」目錄下的 components 目錄中（如 loadViewsFrom 方法 中所指定）。然後，您可以通過在元件名稱前加上套件的視圖命名空間來呈現它們：
<x-courier::alert />Laravel 內建的 about Artisan 指令提供應用程式環境和配置的摘要。套件可以透過 AboutCommand 類別將額外的資訊推送到此指令的輸出中。通常，此資訊可以從您的套件服務提供者的 boot 方法中添加：
use Illuminate\Foundation\Console\AboutCommand;
/**
* Bootstrap any application services.
*/
public function boot(): void
{
AboutCommand::add('My Package', fn () => ['Version' => '1.0.0']);
}要將您的套件的 Artisan 指令註冊到 Laravel 中，您可以使用 commands 方法。此方法期望一個指令類別名稱的陣列。一旦指令被註冊，您可以使用 Artisan CLI 執行它們：
use Courier\Console\Commands\InstallCommand;
use Courier\Console\Commands\NetworkCommand;
/**
* Bootstrap any package services.
*/
public function boot(): void
{
if ($this->app->runningInConsole()) {
$this->commands([
InstallCommand::class,
NetworkCommand::class,
]);
}
}Laravel 的 optimize 指令 會快取應用程式的配置、事件、路由和視圖。使用 optimizes 方法，您可以註冊您的套件自己的 Artisan 指令，這些指令應在執行 optimize 和 optimize:clear 指令時被調用：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
if ($this->app->runningInConsole()) {
$this->optimizes(
optimize: 'package:optimize',
clear: 'package:clear-optimizations',
);
}
}您的套件可能包含 JavaScript、CSS 和圖像等資源。要將這些資源發佈到應用程式的 public 目錄中，請使用服務提供者的 publishes 方法。在這個範例中，我們還將新增一個 public 資源群組標籤，這可用於輕鬆發佈相關資源群組：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->publishes([
__DIR__.'/../public' => public_path('vendor/courier'),
], 'public');
}現在，當您的套件使用者執行 vendor:publish 指令時，您的資源將被複製到指定的發佈位置。由於使用者通常需要在每次套件更新時覆蓋資源，您可以使用 --force 標誌：
php artisan vendor:publish --tag=public --force您可能希望將套件資源和資源分開發佈。例如，您可能希望允許使用者發佈套件的組態檔，而無需強制發佈套件的資源。您可以在從套件服務提供者的 publishes 方法中呼叫時進行「標記」。例如，讓我們使用標籤來定義 courier 套件的兩個發佈群組 (courier-config 和 courier-migrations)：
/**
* Bootstrap any package services.
*/
public function boot(): void
{
$this->publishes([
__DIR__.'/../config/package.php' => config_path('package.php')
], 'courier-config');
$this->publishesMigrations([
__DIR__.'/../database/migrations/' => database_path('migrations')
], 'courier-migrations');
}現在，您的使用者可以透過參考其標籤來單獨發佈這些群組，當執行 vendor:publish 指令時：
php artisan vendor:publish --tag=courier-config