EasyAdmin8

Appearance

常见问题 ​

执行逻辑 ​

  • 后台框架思路很简单 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 ,拉到最下面一行查看

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

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

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

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

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

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

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

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

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

  • 推荐必备扩展 opcache、event

  • 强烈建议：如非过分需要，请 不要 不要 不要 将项目的任何目录或者文件权限设置成 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_STATUS 和 EASYADMIN.ADMIN_DOMAIN 配置，并且 composer require webman/domain （该功能是可以自定义后台访问地址，具体参考 配置自定义域名）

  • 禁用函数检查