- demo 插件 plugins/demo.hello-world:演示短代码过滤器、comment.created 钩子、路由+命名空间视图、迁移+模型、后台设置页、filament.post_form 表单注入 - demo 主题 themes/demo:最小可运行主题(覆盖 partials + 绿色系样式) - 教程 docs/tutorial-plugin.md / docs/tutorial-theme.md(10 分钟上手);规范 docs/development.md(代码/插件/主题/队列/测试/提交) - README 增加开发者文档导航与上手示例 - 修复关键缺口:插件类原来靠 composer.json 硬编码加载,第三方 ZIP 安装的插件无法加载;现改为启动时扫描 plugins/*/src 运行期注册 PSR-4(register 阶段,保证 Filament 面板解析插件页面前就绪),composer.json 移除硬编码 - 测试:demo 插件 3 个用例 + demo 主题渲染;全量 89 通过
70 lines
1.9 KiB
PHP
70 lines
1.9 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
|
|
namespace App\Blog\Providers;
|
|
|
|
use App\Blog\Support\PluginManager;
|
|
use Illuminate\Support\Facades\File;
|
|
use Illuminate\Support\ServiceProvider;
|
|
use Illuminate\Support\Str;
|
|
|
|
class PluginManagerServiceProvider extends ServiceProvider
|
|
{
|
|
public function register(): void
|
|
{
|
|
$this->app->singleton(PluginManager::class);
|
|
|
|
// 运行期自动加载:扫描 plugins/*/src,按 Plugins\{Vendor}\{Name} 注册 PSR-4。
|
|
// 必须在 register() 阶段完成:Filament 面板 boot 时要解析插件页面类,
|
|
// 第三方 ZIP 安装的插件无需修改 composer.json。
|
|
if (is_dir(config('plugins.path'))) {
|
|
$this->registerPluginAutoload();
|
|
}
|
|
}
|
|
|
|
public function boot(): void
|
|
{
|
|
if (! is_dir(config('plugins.path'))) {
|
|
return;
|
|
}
|
|
|
|
$manager = $this->app->make(PluginManager::class);
|
|
|
|
foreach ($manager->all() as $key => $plugin) {
|
|
if (! $plugin['enabled']) {
|
|
continue;
|
|
}
|
|
|
|
// 依赖未满足的插件跳过加载,避免运行时缺底层能力
|
|
if ($manager->dependencyProblems($key)) {
|
|
continue;
|
|
}
|
|
|
|
$provider = $manager->resolveProvider($key);
|
|
|
|
if ($provider && class_exists($provider)) {
|
|
$provider::bootPlugin($manager);
|
|
}
|
|
}
|
|
}
|
|
|
|
private function registerPluginAutoload(): void
|
|
{
|
|
$loaders = \Composer\Autoload\ClassLoader::getRegisteredLoaders();
|
|
$loader = reset($loaders);
|
|
|
|
if (! $loader) {
|
|
return;
|
|
}
|
|
|
|
foreach (File::directories(config('plugins.path')) as $dir) {
|
|
$basename = basename($dir);
|
|
[$vendor, $name] = array_pad(explode('.', $basename), 2, $basename);
|
|
|
|
$loader->addPsr4('Plugins\\'.Str::studly($vendor).'\\'.Str::studly($name).'\\', $dir.'/src/');
|
|
}
|
|
}
|
|
}
|