Konfigurasi

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){
     $this->loadTranslationsFrom(__DIR__.'/path/to/translations', 'courier');
 }

echo trans('courier::messages.welcome');

🎜{note} Anda tidak seharusnya menentukan fungsi penutupan dalam fail konfigurasi. Kerana apabila pengguna melaksanakan perintah config:cache Artisan, fail konfigurasi tidak akan bersiri dengan betul. 🎜🎜🎜🎜

Konfigurasi lalai pakej sambungan

Anda juga boleh menggabungkan konfigurasi lalai pakej pengembangan dengan konfigurasi salinan aplikasi. Ini membolehkan pengguna pek sambungan mentakrifkan pilihan konfigurasi yang ingin mereka ganti dalam fail konfigurasi replika. Untuk menggabungkan konfigurasi, hanya panggil kaedah mergeConfigFrom dalam kaedah register pembekal perkhidmatan: register 方法中调用 mergeConfigFrom 方法即可：

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){
     $this->loadTranslationsFrom(__DIR__.'/path/to/translations', 'courier');    
     $this->publishes([    
         __DIR__.'/path/to/translations' => resource_path('lang/vendor/courier'),   
       ]);
  }

{note} 此方法只合并配置数组的第一维。如果扩展包用户定义了多维配置数组，缺少的选项将不会被合并。

路由

如果你的扩展包中包含路由文件，你需要使用 loadRoutesFrom 方法加载他们。此方法将自动判断应用的路由是否已被缓存，如果路由已缓存，将不会加载你的路由文件：

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){
     $this->loadViewsFrom(__DIR__.'/path/to/views', 'courier');
   }

数据库迁移

如果你的扩展包中包含 数据库迁移，你需要使用 loadMigrationsFrom 方法告知 Laravel 如何加载他们。loadMigrationsFrom 方法只需要扩展包迁移文件路径作为唯一参数：

Route::get('admin', function () { 
   return view('courier::admin');
});

一旦你的扩展包迁移文件被注册，当运行 php artisan migrate 命令时他们就会被自动执行。你不需要将他们导入到应用的 database/migrations 目录中。

语言包

如果你的扩展包中包含 语言包文件，你需要使用 loadTranslationsFrom 方法告知 Laravel 如何加载他们。例如，如果你的扩展包名为 courier，你需要将下面的内容加入到服务提供者的 boot 方法中：

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){ 
    $this->loadViewsFrom(__DIR__.'/path/to/views', 'courier');    
    $this->publishes([     
       __DIR__.'/path/to/views' => resource_path('views/vendor/courier'), 
      ]);
  }

扩展包翻译约定使用 package::file.line 语法进行引用。因此，你可以按照下面的方式来加载 courier 扩展包中的 messages 文件的 welcome 行：

/**
 * 引导应用服务。
 *
 * @return void
 */
 public function boot(){  
   if ($this->app->runningInConsole()) {      
     $this->commands([         
        FooCommand::class,            
        BarCommand::class,       
      ]);  
    }
  }

发布语言包

如果你想要将扩展包中的语言包发布到应用的 resources/lang/vendor 目录，可以使用服务提供者的 publishes 方法。publishes 方法接收一个包含语言包路径和对应发布位置的数组。例如，发布 courier 扩展包的语言包文件，操作如下：

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){ 
    $this->publishes([     
       __DIR__.'/path/to/assets' => public_path('vendor/courier'),  
     ], 'public');
 }

现在，当扩展包的用户执行 Laravel 的 vendor:publish

php artisan vendor:publish --tag=public --force

{note} Kaedah ini hanya menggabungkan tatasusunan konfigurasi dimensi pertama. Jika pengguna sambungan mentakrifkan tatasusunan konfigurasi berbilang dimensi, pilihan yang hilang tidak akan digabungkan.

Laluan

Jika pakej sambungan anda mengandungi fail penghalaan , anda perlu menggunakan kaedah loadRoutesFrom untuk memuatkannya. Kaedah ini secara automatik akan menentukan sama ada laluan yang digunakan telah dicache Jika laluan telah dicache, fail laluan anda tidak akan dimuatkan: 🎜

/**
 * 在注册后启动服务。
 *
 * @return void
 */
 public function boot(){
     $this->publishes([    
         __DIR__.'/../config/package.php' => config_path('package.php')  
       ], 'config'); 
      $this->publishes([    
          __DIR__.'/../database/migrations/' => database_path('migrations')  
        ], 'migrations');
       }

🎜🎜🎜

🎜

