應用插件

每個應用插件是一個完整的應用,源碼放置於{主項目}/plugin目錄下

提示
使用命令php webman app-plugin:create {插件名} 可以在本地創建一個應用插件,
例如 php webman app-plugin:create cms 將創建如下目錄結構

plugin/
└── cms
    ├── app
    │   ├── controller
    │   │   └── IndexController.php
    │   ├── exception
    │   │   └── Handler.php
    │   ├── functions.php
    │   ├── middleware
    │   ├── model
    │   └── view
    │       └── index
    │           └── index.html
    ├── config
    │   ├── app.php
    │   ├── autoload.php
    │   ├── container.php
    │   ├── database.php
    │   ├── exception.php
    │   ├── log.php
    │   ├── middleware.php
    │   ├── process.php
    │   ├── redis.php
    │   ├── route.php
    │   ├── static.php
    │   ├── thinkorm.php
    │   ├── translation.php
    │   └── view.php
    └── public

我們看到一個應用插件有著與webman相同的目錄結構及配置文件。實際上開發一個應用插件與開發一個webman項目體驗基本一致,只需要注意以下幾個方面。

命名空間

插件目錄及命名遵循PSR4規範,因為插件都放置於plugin目錄下,所以命名空間都以plugin開頭,例如plugin\cms\app\controller\UserController,這裡cms是插件的源碼主目錄。

url訪問

應用插件url地址路徑都以/app開頭,例如plugin\cms\app\controller\UserControllerurl地址是 http://127.0.0.1:8787/app/cms/user

靜態文件

靜態文件放置於plugin/{插件}/public下,例如訪問http://127.0.0.1:8787/app/cms/avatar.png實際上是獲取plugin/cms/public/avatar.png文件。

配置文件

插件的配置與普通webman項目一樣,不過插件的配置一般只對當前插件有效,對主項目一般無影響。
例如plugin.cms.app.controller_suffix的值只影響插件的控制器後綴,對主項目沒有影響。
例如plugin.cms.app.controller_reuse的值只影響插件是否重用控制器,對主項目沒有影響。
例如plugin.cms.middleware的值只影響插件的中間件,對主項目沒有影響。
例如plugin.cms.view的值只影響插件所使用的視圖,對主項目沒有影響。
例如plugin.cms.container的值只影響插件所使用的容器,對主項目沒有影響。
例如plugin.cms.exception的值只影響插件的異常處理類,對主項目沒有影響。

但是因為路由是全局的,所以插件配置的路由也是影響全局的。

獲取配置

獲取某個插件配置方法為 config('plugin.{插件}.{具體的配置}');,例如獲取plugin/cms/config/app.php的所有配置方法為config('plugin.cms.app')
同樣的,主項目或者其它插件都可以用config('plugin.cms.xxx')來獲取cms插件的配置。

不支持的配置

應用插件不支持server.php,session.php配置,不支持app.request_classapp.public_pathapp.runtime_path配置。

資料庫

插件可以配置自己的資料庫,例如plugin/cms/config/database.php內容如下

return  [
    'default' => 'mysql',
    'connections' => [
        'mysql' => [ // mysql為連接名
            'driver'      => 'mysql',
            'host'        => '127.0.0.1',
            'port'        => 3306,
            'database'    => '資料庫',
            'username'    => '用戶名',
            'password'    => '密碼',
            'charset'     => 'utf8mb4',
            'collation'   => 'utf8mb4_general_ci',
        ],
        'admin' => [ // admin為連接名
            'driver'      => 'mysql',
            'host'        => '127.0.0.1',
            'port'        => 3306,
            'database'    => '資料庫',
            'username'    => '用戶名',
            'password'    => '密碼',
            'charset'     => 'utf8mb4',
            'collation'   => 'utf8mb4_general_ci',
        ],
    ],
];

引用方式為Db::connection('plugin.{插件}.{連接名}');,例如

use support\Db;
Db::connection('plugin.cms.mysql')->table('user')->first();
Db::connection('plugin.cms.admin')->table('admin')->first();

如果想使用主項目的資料庫,則直接使用即可,例如

use support\Db;
Db::table('user')->first();
// 假設主項目還配置了一個admin連接
Db::connection('admin')->table('admin')->first();

提示
thinkorm也是類似的用法

Redis

Redis用法與資料庫類似,例如 plugin/cms/config/redis.php

return [
    'default' => [
        'host' => '127.0.0.1',
        'password' => null,
        'port' => 6379,
        'database' => 0,
    ],
    'cache' => [
        'host' => '127.0.0.1',
        'password' => null,
        'port' => 6379,
        'database' => 1,
    ],
];

使用時

use support\Redis;
Redis::connection('plugin.cms.default')->get('key');
Redis::connection('plugin.cms.cache')->get('key');

同樣的,如果想重用主項目的Redis配置

use support\Redis;
Redis::get('key');
// 假設主項目還配置了一個cache連接
Redis::connection('cache')->get('key');

日誌

日誌類用法也與資料庫用法類似

use support\Log;
Log::channel('plugin.admin.default')->info('test');

如果想重用主項目的日誌配置,直接使用

use support\Log;
Log::info('日誌內容');
// 假設主項目有個test日誌配置
Log::channel('test')->info('日誌內容');

應用插件安裝與卸載

應用插件安裝時只需要將插件目錄拷貝到{主項目}/plugin目錄下即可,需要reload或restart才能生效。
卸載時直接刪除{主項目}/plugin下對應的插件目錄即可。