19. 第三方類庫 · HkCms tp6版使用手冊《免授權，永久商用》-02251406

# 19. 第三方類庫 ## 引用第三方類庫將你的第三方類庫直接放到插件根目錄或者新建文件夾放好。例如`demo`插件下新建`libaray`文件夾，之后把類庫放入`library`文件夾。 ## 修改類庫的命名空間通過上面，類庫放進來并不能調用到，我們需要增加或修改命名空間。如下圖，放入了兩個類庫文件，我們只需把命名空間改成：namespace addons\\插件名稱\\library;，library里面還有文件夾就繼續按目錄層次寫下去即可。 ![](https://img.kancloud.cn/9c/44/9c446dcbd8260b8801c637c8a2da6993_367x241.png) 根據插件命名空間調整，如下所示 ``` <pre class="calibre16">``` <?php // addons\插件名稱\目錄 namespace addons\demo\library; class World { public function show() { echo 1; } } ``` ``` ``` <pre class="calibre16">``` <?php namespace addons\demo\library\oat; class Lumoto { } ``` ``` 改好后調用 ``` <pre class="calibre16">``` $w = new \addons\demo\library\World(); $w->show(); ``` ``` ## 通過初始化事件自動注冊如果類庫文件過多或者是一個composer包，修改起來麻煩，可參考如下代碼，在插件名稱、插件初始化時執行 > 2.2.1.20220603版本起支持如下：在`addonsInitHook`事件中調用了`addNamespace`自動注冊第三方類庫方法 ``` <pre class="calibre16">``` <?php declare (strict_types=1); namespace addons\demo; use think\Addons; class Demo extends Addons { public function install() { return true; } public function uninstall() { return true; } public function addonsInitHook() { $this->addNamespace('命名空間'); } } ``` ``` 例如：以PhpWord類庫為例，我們下載后的壓縮包目錄結構如下： ![](https://img.kancloud.cn/cb/6d/cb6d3551b578e8eb314ef433a1825496_303x296.png) 去到src目錄，有如下文件夾 ![](https://img.kancloud.cn/cf/54/cf540228bf2bf50f431f4a66663a1712_199x57.png) 把PhpWord文件夾放入到addons\\demo\\library\\PhpOffice目錄下，之所以還要創建PhpOffice目錄因為他的命名空間是 ``` <pre class="calibre16">``` PhpOffice\PhpWord ``` ``` 所以我們需要在創建`PhpOffice`文件夾，完成這一步后在`addonsInitHook`事件中添加命名空間 ``` <pre class="calibre16">``` $this->addNamespace('PhpOffice\PhpWord'); ``` ``` 在插件里面或者其他地方使用類似于PhpOffice\\PhpWord空間的類庫時都會在這加載。 ## composer 方式安裝第三方類庫 > 2.2.1.20220603版本起支持使用composer方式之前你需要先了解什么是composer，鏈接地址：https://pkg.xyz/#how-to-install-composer 1. 分別建立vendor文件夾與composer.json文件 ![](https://img.kancloud.cn/e5/73/e5732dac0eb47d6a22062b80c8fd6a42_556x255.png) 2. composer.json內容 ``` <pre class="calibre16">``` { "name": "hkcms/demo", "description": "demo plugin", "type": "hkcms-addon", "license": "apache2.0", "authors": [ { "name": "demo", "email": "demo@hkcms.cn" } ], "config": { }, "require": { } } ``` ``` `name`composer包的名字，格式為“vendor名稱/包名” `description`描述信息，簡單描述下你的插件 `type`固定為**hkcms-addon** `license`固定`apache2.0` `authors`作者，按上面的格式改掉即可 `` 3\. 跟composer一樣在當前插件目錄安裝、更新、刪除第三方庫包。例如安裝第三方微信SDK ``` <pre class="calibre16">``` composer require overtrue/wechat:~4.0 -vvv ``` ``` 安裝成功后即可使用。 > 注意，插件必須是安裝后才能生效