快速上手

前序准备

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

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

启动安装服务

# 其中 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/，根据引导完成安装即可 ::: tip 提示 若您无法自主完成安装，请移步更详细的 Windows下完整安装流程 或 Linux下完整安装流程 也有 MacBook下安装引导 :::

::: warning 提示

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

:::

停止安装服务

1. 开发环境需要继续使用本安装服务，正式上线时，才使用 Nginx、Apache 等服务器软件来搭建您的站点。
2. 在 命令行窗口 ，按下 Ctrl+C ，即可停止服务。
3. 在 命令行窗口程序 停止运行/断开时，服务会自动停止。

注意事项

1. 命令 php -v 可以查看当前环境PHP版本，请确保 PHP版本>=8.0.2，若无 PHP 命令，请先 安装PHP，并将PHP加入环境变量
2. 请确定在站点的根目录执行 php think run 命令，也就是 think 文件所在目录，请注意该文件无任何后缀
3. 检查您打开的站点域名，确定是打开了 安装服务 的 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 目录权限和用户组。