애플리케이션 플러그인

각 애플리케이션 플러그인은 완전한 애플리케이션으로, 소스 코드는 {주 프로젝트}/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\UserController의 URL은 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_class, app.public_path, app.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 아래의 해당 플러그인 디렉토리를 삭제하면 됩니다.