🎜

Configuration

🎜Parfois, vous devez ajouter des extensions Configuration du package les fichiers sont publiés dans le répertoire config de l'application elle-même. De cette manière, les utilisateurs utilisant le package d'extension peuvent facilement remplacer les éléments de configuration par défaut. Pour publier le fichier de configuration du package d'extension, il vous suffit d'appeler la méthode publishes dans la méthode boot du fournisseur de services : 🎜

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

🎜Maintenant, lorsque l'utilisateur du package d'extension exécute Laravel vendor:publish, le fichier du package d'extension sera copié dans le répertoire spécifié. Bien entendu, une fois votre fichier de configuration publié, il est accessible comme n'importe quelle autre configuration : 🎜

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

🎜{note} Vous ne devez pas définir de fonctions de fermeture dans les fichiers de configuration. Car lorsque l'utilisateur exécute la commande config:cache Artisan, le fichier de configuration ne sera pas sérialisé correctement. 🎜🎜🎜🎜

Configuration par défaut du package d'extension

Vous pouvez également fusionner la configuration par défaut du package d'extension avec la configuration de copie de l'application. Cela permet aux utilisateurs du pack d'extension de définir les options de configuration qu'ils souhaitent remplacer dans le fichier de configuration de la réplique. Pour fusionner des configurations, appelez simplement la méthode mergeConfigFrom dans la méthode register du fournisseur de services : 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} Cette méthode fusionne uniquement les tableaux de configuration de la première dimension. Si l'utilisateur de l'extension définit un tableau de configuration multidimensionnel, les options manquantes ne seront pas fusionnées.

Routes

Si votre package d'extension contient des fichiers de routage, vous vous devez utiliser la méthode loadRoutesFrom pour les charger. Cette méthode déterminera automatiquement si la route appliquée a été mise en cache. Si la route a été mise en cache, votre fichier de route ne sera pas chargé : 🎜

