常见问题汇总

1.如何设置语言为简体中文？

打开配置文件config/app.php，设置locale参数的值为zh_CN。

2.Laravel7时间显示为UTC格式

这个是Laravel7升级后带来的坑，原因请参考日期序列化。

在本项目中解决这个问题很简单，只需在Model中引入Dcat\Admin\Traits\HasDateTimeFormatter这个trait即可。

  1. <?php
  3. namespace App\Models;
  5. use Dcat\Admin\Traits\HasDateTimeFormatter;
  6. use Illuminate\Database\Eloquent\Model;
  8. class MyModel extends Model
  9. {
  10.      use HasDateTimeFormatter;
  11. }

3.表单保存时报错Array to string conversion

出现这个问题是因为表单提交的值最后转换成了array类型，而MySQL是不支持直接存储array类型数据的，在dcat-admin中可以用以下方式对数据格式进行转换

  1. $form->multipleSelect('user_id')->saving(function ($v) {
  2.     // 转为 , 隔开的字符串
  3.     return implode(',', $v);
  4. });

当然，也可以通过model的修改器去转化字段的值，这方面内容可以参考laravel文档，这里就不再赘述。

{tip} 更优雅的转化值方法，可参考 Dcat Admin 教程 - 如何优雅地更改表单值的数据类型？

4.如何从laravel-admin迁移到dcat-admin？

Dcat Admin 教程 - 如何从 Laravel admin 迁移到 dcat admin？

5.重写登陆页面和登陆逻辑

方式一，重写登陆控制器方法：

默认的登陆控制器用的是App\Admin\AuthController这个类，可以通过配置参数admin.auth.controller进行修改

  1. <?php
  3. namespace App\Admin\Controllers;
  5. use Dcat\Admin\Controllers\AuthController as BaseAuthController;
  7. class AuthController extends BaseAuthController
  8. {
  9.     // 自定义登陆view模板
  10.     protected $view = 'admin.login';
  12.     // 重写登陆页面逻辑
  13.     public function getLogin(Content $content)
  14.     {
  15.         ...
  16.     }
  18.     ...
  19. }

方式二，覆写路由：

在路由文件app/Admin/routes.php中，覆盖掉登陆页面和登陆逻辑的路由，即可实现自定义的功能

  1. Route::group([
  2.     'prefix'        => config('admin.prefix'),
  3.     'namespace'     => Admin::controllerNamespace(),
  4.     'middleware'    => ['web', 'admin'],
  5. ], function (Router $router) {
  7.     $router->get('auth/login', 'AuthController@getLogin');
  8.     $router->post('auth/login', 'AuthController@postLogin');
  10. });

在自定义的路由器AuthController中的getLogin、postLogin方法里分别实现自己的登陆页面和登陆逻辑。

6.更新新版本后出现异常

如果遇到更新之后,部分组件不能正常使用,那有可能是dcat-admin自带的静态资源有更新了,需要运行命令php artisan admin:publish --force来重新发布前端资源，发布之后不要忘记清理浏览器缓存.

7.文件上传失败或无法访问？

如果你发现无法上传文件，那么通常有几下几点原因：

  1. Laravel文件上传配置不正确，请参考文档图片/文件上传。如果你不了解laravel文件上传功能，请阅读文档Laravel - 文件存储
  2. 文件过大，需要调整php.ini的upload_max_filesize参数
  3. 文件上传目录没有写权限
  4. php没有安装或没有开启fileinfo扩展
  5. 检查php.ini的upload_tim_dir参数设置是否正常

如果文件上传成功了，却无法正常访问，那么可能是.env配置文件中的APP_URL参数没有设置正确。

8.关于前端资源加载问题

Dcat Admin是支持前端资源按需加载的，在需要用到某个组件的时候再引入前端资源即可，开发者无需担心安装组件过多影响页面加载速度。

只有那种需要在全局页面引入的资源，才需要在app/Admin/bootstrap.php或ServiceProvider::boot方法中引入：

  1. Admin::css('path/to/your/css');
  2. Admin::js('path/to/your/js');

9.为何配置了角色和权限，依然提示无权访问？

这个原因可能是由于权限的URL路径配置错误导致的，正确的包含增删改查功能的URL配置应该是auth/users*这样的，如果配置成了auth/users/*，那么就会提示无权访问。

{tip} 另外标签表单填写自定义URL有两种方法：一种是选中后按删除键进行更改；另一种是填写后按空格键 + 回车键。

10.为何没有权限的菜单不会自动隐藏？

这个问题是因为没有给菜单绑定权限或者角色，给想要无权不显示的菜单绑定权限或者角色即可。

11.项目使用HTTPS之后无法登陆

需要把配置文件的admin.https参数的值设置为true

12.$.get(xxx) 没有反应

Dcat Admin使用的是jQuery3.x，$.get方法在jQuery3.x中已经被废弃，请使用$.ajax代替

13.上传的图片经常莫名其妙自动删除？

出现这个问题的原因很可能是因为Model中设置了图片相关字段的访问器，如

  1. class User extend Model
  2. {
  3.     public function getAvatarAttribute()
  4.     {
  5.         return Storage::disk('admin')->url($this->avatar);
  6.     }
  7. }

这种情况下会出现自动删除已上传图片的情况，解决方法也很简单，把访问器改成自定义方法即可

  1. class User extend Model
  2. {
  3.     public function getAvatar()
  4.     {
  5.         return Storage::disk('admin')->url($this->avatar);
  6.     }
  7. }

14.前后台session发生冲突

从2.0的版本之后 admin.session 中间件不再默认启用，如果您的应用同时有前台和后台，则需要开启 admin.session 中间件，否则会造成前后台 session 冲突问题。

把配置参数 admin.route.enable_session_middleware 的值设置为 true 即可开启

  1.     'route' => [
  2.         'domain' => env('ADMIN_ROUTE_DOMAIN'),
  4.         'prefix' => env('ADMIN_ROUTE_PREFIX', 'admin'),
  6.         'namespace' => 'App\\Admin\\Controllers',
  8.         'middleware' => ['web', 'admin'],
  10.         // 开启 admin.session 中间件
  11.         'enable_session_middleware' => true,
  12.     ],

15.图片防盗链

图片请求默认会去掉 referer 字段，如果有防盗链要求，可以在配置文件(config/admin.php)中设置：

  1.  "disable_no_referrer_meta" => true