BuildAdmin

# 前序准备

序号 描述 操作
1 克隆BuildAdmin (opens new window)代码到本地或下载完整包
2 PHP >= 7.2.5 (开发环境为PHP7.4版本) 达成指引 (opens new window)
3 Mysql >= 5.6 且 <= 8.0 (需支持innodb引擎、开发环境为5.7版本)
4 NodeJs >= 14.13.1 达成指引 (opens new window)
5 Npm >= 6.14.0 达成指引 (opens new window)
6 Composer（完整包不必要，Git克隆包必需安装） 达成指引 (opens new window)

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. 停止服务后，站点将不能继续访问，通常应使用Nginx、Apache等服务器软件来搭建您的站点。
  4. 后续需要使用安装服务时，再启动即可

# 常见问题

  1. 命令php -v可以查看当前环境PHP版本，请确保PHP版本>=7.2.5，若无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目录权限和用户组。

← 安装服务进阶 →