2021-08-26

wizard知识库系统搭建

1、项目位置

https://github.com/mylxsw/wizard

简要介绍:Wizard是一款开源文档管理系统,目前支持三种类型的文档管理:Markdown,Swager,Table。主要功能有文档版本管理、用户权限管理、项目分组管理、文档搜索、分享、评论等。

2、软件列表 

软件列表版本号
MySQL5.7.33
PHP7.2.3
Nginx1.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等应用程序。

参考:

1、关于CGI和FastCGI的理解 - 天生帅才 - 博客园 (cnblogs.com)

2、CGI、FastCGI和PHP-FPM区别和关系详解(包含图解)_ssiyla的博客-CSDN博客

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

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值