sina-video

注意事项

• 项目测试需要自行搭建环境导入数据库( admin_v6.sql )并修改配置( config/database.php )；
• 若操作提示“演示系统禁止操作”等字样，需要删除演示路由配置( app/admin/route/demo.php )或清空路由文件；
• 当前版本使用 ThinkPHP 6.0.x，对 PHP 版本标注不低于 PHP 7.1，具体请阅读 ThinkPHP 官方文档；
• 环境需开启 PATHINFO，不再支持 ThinkPHP 的 URL 兼容模式运行（源于如何优雅地展示）；
• 项目默认不带composer模块vendor目录，下载后需要自行composer install安装；

生产服务器部署

环境要求

• PHP7.1+
• Mysql5.7+
• Redis3.2+
• nginx 1.18+

部署步骤

• 1、新建网站根目录，例：/var/www/html
• 2、解压代码到该目录
• 3、拷贝目录下的.example.env 文件为.env，即：cp .example.env .env
• 4、修改.env 里面的数据库，redis，微博 API 接口相关配置，特别注意将 APP_DEBUG 设置成 false
• 5、在目录下创建 runtime 目录，并给网站运行用户，即 php-fpm 用户写权限

• 6、配置 nginx , https 相关配置请自行参考 nginx 相关教程，或者在 LVS 负载均衡层配置 vhost 参考配置：

  log_format logid '[$time_local] "$host" "$http_x_real_ip" "$http_x_forwarded_for" "$remote_addr" "$remote_user" "$request" "$request_time" "$request_length" "$body_bytes_sent" "$status" '
                      '"$server_addr" "$upstream_addr" "$upstream_response_time" "$upstream_status" "$http_referer" "$http_user_agent" "logId=$temp_request_id"';
  server {
  server_name www.weibo.cn;
  listen 80;
  root /var/www/html/public;
  index index.php index.html index.htm;
  
  set $temp_request_id $http_x_request_id;
  if ($temp_request_id = "") {
      set $temp_request_id $request_id;
  }
  access_log /var/log/access.log logid;
  
  location / {
      if (!-e $request_filename) {
          rewrite  ^(.*)$  /index.php?s=$1  last;
          break;
      }
  }
  
  location ~ ^/(composer.json|composer.lock|ThinkPHP/|vendor/|src/|bin/|App/|.git) {
      deny all;
  }
  location ~ \.php$ {
      fastcgi_pass 127.0.0.1:9000;
      fastcgi_index index.php;
      include fastcgi_params;
      fastcgi_param HTTP_X_REQUEST_ID $temp_request_id;
  }
  }
  

fastcgi_params 配置参考：

fastcgi_param  QUERY_STRING       $query_string;
fastcgi_param  REQUEST_METHOD     $request_method;
fastcgi_param  CONTENT_TYPE       $content_type;
fastcgi_param  CONTENT_LENGTH     $content_length;

fastcgi_param  SCRIPT_NAME        $fastcgi_script_name;
fastcgi_param  REQUEST_URI        $request_uri;
fastcgi_param  DOCUMENT_URI       $document_uri;
fastcgi_param  DOCUMENT_ROOT      $document_root;
fastcgi_param  SERVER_PROTOCOL    $server_protocol;
fastcgi_param  REQUEST_SCHEME     $scheme;
fastcgi_param  HTTPS              $https if_not_empty;

fastcgi_param  GATEWAY_INTERFACE  CGI/1.1;
fastcgi_param  SERVER_SOFTWARE    nginx/$nginx_version;

fastcgi_param  REMOTE_ADDR        $remote_addr;
fastcgi_param  REMOTE_PORT        $remote_port;
fastcgi_param  SERVER_ADDR        $server_addr;
fastcgi_param  SERVER_PORT        $server_port;
fastcgi_param  SERVER_NAME        $server_name;

# PHP only, required if PHP was built with --enable-force-cgi-redirect
fastcgi_param  REDIRECT_STATUS    200;
fastcgi_split_path_info ^(.+\.php)(/.+)$; #增加这一句
fastcgi_param PATH_INFO $fastcgi_path_info; #增加这一句
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;

