必须执行php artisan storage:link创建符号链接，否则缩略图和预览图无法加载；需在路由中添加auth中间件保障安全访问，且config/lfm.php中磁盘名须与config/filesystems.php严格一致。
要在 Laravel 后台快速启用可视化文件管理功能，必须让文件管理器界面能被安全访问、与现有认证体系打通、并正确映射到 storage 目录——漏掉任一环节都会导致 404、空白页或未授权访问。
安装与资源发布
执行命令安装主包：composer require unisharp/laravel-filemanager
发布配置文件，生成 config/lfm.php：php artisan vendor:publish --tag=lfm_config
发布前端静态资源（JS/CSS/图标）：php artisan vendor:publish --tag=lfm_public
【必须执行】 创建 storage 到 public 的符号链接：php artisan storage:link。若跳过此步，所有缩略图和预览图将无法加载，界面显示占位符而非真实文件。
路由与权限控制
打开 routes/web.php，在文件末尾添加带中间件的路由组：
Route::group(['prefix' => 'laravel-filemanager', 'middleware' => ['web', 'auth']], function () {<br> \UniSharp\LaravelFilemanager\Lfm::routes();<br>});
这一步强制要求用户登录后才能访问文件管理器，【不加 auth 中间件等于直接暴露服务器文件系统】。
若项目使用自定义认证守卫（如 admin guard），需同步修改 middleware 为 auth:admin，否则登录态无法识别，始终跳转登录页。
配置默认磁盘与路径
编辑 config/lfm.php，定位到 'disk' => ['default' => 'public'] 行，确保其值与 config/filesystems.php 中已定义的磁盘名完全一致。
检查 'private_path' => 'private' 和 'shared_path' => 'shared' 是否对应实际存在的子目录；若目录不存在且未开启自动创建，上传操作会静默失败。
设置左侧面板默认打开路径：'leftPath' => 'uploads'。该路径必须是 public 磁盘下的合法子路径，例如 public/uploads 存在，但 public/images/upload 不存在时，页面将报错“Directory not found”。
CKEditor 集成（富文本内嵌调用）
方法一：直接注入配置参数
在 CKEditor 初始化脚本中加入 filebrowser 配置项：
filebrowserImageBrowseUrl: '/laravel-filemanager?type=Images',<br>filebrowserImageUploadUrl: '/laravel-filemanager/upload?type=Images&_token={{ csrf_token() }}',<br>filebrowserBrowseUrl: '/laravel-filemanager?type=Files',<br>filebrowserUploadUrl: '/laravel-filemanager/upload?type=Files&_token={{ csrf_token() }}'
注意：CSRF token 必须动态注入，硬编码 token 或省略会导致上传请求被拒绝，控制台报 419 错误。
方法二：通过 URL 参数临时指定上下文
在编辑器触发文件选择时，拼接 URL：/laravel-filemanager?editor=content&type=Images&field_name=article_image。该方式无需修改全局配置，适合多编辑器共存场景，但需确保 field_name 与回调函数中接收字段名一致。
独立访问文件管理器页面
第一步：确认 APP_URL 已在 .env 中正确设置，例如 APP_URL=http://localhost:8000。若为域名部署，必须写完整协议+域名，否则资源加载路径错误，页面白屏。
第二步：清除配置缓存：php artisan config:clear。旧缓存可能保留未发布的 lfm.php 配置，导致路径、磁盘设置不生效。
第三步：访问 http://your-domain.com/laravel-filemanager。首次加载较慢属正常现象，因需生成缩略图并扫描目录结构。
第四步：登录后台账号后，即可进入双面板界面——左侧浏览本地磁盘，右侧可切换至 FTP 或 S3（需额外配置）。
