docs: 开发规范/教程/demo 全套 + 修复插件运行期自动加载缺口
- 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 通过
This commit is contained in:
@@ -6,23 +6,32 @@ 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
|
||||
{
|
||||
$manager = $this->app->make(PluginManager::class);
|
||||
|
||||
if (! is_dir(config('plugins.path'))) {
|
||||
return;
|
||||
}
|
||||
|
||||
$manager = $this->app->make(PluginManager::class);
|
||||
|
||||
foreach ($manager->all() as $key => $plugin) {
|
||||
if (! $plugin['enabled']) {
|
||||
continue;
|
||||
@@ -40,4 +49,21 @@ class PluginManagerServiceProvider extends ServiceProvider
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
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/');
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user