独角数卡配置(一)安装过程以及可能遇到的坑
我将独角数卡的配置分成了两篇:
1 年多之前我搭建过独角数卡发卡站,不过只是测试了一下功能之后就搁置了,并没有正式运营起来。这会儿我又想真正好好运营一下,因为一直以来都想拥有自己的发卡站,可以出售一些自己购买或整理的资料,回回血。那么废话不多说了,开始进入正题。
独角数卡是一个开源式站长自动化售货解决方案、高效、稳定、快速!独角数卡的设计简洁明了,用户界面友好,操作便捷。它采用业界流行的
laravel
框架,提升了安全性及稳定性,而且这个代码长期维护,用户体验很好。
下面以宝塔面板为例来说明配置过程。
准备工作
在正式创建站点之前,需要做一些准备工作。独角数卡是有必须的环境要求
的,以下是基本要求:
- (PHP + PHPCLI) version = 7.4
- Nginx version >= 1.16
- MYSQL version >= 5.6
- Redis (高性能缓存服务)
- Supervisor (一个
python
编写的进程管理服务) - Composer (PHP 包管理器)
- 需要开启 PHP 的
putenv
,proc_open
,pcntl_signal
,pcntl_alarm
函数 - 需要安装
fileinfo
、opcache
及redis
扩展 - 终端需支持
php-cli
,测试php -v
(版本必须一致)
所以要先看下自己的环境是否满足,PHP、MySQL、Nginx、Redis、Composer、进程管理器都是要有的,我就不具体截图了,没有安装的话在软件商店安装一下就行。下面去开启必要函数及安装扩展。我的是 PHP 7.4.33 版本,点 设置
——禁用函数
,把上面提到的 4 个函数都删除。
在安装扩展
中,将上面提到的扩展都安装。
创建数据库
在宝塔面板添加一个新的数据库,并设置用户名密码等,这里是为了下一步做准备。
拉取代码并修改配置
进入到 wwwroot
目录下,执行命令
1 | git clone https://github.com/assimon/dujiaoka.git |
前提是需要先安装 git
,代码拉取完毕后,vim .env
,写入 MySQL 数据库配置信息及 Redis 配置信息:
修改完毕后,在dujiaoshuka
这个目录运行composer install
安装依赖,之后给 storage
目录赋予写入权限:
创建站点
拉取完代码,也创建好数据库并正确设置了配置信息之后,就可以在面板上面创建站点了,根目录选择到dujiaoshuka
目录,PHP
版本选择 7.4
,因为之前已经手动创建了数据库,那么这里的数据库就选择 不创建
。
站点的运行目录
选择public
而不是根目录,伪静态选择laravel 5
。
配置守护进程
为了网站能够更好地运行,是需要配置守护进程的。宝塔面板升级之前,我是用堡塔应用管理器
配置的守护进程,之前是这样配置的:
启动文件选择dujiaoshuka
下面的artisan
的路径,执行目录选择dujiaoshuka
目录,参数填写的queue:work
,之后就可以正常启动守护进程了。
但升级了宝塔面板之后,这个堡塔应用管理器貌似是下线了,官方建议使用进程守护管理器
,就是这个小企鹅图标的应用
但它的设置和前面的有些不一样,研究了一下,最后这样配置是生效的:
其实主要的不同就是在启动命令
这里,相当于是把宝塔应用管理器
的启动文件
和启动参数
合并到启动命令这里面了
,所以就填入artisan
文件的绝对路径,后面跟着queue:work
就可以了。
做好这些之后,就可以通过网址来访问网站了,当然前提是你已经将域名正确解析到了你的服务器,域名解析的过程这里就略过了。
设置网站信息
第一次访问网站,会像 WordPress 一样来到站点设置的界面,把之前设置好的数据库名称、数据库用户名、数据库密码正确的录入进去,如果 Redis 有密码也录入,录入网站地址。网站的后台地址是可以自定义的,默认是 /admin
,这里为了安全考虑还是修改一下比较好。
全部设置完成之后点提交,安装成功之后就可以正常访问前后台了。默认的后台用户名密码都是admin
,登录到后台之后在系统设置
——管理员
里面修改一下,至此整个安装过程就完成了。
可能遇到的坑
如果你的安装过程是一帆风顺的,那么恭喜你,可以进行下一步操作了。但大多数的安装过程都不是那么美丽的,这里说几个我遇到的坑点,给同样遇到这类问题的你一些参考。
Composer 命令运行时没有任何反应
这是我解决花费时间最长的问题。出现的现象就是只要运行的是与Composer
相关的命令,全都是毫无反应,连报错都没有,不论是 composer install
、composer update
还是composer -v
,全都是卡住不动,极偶尔会出现运行超时,超过300秒,但并不是网络问题,因为服务器上其他的下载速度都是正常的。期间尝试过重新安装 Composer
、切换 PHP 版本、用绝对路径运行等等,全都不行。
最后在宝塔论坛上一个特别不明显的位置,有一个回复说楼主的报错都是与 xdebug
这个扩展有关,建议安装此扩展,我的问题并没有报错,我也不知道是不是与这个扩展有关,我就抱着试试看的态度安装,想着如果不好用,再卸载就好了,结果安装完了之后真的好使了。。。所以你能看到上面我的扩展截图中是有安装了这个扩展的。
配置守护进程一直启动失败
按照前面写的那样在进程守护管理器的3.0.4
版本确实是一遍过,配置上马上就生效了,但我配置的时候最新版本是3.0.5
,我怎么配置都失败,后来没办法就卸载之后降了一个版本,结果成功了。。
后台提交时提示 error 0
安装完毕后我首先添加分类,但每次提交都失败,提示error 0
,这个是因为网站开启了 SSL 安全证书。访问前台是没有这个问题的,只在后台出现,是因为后台的 HTTPS
没有开启,解决方法就是修改.env
配置文件,将ADMIN_HTTPS
设置为true
即可。