ThinkAdmin 项目常见问题解决方案

项目基础介绍和主要编程语言

ThinkAdmin 是一个基于 ThinkPHP6 的极简后台管理系统，遵循 MIT 协议免费开源。它内置了注解权限、异步多任务、应用插件生态等功能，支持类 PaaS 更新公共模块和应用插件，插件可本地化定制开发。该项目主要使用 PHP 语言进行开发，依赖于 ThinkPHP6 框架。

新手使用注意事项及解决方案

1. 环境配置问题

问题描述：新手在配置运行环境时，可能会遇到 PHP 版本不兼容或 PATHINFO 未开启的问题。

解决步骤：

• 检查 PHP 版本：确保 PHP 版本不低于 7.2.5。如果版本过低，建议升级 PHP 版本。
• 开启 PATHINFO：在服务器配置中开启 PATHINFO 支持，并将对应的 rewrite 规则配置到站点。具体配置方法可以参考 ThinkAdmin 的文档安装部署章节。

2. Composer 依赖安装问题

问题描述：下载项目后，执行 composer install 时可能会遇到依赖组件安装失败的问题。

解决步骤：

• 检查 Composer 版本：确保 Composer 版本是最新的，如果不是，建议更新 Composer。
• 执行安装命令：在项目根目录下执行 composer install 命令，安装所有依赖组件。如果遇到权限问题，可以使用 sudo 命令提升权限。
• 数据库初始化：安装依赖后，执行 php think migrate:run 命令，初始化数据库 Phinx 脚本。

3. 文件目录权限问题

问题描述：在项目运行过程中，可能会遇到文件或目录权限不足的问题，导致某些功能无法正常使用。

解决步骤：

• 检查目录权限：确保项目目录及其子目录的权限设置正确。通常需要将 storage 和 runtime 目录设置为可写权限。
• 设置权限：使用 chmod 命令设置目录权限，例如 chmod -R 755 storage 和 chmod -R 755 runtime。
• 避免修改核心文件：为保持系统可持续在线升级，建议不要在 app/admin、app/wechat 和 public/static 这三个目录创建或修改文件。自定义文件可以放置在 public/static/extra 目录中。

通过以上步骤，新手可以更好地解决在使用 ThinkAdmin 项目时遇到的一些常见问题，确保项目能够顺利运行。