快速上手

前序准备

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

STOP

不要创建网站！！！请按以下文档完成安装，开发环境和安装期间无需 Nginx、Apache 这类服务器软件的支持。

WARNING

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

启动安装服务

bash

# 其中 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 命令执行成功后输出类似：

bash

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/，根据引导完成安装即可

提示

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

提示

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

停止安装服务

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

注意事项

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

常见问题

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

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

2. 提示 xxxxx() has been disabled for security reasons

表示xxxxx所示的函数，在php.ini中被禁用了，请参考这里，解除函数禁用

3. 提示 composer install 命令不存在？

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

4. 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扩展。

5. WEB终端提示 xxxxx: command not found

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

6. WEB终端提示 权限不足、permission denied

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

快速上手 ​

前序准备 ​

启动安装服务 ​

停止安装服务 ​

注意事项 ​

常见问题 ​