Migrasi Pangkalan Data

🎜Jika pakej sambungan anda mengandungi migrasi pangkalan data, anda perlu menggunakan kaedah loadMigrationFrom untuk memberitahu Laravel cara memuatkannya. Kaedah loadMigrationsFrom hanya memerlukan laluan ke fail migrasi pek pengembangan sebagai satu-satunya hujah: 🎜

php artisan vendor:publish --tag=config

🎜Setelah fail migrasi pek pengembangan anda didaftarkan, ia akan dijana apabila php artisan migrate< /code> arahan dijalankan dilaksanakan secara automatik. Anda tidak perlu mengimportnya ke dalam direktori database/migration aplikasi anda. 🎜🎜🎜🎜

🎜

Pek bahasa

🎜Jika pek pengembangan anda mengandungi fail pek bahasa, anda perlu untuk menggunakan kaedah loadTranslationsFrom untuk memberitahu Laravel cara memuatkannya. Contohnya, jika pakej sambungan anda dinamakan courier, anda perlu menambah kandungan berikut pada kaedah boot pembekal perkhidmatan: 🎜rrreee🎜Konvensyen terjemahan pakej sambungan menggunakan < code >pakej::file.line sintaks untuk rujukan. Oleh itu, anda boleh memuatkan baris selamat datang fail message dalam pakej sambungan courier seperti berikut: 🎜rrreee

🎜🎜Terbitkan pek bahasa🎜🎜Jika anda ingin menerbitkan pek bahasa dalam pakej sambungan ke direktori sumber/lang/vendor aplikasi, anda boleh menggunakan pembekal perkhidmatan Kaedah menerbitkan. Kaedah menerbitkan menerima tatasusunan yang mengandungi laluan ke pek bahasa dan lokasi penerbitan yang sepadan. Sebagai contoh, untuk menerbitkan fail pek bahasa bagi pakej sambungan courier, operasinya adalah seperti berikut: 🎜rrreee🎜Sekarang, apabila pengguna pakej sambungan melaksanakan vendor:publish Perintah Artisan, pakej bahasa akan diterbitkan ke direktori yang ditentukan. 🎜🎜🎜🎜🎜🎜🎜

Lihat

Jika anda ingin mendaftarkan paparan pakej sambungan anda dalam Laravel, anda perlu memberitahu Laravel lokasi fail paparan. Anda boleh melakukan ini menggunakan kaedah loadViewsFrom pembekal perkhidmatan. Kaedah loadViewsFrom membenarkan untuk menerima dua parameter: lihat laluan templat dan nama pakej sambungan. Contohnya, jika pakej sambungan anda dinamakan courier, anda perlu menambah kandungan berikut pada kaedah boot pembekal perkhidmatan: loadViewsFrom 方法来实现。loadViewsFrom 方法允许接收两个参数：视图模板路径和扩展包名。例如，如果你的扩展包名为 courier，你需要将下面的内容加入到服务提供者的 boot 方法中：

rrreee

扩展包视图约定使用 package::view 语法进行引用。因此，一旦视图路径在服务提供者中注册成功，你可以使用下面的方式来加载 courier 扩展包中的 admin 视图：

rrreee

重写扩展包视图

当你使用 loadViewsFrom 方法时，Laravel 实际上在两个位置注册视图：应用的 resources/views/vendor 目录和你的自定义目录。所以，还以 courier 扩展包为例，Laravel 首先会检查开发人员是否在 resources/views/vendor/courier 中提供了一个自定义版本的视图。然后，如果视图尚未被定义，Laravel 将会搜索在 loadViewsFrom 中定义的视图目录。这种方法可以让用户很简单的自定义或重写扩展包的视图。

发布视图

如果你希望将你的视图发布到应用的 resources/views/vendor 目录中，可以使用服务提供者的 publishes 方法。publishes 方法接收一个包含视图路径和对应发布位置的数组：

rrreee

现在，当扩展包的用户执行 Laravel 的 vendor:publish Artisan 命令，视图将会被发布到自定的目录中。

命令

想要在 Laravel 中注册扩展包的 Artisan 命令，需要使用 commands 方法。此方法接收一个命令类的数组。一旦这些命令注册成功，可以使用 Artisan 命令行 执行他们：

rrreee

公共资源文件

你的扩展包中可能存在 JavaScript、CSS 和图片之类的资源文件。想要发布这些资源文件到应用的 public 目录，可以使用服务提供者的 publishes 方法。在下面的例子中，我们也可以添加一个 public 资源分类标签，可用于相关发布资源的分类：

