Laravel SudoSu 项目教程

1. 项目目录结构及介绍

sudo-su/
├── config/
│   └── sudosu.php
├── resources/
│   └── views/
│       └── sudosu/
│           └── user-selector.blade.php
├── src/
│   ├── SudoSuServiceProvider.php
│   └── ...
├── .gitignore
├── LICENSE
├── README.md
├── composer.json
├── mix-manifest.json
├── package.json
├── webpack.mix.js
└── yarn.lock

目录结构介绍

• config/: 包含项目的配置文件 sudosu.php，用于配置 SudoSu 的行为。
• resources/views/sudosu/: 包含 Blade 模板文件 user-selector.blade.php，用于显示用户选择器。
• src/: 包含项目的核心代码，如 SudoSuServiceProvider.php 等。
• .gitignore: Git 忽略文件列表。
• LICENSE: 项目的开源许可证文件。
• README.md: 项目的说明文档。
• composer.json: Composer 依赖管理文件。
• mix-manifest.json: Laravel Mix 生成的文件。
• package.json: npm 依赖管理文件。
• webpack.mix.js: Laravel Mix 配置文件。
• yarn.lock: Yarn 锁定文件。

2. 项目启动文件介绍

SudoSuServiceProvider.php

SudoSuServiceProvider.php 是 SudoSu 项目的服务提供者文件，负责注册和启动 SudoSu 服务。

namespace VIACreative\SudoSu;

use Illuminate\Support\ServiceProvider;

class SudoSuServiceProvider extends ServiceProvider
{
    public function register()
    {
        if (config('app.debug')) {
            $this->app->register('VIACreative\SudoSu\ServiceProvider');
        }
    }
}

启动步骤

1. 注册服务提供者: 在 AppServiceProvider 中注册 SudoSu 服务提供者。
2. 发布配置文件: 运行 php artisan vendor:publish 命令发布配置文件。
3. 包含 Blade 模板: 在布局文件中包含 sudosu::user-selector 模板。

3. 项目的配置文件介绍

sudosu.php

sudosu.php 是 SudoSu 项目的配置文件，位于 config/ 目录下。

return [
    'allowed_tlds' => ['dev', 'local'],
    'user_model' => 'App\User',
];

配置项介绍

• allowed_tlds: 允许使用 SudoSu 的顶级域名列表，默认值为 ['dev', 'local']。
• user_model: 应用的用户模型路径，默认值为 App\User。

配置步骤

1. 修改 allowed_tlds: 如果开发环境使用不同的顶级域名，可以在 sudosu.php 中修改 allowed_tlds。
2. 修改 user_model: 如果用户模型路径不同，可以在 sudosu.php 中修改 user_model。

通过以上步骤，您可以成功配置和使用 Laravel SudoSu 项目。