BeikeShop官方开发文档 | 安装教程 使用开发教程

# 源码安装

TIP

本文档以宝塔面板 8.0.4 版本、CentOS 8.5 系统源码安装BeikeShop系统为例。

# 安装环境要求

  1. PHP 8.1+

  2. MySQL 5.7+

  3. Apache httpd 2.4+ 或者 Nginx 1.10+

  4. Nodejs 14+

前提条件:

  • 宝塔面板安装的 PHP 版本需为 8.1 及以上，MySQL 版本需要为 MySQL 5.7 及以上
  • 宝塔面板已经安装好Apache httpd 2.4+ 或者 Nginx 1.10+
  • 已成功登录宝塔控制台

# 操作步骤

步骤一：配置PHP
安装扩展

TIP

BeikeShop系统 依赖于 fileinfo 扩展运行，宝塔安装PHP后默认fileinfo扩展没有安装。部署前需对 PHP 进行相关配置。以下操作将指导您安装fileinfo扩展

  1. 在宝塔控制台中，单击【软件商城】->【已安装】，查找已安装的 PHP 软件。如下图所示

img

  1. 单击选择需要为 BeikeShop 系统使用的 PHP 软件名称（需为8.1及以上）。此处以 PHP-8.1 为例。

img

  1. 在弹出的 【php 管理】窗口中，单击【安装扩展】，进行安装扩展设置。如下图所示

img

  1. 选择【fileinfo】，并单击【安装】。如下图所示：

img

5.等待安装完成即可

删除函数

TIP

BeikeShop系统需删除禁用的函数 putenv、proc_open，部署前需对 PHP 进行相关配置。以下操作将指导您删除禁用函数

  1. 在 【php 管理】窗口中，单击【禁用函数】，进入禁用函数设置页面。如下图所示：

img

  1. 在函数列表中单击【删除】函数 putenv、proc_open ，即可删除禁用的函数。

步骤二：创建站点

  1. 在宝塔控制台中，单击【网站】->【添加站点】。如下图所示：

img

  1. 在弹出的添加网站窗口中，输入相关配置信息。如下图所示

img

TIP

域名：输入绑定 BeikeShop系统的域名。
确保绑定的域名已添加相关解析。 备注：可选，可添加网站的备注信息。 根目录：网站文件根目录。一般情况使用默认 /www/wwwroot 路径。
FTP：可选，可创建 FTP 服务。默认不创建。
数据库：可选，您可在您的服务器内创建数据库进行使用。数据库类型需为 MySQL 5.7 及以上版本,如需在服务器内创建数据库进行使用，请选择【MySQL】【utf8mb4】，并输入数据库用户名以及密码。 程序类型：PHP，默认不可选。
PHP版本：请选择已配置完成的 PHP 版本。
网站分类：默认分类。可根据实际情况进行选择。

3.单击【提交】。即可创建站点

步骤三:获取源码进行配置

TIP

  • 主机已安装Git
  • 主机composer 版本2.0及以上，宝塔8.0.4版本安装PHP后默认已有composer
  • 主机已安装Nodejs 14+
  1. 服务器进入/www/wwwroot/test.beike.shop目录，test.beike.shop为站点目录，根据实际为准
cd /www/wwwroot/test.beike.shop
  1. 克隆源码
git clone https://gitee.com/beikeshop/beikeshop.git
  1. 命令行进入beikeshop目录, 执行 composer install 安装第三方包
cd beikeshop

composer install
  1. 接着执行 cp .env.example .env 创建配置文件
cp .env.example .env
  1. 接着执行 npm install 以及 npm run dev 编译前端 js 和 css 文件
npm install  

npm run dev
  1. 将项目文件夹下的 public 设置为网站根目录

在宝塔控制台中，单击【网站】，并选择已创建 BeikeShop 站点，单击【设置】。如下图所示：

img

在弹出的站点修改窗口中，单击【网站目录】，进行网站目录相关设置。如下图所示：

img
网站目录设置为：/www/wwwroot/test.beike.shop/beikeshop
运行目录设置为：/public

去掉防跨站攻击选项

img

  1. Nginx环境伪静态配置(如果使用的是Apache这一步可以省略)

在宝塔控制台中，单击【网站】，并选择已创建 BeikeShop 站点，单击【设置】。如下图所示：

img

在弹出的站点修改窗口中，单击【网站目录】，进行网站目录相关设置。如下图所示：
img

在文本框中输入以下内容。如图所示

location / {

 try_files $uri $uri/ /index.php?$query_string;

}

img

你也可以直接在对应的文件中编辑（文件名就是域名.conf）。如下图所示：

alt alt
  1. 修改storge、public目录和.env文件权限为755或者777

步骤四:系统安装

浏览器输入域名 test.beikeshop.com地址，出现如图所示界面则成功进入安装页面。

alt

依次点击Check Requirements、Check Permissions、Configure Environment按钮 Installation Finished 完成。

第1步：安装界面

alt

第2步：环境检查

alt

第3步：目录权限检查

alt

第4步：填写数据库、后台登录用户信息并点击 Install 按钮

alt

说明： 填写好Database系统自动检测通过后才会出现Set admin account password 这一个信息栏

第5步：安装成功，出现如图所示页面则安装成功 alt

商城界面

前台界面

img

后台界面
img

TIP

至此安装教程到此结束。接下来您可以使用系统了!
如有其它问题，请联系 marketing@guangda.work / QQ:9358972

# 常见问题

1.执行composer install遇到如下图所示错误

img
img

解决方法：删除禁用函数putenv、proc_open

  1. 执行composer install遇到如下图所示错误

img

解决方法：安装fileinfo扩展

  1. 使用Nginx做为web服务，配置好站点首次打开页面显示404
    解决方法：配置伪静态
location / {

 try_files $uri $uri/ /index.php?$query_string;

}
  1. 出现如图所示错误

img
解决方法：代码根目录下执行composer install

  1. 出现页面样式错误，如图所示

img
解决方法：代码根目录执行 npm install && npm run dev

6.出现如图所示错误

img

或者

img

解决方法：修改storge目录权限为755或者777

7.安装系统填写完数据库信息并检索通过点击安装出现如图所示错误

img
或者 img

解决方法:修改.env文件权限为755或者777

  1. 系统安装完成后进入商城首页报500错误或者如图所示错误

img
或者 img

解决方法：修改public目录权限为755或者777

← 首页装修 →