wizard知识库系统搭建
1、项目位置
https://github.com/mylxsw/wizard
简要介绍:Wizard是一款开源文档管理系统,目前支持三种类型的文档管理:Markdown,Swager,Table。主要功能有文档版本管理、用户权限管理、项目分组管理、文档搜索、分享、评论等。
2、软件列表
软件列表 | 版本号 |
MySQL | 5.7.33 |
PHP | 7.2.3 |
Nginx | 1.19.6 |
Redhat操作系统 | 7.7 |
3、原理介绍
搭建wizard项目依赖LNMP架构,所以首先要把LNMP基础环境搭建好。
3.1 LNMP架构
LNMP代表的就是:Linux+Nginx+MySQL+PHP这种网站服务器架构。
• Linux:是一类Unix计算机操作系统的统称,是目前最流行的免费操作系统。
• Nginx:是一个高性能的HTTP和反向代理服务器,也是一个IMAP/POP3/SMTP代理服务器。
• Mysql:是一个中小型关系型数据库管理系统。
• PHP:是一种在服务器端执行的嵌入HTML文档的脚本语言。
这四种软件均为免费开源软件,组合到一起,成为一个免费、高效、扩展性强的网站服务系统。
架构图
处理流程:
1、用户通过浏览器输入域名请求Nginx Web服务,如果请求是静态资源,则由Nginx解析返回给用户;
2、如果是动态请求(.php结尾),那么Nginx就会把它通过FastCGI接口(生产常用方法)发送给PHP引擎服务(FastCGI进程php-fpm)进行解析
3、如果这个动态请求要读取数据库数据,那么PHP就会继续向后请求MySQL数据库,以读取需要的数据,并最终通过Nginx服务把获取的数据返回给用户。
在lnmp中关键性的就两点:
1.nginx接收客户端发来的请求后找到对应的执行脚本文件再用php-fpm来解释执行脚本文件并将结果返回给客户端
2.php通过php扩展pdo、mysql、或者mysqli来操作mysql数据库实现对数据的存储
CGI:
CGI的全称为“通用网关接口”(Common Gateway Interface),为web服务器与web应用程序通信的一种协议
传统CGI接口方式的主要缺点是性能较差,因为每次web服务器遇到动态程序时都需要重新启动解析器来执行解析,之后结果才会被返回给web服务器。这在处理高并发访问时几乎是不可用的,因此就诞生了FastCGI。另外,传统的CGI接口方式安全性也很差,现在已经很少被使用。
FastCGI:
FastCGI (Fast Common Gateway Interface)全称是“快速通用网关接口”,是一个可伸缩的,高速地在web server和脚本语言间交互的接口。FastCGI的主要优点是把动态语言和web server分离开来。这种技术允许把web server和动态语言运行在不同的主机上,以大规模扩展和改进安全性而不损失生产效率。具有如下特点:
- 可把动态语言解析和HTTP服务器分离开。
- Nginx,Apache,Lighttpd,以及多数动态语言都支持FastCGI。
- FastCGI接口方式采用C/S结构,分为客户端(HTTP服务器)和服务器端(动态语言解析服务器)
- PHP动态语言服务器端可以启动多个FastCGI的守护进程(例如php-fpm(fcgi process mangement))
- HTTP服务器通过(例如Nginx fastcgi_pass)FastCGI客户端和动态语言FastCGI服务器端通信(例如php-fpm)
PHP-FPM
PHP-FPM使用PHP编写的PHP-FastCGI管理器,是用于调度、管理PHP解析器php-cgi的管理程序。它负责管理一个进程池,处理来自Web服务器的请求。
早期的PHP-FPM是作为PHP源码的补丁而使用的,在PHP调的5.3.2版本中直接整合到了PHP-FPM分支,目前主流的PHP5.5,PHP5.6,PHP5.7已经集成了该功能(被官方收录),在配置时使用--enable-fpm参数即可开启PHP-FPM。
简要概括:
①CGI:是 Web Server 与 Web Application 之间数据交换的一种协议。
②FastCGI:同 CGI,是一种通信协议,但比 CGI 在效率上做了一些优化。同 样, SCGI 协议与 FastCGI 类似。
③PHP-CGI:是 PHP (Web Application)对 Web Server 提供的 CGI 协议的接口程序。
④PHP-FPM:是 PHP(Web Application)对 Web Server 提供的 FastCGI 协议的接口程序,额外还提供了相对智能一些任务管理。
⑤WEB 中,Web Server 一般指Apache、Nginx、IIS、Lighttpd、Tomcat等服务器。
⑥Web Application 一般指PHP、Java、Asp.net等应用程序。参考:
4、搭建步骤
1、安装mysql数据库
2、安装php,重点是线程池的配置文件
[wizard] #进程池的名字
listen = var/run/wizard.sock #指定监听的ip:port或者socket,一会在nginx的配置中会用到
user = nginx #指定php-fpm进程用户
group = nginx #指定php-fpm进程用户组
listen.owner = nginx #用户设置对socket的权限
listen.group = nginx
listen.backlog = -1
listen.mode = 0666
listen.allowed_clients = 127.0.0.1 #允许FastCGI客户端连接的IPV4地址
chdir = /www/wizard/public #设置启动目录,启动时会自动chdir到该目录,必须时绝对路径
pm = dynamic #选择进程池管理器如何控制字进程的数量
pm.max_children = 50 #同一时刻能够存活的最大子进程的数量
pm.start_servers = 2 #在启动时启动的子进程的数量
pm.min_spare_servers = 1 #最小空闲子进程数量
pm.max_spare_servers = 3 #最大空闲子进程数量
pm.max_requests = 500
参考:https://www.cnblogs.com/linuxk/p/10382178.html
3、nginx的配置文件
server {
listen 80;
server_name zhishiku.cslc.com;
#client_max_body_size 100m;
#charset koi8-r;
root /www/wizard/public;
index index.php;
#access_log logs/host.access.log main;
location / {
index index.php index.html index.htm;
try_files $uri $uri/ /index.php?$query_string;
}
location ~ .*\.(gif|jpg|png|bmp|swf|js|css)$ {
try_files $uri =302;
}
location ~ .*\.php$ {
# php-fpm 监听地址,这里用了socket方式
fastcgi_pass unix:/usr/local/php/var/run/wizard.sock;
fastcgi_param SCRIPT_FILENAME /www/wizard/public$fastcgi_script_name;
fastcgi_index index.php;
include fastcgi_params;
}
4、下载wizard项目,放置与路径/www/下,资源位置为/www/wizard/public。主要看下配置文件/www/wizard/.env,这个是知识库的配置
# 应用名称
APP_NAME="测试中心知识库"
# 环境,正式请使用 production
APP_ENV=production
APP_KEY=base64:9ZqHD9ABVYkfN1il53mBYAqN/ZqEeSvUz3zPt2z3KFM=
# 调试和日志级别
APP_DEBUG=false
APP_LOG_LEVEL=debug
# 应用服务地址
APP_URL=http://104.21.0.205
# 数据库连接配置
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=knowledgeroot
DB_USERNAME=cslc
DB_PASSWORD=cslc
BROADCAST_DRIVER=log
CACHE_DRIVER=file
SESSION_DRIVER=file
QUEUE_DRIVER=sync
# Redis 连接配置
REDIS_HOST=127.0.0.1
REDIS_PASSWORD=null
REDIS_PORT=6379
# 邮件服务器配置
MAIL_DRIVER=smtp
MAIL_HOST=172.16.0.22
MAIL_PORT=25
MAIL_USERNAME='uatsvn@cslc.com.cn'
MAIL_PASSWORD='pass@word123'
MAIL_ENCRYPTION=false
MAIL_FROM_NAME=测试中心
PUSHER_APP_ID=
PUSHER_APP_KEY=
PUSHER_APP_SECRET=
APP_TIMEZONE=Asia/Shanghai
# 评论功能
# 是否启用评论功能
WIZARD_REPLY_SUPPORT=true
# 默认主题,支持 default/dark
WIZARD_DEFAULT_THEME=default
# 表格文档配置
WIZARD_SPREEDSHEET_MAX_ROWS=100
WIZARD_SPREEDSHEET_MAX_COLS=26
# 用户帐号是否需要邮件激活
WIZARD_NEED_ACTIVATE=false
# 加密密钥
WIZARD_JWT_SECRET=5Dck4izVEXsP52AOcVxaFUsTzA8uwUiP
# 当前版本,目前的作用是刷新静态资源缓存
WIZARD_RESOURCE_VERSION=202103221014
# 是否启用 LDAP 登录
WIZARD_USE_LDAP=false
# 是否开启 LDAP 日志
LDAP_LOGGING=true
# LDAP 帐号前缀/后缀
LDAP_ACCOUNT_PREFIX=
LDAP_ACCOUNT_SUFFIX=
# LDAP 服务地址
LDAP_HOSTS=
LDAP_PORT=
# LDAP Base DN
LDAP_BASE_DN=
# LDAP 授权帐号
LDAP_USERNAME=
LDAP_PASSWORD=
# LDAP 连接安全配置
LDAP_USE_SSL=false
LDAP_USE_TLS=false
# 同步 LDAP 密码到本地
LDAP_PASSWORD_SYNC=true
# 如果 LDAP 登录失败,是否使用本地帐号密码登录
LDAP_LOGIN_FALLBACK=true
# LDAP 信息中,用哪个字段作为用户的名称,比如 displayname, cn 等
LDAP_SYNC_NAME_ATTR=cn
# LDAP 限制只允许属于该成员的用户登录
WIZARD_LDAP_ONLY_MEMBER_OF=
# 是否必须登录才能查看文档
WIZARD_MUST_LOGIN=yes
# 管理员公共页面是否展示所有项目
WIZARD_ADMIN_SEE_ALL=true
# 是否启用 CDN 加速
CDN_ENABLED=false
# CDN 服务器域名
CDN_URL=http://cdn.example.com
# 版本检查
WIZARD_VERSION_CHECK=false
# 是否自动添加 TOC/TOCM 标签到 Markdown 文档,可选值为空、TOC、TOCM,为空时不启用该功能
# 如果文档中包含手写的 TOC 和 TOCM,也不会自动添加
WIZARD_MARKDOWN_TOC_DEFAULT=TOCM
# 是否启用 Markdown 严格模式,默认为 true,如果你的文档存在兼容性问题,则可以修改此项
WIZARD_MARKDOWN_STRICT=true
# 是否启用邀请注册机制
# 启用后,用户注册时必须提供邀请码
WIZARD_REGISTER_INVITATION=false
# 静态邀请码,所有用户注册时必须提供此邀请码,邀请码对所有用户固定不变
WIZARD_REGISTER_INVITATION_STATIC=eb092be4a8970338c06a37900a7116f1
修改配置后使配置生效:php artisan config:cache