Skip to content

常见问题

执行逻辑

  • 后台框架思路很简单 M(model)只做数据库表连接(可以根据业务进行相关的 数据处理)

  • 根据自己业务写中间件(middleware)或者服务层(service)

  • 主要关注 C(controller)->V(view)->JS(控制器对应的js)

任何一个控制器都有对应的js文件 (文件目录: /public/static/admin/js/控制器同名.js)

安装过程报错及建议

  • 检查php版本号是否 >=8.0 ,建议 8.3+ 。( EasyAdmin8-Laravel 需要 8.1|8.2 以上)

  • 检查 composer 版本号是否 >=2.0 ,检查 composer 绑定的 php 版本是否跟对应上述的版本号,可以使用命令 composer show --platform ,拉到最下面一行查看

  • 不要使用阿里云 composer 镜像

  • MySQL 版本 >= 5.7,建议 8.0+ 其他版本或许可以,但是没有经过测试,请自行斟酌

  • composer install 如果无法安装,可以尝试使用 composer install --ignore-platform-reqs

  • 安装界面提示错误,主要检查数据库账号密码是否正确,相关框架在 WindowsMacOS 或者 Linux 等其他不同服务器系统中自行开放相关文件夹的 读写权限

  • 如果安装界面完成后继续跳转当前安装页面,检查 config/install/lock 路径下是否有生成 install.lock 文件,若没有生成,请执行 chown -R www:www /www/wwwroot/EasyAdmin8 ( 其中 /www/wwwroot/EasyAdmin8 是你的项目路径 )

  • 安装成功后跳转 404 ,检查 php-fpm 的程序是否开启 伪静态 配置,主要针对 ThinkPHPLaravel 版本

  • 不同 EasyAdmin8 版本的后台系统数据库结构虽然一样,但是内部数据值有细微差异,请不要共用,安装和 .env 配置时候请自行区分开来

  • 不要手动拿 sql 文件安装数据库,因为不需要。项目搭建好后,直接访问首页就可以进行数据库配置安装,全自动!

  • 需要用到 上传文件 功能的,建议先检查 php 版本是否安装了 fileinfo 扩展

  • 首次使用感觉加载速度太慢的,可以检查 .env 文件的 APP_DEBUG 配置,请在对不同框架有初步的理解下自行开关该配置项

  • 推荐必备扩展 opcacheevent

  • 强烈建议:如非过分需要,请 不要 不要 不要 将项目的任何目录或者文件权限设置成 777,合理使用 chown + chmod 配置项目权限

  • 如果修改相关框架后台路径后,需要清理系统缓存(在管理后台页面右上角)

常见案例

详细用法 - 更多文档

此文档为 ThinkPHP6 的用法,可以作为写法参考,有助于理解系统架构和逻辑

点击查看文档

项目文件权限配置

  • 建议在任何开发过程中、无论任何语言开发的项目,都不要把文件夹权限设置成 777 ,除非特别 不合理 的需求

  • 可以通过以下方式进行项目文件夹权限配置(实际项目中请换成自己的目录地址)

shell
chown  -R  www:www /wwww/wwwroot/EasyAdmin8
shell
chmod  -R  755 /wwww/wwwroot/EasyAdmin8

EasyAdmin8版本(ThinkPHP)

  • 域名绑定需要定位到public

  • 伪静态配置

shell
location / {

        if ( !-e $request_filename){
    
            rewrite ^/(.*)$ /index.php?s=$1 last;
    
            break;
    
        }
    
    }

EasyAdmin8-Laravel版本(Laravel)

  • 域名绑定需要定位到public

  • 全局路由在routes/web.php

  • 伪静态配置

shell
 location / {

      try_files $uri $uri/ /index.php$is_args$query_string;

}

EasyAdmin8-webman版本(webman)

  • 该版本提供不同习惯开发分支,习惯Laravel的选择main分支、习惯ThinkPHP的选择thinkphp分支

  • 如果出现 {"code":-1,"msg":"访问地址异常"} ,参照 .example.env 文件在 .env 中新增 EASYADMIN.ADMIN_DOMAIN_STATUSEASYADMIN.ADMIN_DOMAIN 配置,并且 composer require webman/domain (该功能是可以自定义后台访问地址,具体参考 配置自定义域名

  • 禁用函数检查