/**
 * 在注册后启动服务。
 *
 * @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');
       }

🎜🎜🎜

🎜

Migrations de bases de données

🎜Si votre package d'extension contient des migrations de bases de données, vous devez utiliser la méthode loadMigrationsFrom pour indiquer à Laravel comment les charger. La méthode loadMigrationsFrom nécessite uniquement le chemin d'accès au fichier de migration du pack d'extension comme seul argument : 🎜

php artisan vendor:publish --tag=config

🎜Une fois les fichiers de migration de votre pack d'extension enregistrés, ils seront générés lors de la migration php artisan< La commande /code> est exécutée et exécutée automatiquement. Vous n'avez pas besoin de les importer dans le répertoire database/migrations de votre application. 🎜🎜🎜🎜

🎜

Pack de langue

🎜Si votre pack d'extension contient des fichiers de pack de langue, vous avez besoin pour utiliser la méthode loadTranslationsFrom pour indiquer à Laravel comment les charger. Par exemple, si votre package d'extension est nommé courier, vous devez ajouter le contenu suivant à la méthode boot du fournisseur de services : 🎜rrreee🎜La convention de traduction du package d'extension utilise < code Syntaxe >package::file.line pour référence. Par conséquent, vous pouvez charger la ligne welcome du fichier messages dans le package d'extension courier comme suit : 🎜rrreee

🎜🎜Publier le module linguistique🎜🎜Si vous souhaitez publier le module linguistique dans le package d'extension dans le répertoire resources/lang/vendor de l'application, vous pouvez utiliser un fournisseur de services La méthode publie. La méthode publies reçoit un tableau contenant le chemin d'accès au module linguistique et l'emplacement de publication correspondant. Par exemple, pour publier le fichier du pack de langue du package d'extension courier, l'opération est la suivante : 🎜rrreee🎜Maintenant, lorsque l'utilisateur du package d'extension exécute le vendor:publish Commande Artisan, le package de langue sera publié dans le répertoire spécifié. 🎜🎜🎜🎜🎜🎜🎜

View

Si vous souhaitez enregistrer la vue de votre package d'extension dans Laravel, vous devez indiquer à Laravel l'emplacement du fichier de vue. Vous pouvez le faire en utilisant la méthode loadViewsFrom du fournisseur de services. La méthode loadViewsFrom permet de recevoir deux paramètres : le chemin du modèle de vue et le nom du package d'extension. Par exemple, si votre package d'extension est nommé courier, vous devez ajouter le contenu suivant à la méthode boot du fournisseur de services : 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

La convention d'affichage du package d'extension utilise < code Syntaxe >package::view pour référence. Par conséquent, une fois le chemin d'accès à la vue enregistré avec succès auprès du fournisseur de services, vous pouvez utiliser la méthode suivante pour charger la vue admin dans le package d'extension courier :

rrreee

Réécriture des vues du package d'extension

Lorsque vous utilisez la méthode loadViewsFrom, Laravel enregistre en fait les vues à deux endroits : le < de l'application code>resources/views/vendor et votre répertoire personnalisé. Ainsi, en prenant le package d'extension courier comme exemple, Laravel vérifiera d'abord si le développeur a fourni une version personnalisée de la vue dans resources/views/vendor/courier. Ensuite, si la vue n'a pas encore été définie, Laravel recherchera le répertoire de vues défini dans loadViewsFrom. Cette approche permet aux utilisateurs de personnaliser ou de remplacer facilement les vues du package d'extension.

Publier les vues

Si vous souhaitez publier vos vues dans les ressources/vues/fournisseur de votre application le répertoire, vous pouvez utiliser la méthode publies du fournisseur de services. La méthode publishes reçoit un tableau contenant le chemin de la vue et l'emplacement de publication correspondant : 🎜rrreee🎜Maintenant, lorsque l'utilisateur du package d'extension exécute la commande Artisan vendor:publish de Laravel, la vue sera publiée dans un répertoire personnalisé. 🎜🎜🎜🎜

🎜

Commandes

🎜Si vous souhaitez enregistrer la commande Artisan du package d'extension dans Laravel, vous devez utiliser la méthode commands. Cette méthode reçoit un tableau de classes de commandes. Une fois ces commandes enregistrées avec succès, elles peuvent être exécutées à l'aide de la ligne de commande Artisan : 🎜rrreee🎜🎜🎜

🎜

Fichiers de ressources publiques

🎜Il peut y avoir des fichiers de ressources tels que JavaScript, CSS et des images dans votre package d'extension. Pour publier ces fichiers de ressources dans le répertoire public de l'application, vous pouvez utiliser la méthode publishes du fournisseur de services. Dans l'exemple ci-dessous, nous pouvons également ajouter une balise de classification de ressources public, qui peut être utilisée pour classer les ressources publiées associées : 🎜rrreee🎜Maintenant, lorsque l'utilisateur du package d'extension exécute vendor : publiez, vos fichiers de ressources seront copiés dans le répertoire spécifié. Étant donné que les fichiers de ressources doivent généralement être écrasés à chaque fois qu'un pack d'extension est mis à jour, la balise --force doit être utilisée : 🎜rrreee🎜🎜🎜🎜🎜🎜

Publier des fichiers de groupe

Vous souhaiterez peut-être empaqueter et publier des fichiers de ressources ou des ressources de pack d'extension séparément. Par exemple, vous souhaiterez peut-être que les utilisateurs publient les fichiers de configuration dans un package d'extension individuellement, plutôt que d'être obligés de publier tous les fichiers de ressources dans un package d'extension. Vous pouvez « étiqueter » différents fichiers en appelant la méthode publies dans le fournisseur de services du package d'extension. Par exemple, utilisons la méthode boot dans le fournisseur de services du package d'extension pour définir deux groupes de publication : publishes 方法给不同文件打上「标签」。例如，让我们使用扩展包服务提供者中的 boot 方法来定义两个发布群组：

rrreee

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

Vos utilisateurs peuvent désormais exécuter la commande vendor:publish pour publier différents groupes. fichiers basés sur des balises définies :

rrreeeCet article a été publié pour la première fois sur le site LearnKu.com

.

🎜

← Notification des messages

file d'attente →

soumettre

Site Web PHP chinois

MaisonCoursArticleQuestions et réponsesDictionnaireManuelTéléchargerrecherche APPTélécharger