文档首页 / HareAdmin 开发手册

安装说明

环境要求

PHP >= 8.0.2(推荐 8.1+)
MySQL >= 5.7(需 InnoDB)
Apache 或 Nginx(站点根目录指向 public)
PHP 扩展:fileinfo(上传必须)、pdo_mysql、curl、mbstring、openssl …
Composer(安装 PHP 依赖)
Node.js(可选;仅在需要自行构建/打包前端资源时)

完整包与仓库已包含主要前端静态资源,一般无需额外前端包管理工具。

完整包安装

  1. 从官网下载完整包,解压到项目目录
  2. 虚拟主机 / 站点根目录绑定到 public
  3. Nginx 示例重写:
    location / {
        if (!-e $request_filename) {
            rewrite ^(.*)$ /index.php?s=$1 last;
            break;
        }
    }
  4. 访问 http://www.yoursite.com/install 完成安装

命令行安装

  1. git clone 项目到本地
  2. cd 进入项目目录
  3. composer install
  4. 绑定站点到 public,配置重写后访问 /install

常见问题

  1. 提示找不到表:确认 MySQL 已启用 InnoDB,表前缀与安装配置一致(默认常为 yt_)。
  2. Linux 权限:代码属主改为 PHP-FPM / Web 运行用户。
  3. composer install 失败:可配置 Composer 镜像后重试。