# 前序准备

序号 描述 操作
1 克隆BuildAdmin (opens new window)代码到本地或下载完整包
2 PHP >= 8.0.2 (开发环境为PHP8.0.2版本) 达成指引 (opens new window)
3 Mysql >= 5.7 (需支持innodb引擎、开发环境为8.0版本)
4 NodeJs >= 18.18.2 达成指引 (opens new window)
5 Npm >= 9.8.1 达成指引 (opens new window)
6 Composer(完整包不必要,Git克隆包必需安装) 达成指引 (opens new window)

STOP

不要创建网站!!!请按文档完成安装。

WARNING

建议您在本地PC上安装系统来作为开发环境,只上传编译后的站点到服务器即可,参考 (opens new window)

# 启动安装服务

# 其中 buildadmin 为项目根目录,该目录包含一个没有前后缀的 think 文件
cd buildadmin

# git克隆的代码需要执行这条命令,完整包不需要,若找不到命令,可以尝试:composer.phar install
composer install

# Linux下推荐使用:sudo php think run
# Linux下若加sudo后仍然异常,请确保 buildadmin 目录的所有者和执行此命令的用户一致,推荐root
php think run

上述php think run命令执行成功后输出类似:

ThinkPHP Development server is started On <http://0.0.0.0:8000/>
You can exit with `CTRL-C`
Document root is: D:\WWW\buildadmin\public

接下来,请在浏览器访问:http://127.0.0.1:8000/ (opens new window),根据引导完成安装即可

提示

若您无法自主完成安装,请移步更详细的Windows下完整安装流程Linux下完整安装流程也有MacBook下安装引导

提示

  1. 安装完成后,请您一定查看开发者必看 (opens new window)文档。
  2. 安装服务只提供WEB服务,其他比如MySQL数据库的服务需要自行单独管理。
  3. 安装完成后推荐使用Nginx、Apache等服务器软件运行站点,站点的根目录为buildadmin目录,站点运行目录为buildadmin/public,无需配置隐藏index.php,可以选择配置:隐藏index.html (opens new window)

# 停止安装服务

  1. 命令行窗口,按下Ctrl+C,即可停止服务。
  2. 命令行窗口程序停止运行/断开时,服务会自动停止。
  3. 停止服务后,站点将不能继续访问,通常应使用NginxApache等服务器软件来搭建您的站点。
  4. 后续需要使用安装服务时,再启动即可

# 常见问题

  1. 命令php -v可以查看当前环境PHP版本,请确保PHP版本>=8.0.2,若无PHP命令,请先安装PHP (opens new window),并将PHP加入环境变量
  2. 请确定在站点的根目录执行php think run命令,也就是think文件所在目录,请注意该文件无任何后缀
  3. 检查您打开的站点域名,确定是打开了安装服务 (opens new window)IP/域名:8000站点,而非是运行于Nginx、Apache服务下的站点。

# 安装服务无法访问/WEB终端无法连接

请检查buildadmin站点目录的权限和用户组,同时请检查您打开的站点域名(以上第3点)。

# 提示xxxxx() has been disabled for security reasons

表示xxxxx所示的函数,在php.ini中被禁用了,请参考这里 (opens new window),解除函数禁用

# 提示composer install 命令不存在?

如果您已完成了Composer的安装,但还是找不到composer命令,可以尝试composer.phar install命令,如果命令还不存在,那么请检查您电脑的环境变量设置,问题无法解决时,请使用:完整包

# composer提示Your requirements could not be resolved to an installable set of packages.

请检查报错下方的Problem,依次解决即可,比如提示overtrue/wechat 4.6.0 requires ext-fileinfo * -> it is missing from your system. Install or enable PHP's fileinfo extension.,那么请为PHP安装fileinfo扩展。

# WEB终端提示xxxxx: command not found

请检查您打开的站点域名(以上第3点),然后Linux用户请尝试使用sudo php think run来启动服务。

# WEB终端提示权限不足permission denied

请检查您打开的站点域名(以上第3点),然后Linux用户请尝试使用sudo php think run来启动服务,还不行,请检查buildadmin目录权限和用户组。