rrreee

现在，当扩展包的用户执行 vendor:publish 命令，你的资源文件将会被复制到指定的目录中。由于每次更新扩展包时通常都需要覆盖资源文件，因此需要使用 --forcerrreee

Konvensyen paparan pakej sambungan menggunakan < code >pakej::lihat sintaks untuk rujukan. Oleh itu, setelah laluan paparan berjaya didaftarkan dengan pembekal perkhidmatan, anda boleh menggunakan kaedah berikut untuk memuatkan paparan admin dalam pakej sambungan courier:

rrreee

Menulis semula paparan pakej sambungan

Apabila anda menggunakan kaedah loadViewsFrom, Laravel sebenarnya mendaftarkan paparan di dua tempat: aplikasi < direktori kod>sumber/pandangan/vendor dan direktori tersuai anda. Jadi, dengan mengambil pakej sambungan courier sebagai contoh, Laravel akan menyemak dahulu sama ada pembangun telah menyediakan versi paparan tersuai dalam resources/views/vendor/courier. Kemudian, jika paparan belum ditakrifkan lagi, Laravel akan mencari direktori paparan yang ditakrifkan dalam loadViewsFrom. Pendekatan ini membolehkan pengguna menyesuaikan atau mengatasi paparan pakej sambungan dengan mudah.

Terbitkan Paparan

Jika anda ingin menerbitkan paparan anda ke sumber/pandangan/vendor apl anda Dalam direktori, anda boleh menggunakan kaedah publishes pembekal perkhidmatan. Kaedah menerbitkan menerima tatasusunan yang mengandungi laluan paparan dan lokasi penerbitan yang sepadan: 🎜rrreee🎜Sekarang, apabila pengguna pakej sambungan melaksanakan perintah Artisan vendor:publish Laravel, paparan akan Diterbitkan ke direktori tersuai. 🎜🎜🎜🎜

🎜

Arahan

🎜Jika anda ingin mendaftar perintah Artisan bagi pakej sambungan dalam Laravel, anda perlu Gunakan kaedah commands. Kaedah ini menerima pelbagai kelas arahan. Setelah arahan ini berjaya didaftarkan, ia boleh dilaksanakan menggunakan baris arahan Artisan: 🎜rrreee🎜🎜🎜

🎜

Fail aset awam

🎜Mungkin terdapat fail sumber seperti JavaScript, CSS dan imej dalam pakej sambungan anda. Untuk menerbitkan fail sumber ini ke direktori public aplikasi, anda boleh menggunakan kaedah publishes pembekal perkhidmatan. Dalam contoh di bawah, kami juga boleh menambah teg klasifikasi sumber public, yang boleh digunakan untuk mengklasifikasikan sumber yang diterbitkan berkaitan: 🎜rrreee🎜Sekarang, apabila pengguna pakej sambungan melaksanakan vendor: publish perintah, fail sumber anda akan disalin ke direktori yang ditentukan. Memandangkan fail sumber biasanya perlu ditimpa setiap kali pek pengembangan dikemas kini, tag --force perlu digunakan: 🎜rrreee🎜🎜🎜🎜🎜🎜

Terbitkan fail kumpulan

Anda mungkin mahu membungkus dan menerbitkan fail sumber atau sumber pek pengembangan secara berasingan. Sebagai contoh, anda mungkin mahu pengguna menerbitkan fail konfigurasi dalam pakej sambungan secara individu, dan bukannya dipaksa untuk menerbitkan semua fail sumber dalam pakej sambungan. Anda boleh "meneg" fail yang berbeza dengan memanggil kaedah menerbitkan dalam pembekal perkhidmatan pakej sambungan. Sebagai contoh, mari gunakan kaedah boot dalam pembekal perkhidmatan pakej sambungan untuk mentakrifkan dua kumpulan penerbitan: publishes 方法给不同文件打上「标签」。例如，让我们使用扩展包服务提供者中的 boot 方法来定义两个发布群组：

rrreee

现在你的用户就可以通过执行 vendor:publishrrreee

Kini pengguna anda boleh melaksanakan Perintah vendor:publish untuk menerbitkan kumpulan berbeza fail berdasarkan tag yang ditentukan:

rrreeeArtikel ini pertama kali diterbitkan di tapak web LearnKu.com

.

🎜

← Pemberitahuan mesej

beratur →

serahkan

Laman web PHP Cina

RumahKursusArtikelSoal JawabKamusManualMuat turuncari APPMuat turun