• 7、配置 fpm 配置参考：

  [www]
  user = www-data
  group = www-data
  
  ; listen = /var/run/php7-fpm.sock
  listen = 127.0.0.1:9000
  listen.owner = www-data
  listen.group = www-data
  
  pm = static
  pm.max_children = 32
  pm.start_servers = 32
  pm.min_spare_servers = 32
  pm.max_spare_servers = 32
  pm.max_requests = 20000
  request_terminate_timeout = 10
  rlimit_files=1048576
  
  pm.status_path = /status
  ;FPM状态页面的网址. 如果没有设置, 则无法访问状态页面. 默认值: none. munin监控会使用到
  
  ping.path = /ping
  ;FPM监控页面的ping网址. 如果没有设置, 则无法访问ping页面. 该页面用于外部检测FPM是否存活并且可以响应请求. 请注意必须以斜线开头 (/)。
  
  ping.response = pong
  ;#用于定义ping请求的返回相应. 返回为 HTTP 200 的 text/plain 格式文本. 默认值: pong.
  
  chroot =
  ;#启动时的Chroot目录. 所定义的目录需要是绝对路径. 如果没有设置, 则chroot不被使用.
  
  chdir =
  ;#设置启动目录，启动时会自动Chdir到该目录. 所定义的目录需要是绝对路径. 默认值: 当前目录，或者/目录（chroot时）
  
  catch_workers_output = yes
  ;#重定向运行过程中的stdout和stderr到主要的错误日志文件中. 如果没有设置, stdout 和 stderr 将会根据FastCGI的规则被重定向到 /dev/null . 默认值: 空
  
  php_admin_value[memory_limit] = 64M
  
  env[ENV] = prod
  

• 8、导入根目录下的 sql.sql 文件

注解权限

注解权限是指通过方法注释来实现后台 RBAC 授权管理，用注解来管理功能节点。

开发人员只需要写好注释，RBAC 的节点会自动生成，只需要配置角色及用户就可以使用 RBAC 权限。

• 此版本的权限使用注解实现
• 注释必需使用标准的块注释，如下案例
• 其中@auth true表示访问需要权限验证
• 其中@menu true显示在菜单编辑的节点可选项

• 其中@login true需要强制登录才可访问

  /**
  * 操作的名称
  * @auth true  # 表示需要验证权限
  * @menu true  # 在菜单编辑的节点可选项
  * @login true # 需要强制登录可访问
  */
  public function index(){
  // @todo
  }
  

框架指令

• 执行 build.cmd 可更新 composer 插件，会删除并替换 vendor 目录
• 执行 php think run 启用本地开发环境，访问 http://127.0.0.1:8000
• 执行 php think xadmin:fansall 同步微信粉丝数据（依赖于 wechat 模块）
• 执行 php think xadmin:version 查看当前版本号，显示 ThinkPHP 版本及 ThinkLibrary 版本

1. 线上代码更新

• 执行 php think xadmin:install admin 从线上服务更新 admin 模块的所有文件（注意文件安全）
• 执行 php think xadmin:install wechat 从线上服务更新 wechat 模块的所有文件（注意文件安全）
• 执行 php think xadmin:install static 从线上服务更新 static 静态资料文件（注意文件安全）
• 执行 php think xadmin:install config 从线上服务更新 config 常用配置文件（注意文件安全）

2. 守护进程管理（可自建定时任务去守护监听主进程）

• 执行 php think xadmin:queue listen [监听]启动异步任务监听服务
• 执行 php think xadmin:queue start [控制]检查创建任务监听服务（建议定时任务执行）
• 执行 php think xadmin:queue query [控制]查询当前任务相关的进程
• 执行 php think xadmin:queue status [控制]查看异步任务监听状态
• 执行 php think xadmin:queue stop [控制]平滑停止所有任务进程

3. 本地调试管理（可自建定时任务去守护监听主进程）

• 执行 php think xadmin:queue webstop [调试]停止本地调试服务
• 执行 php think xadmin:queue webstart [调试]开启本地调试服务（建议定时任务执行）
• 执行 php think xadmin:queue webstatus [调试]查看本地调试状态