Skip to content
This repository has been archived by the owner on May 2, 2020. It is now read-only.

cs1504/museum-backstage

Repository files navigation

后台管理子系统

用到的工具及说明

thinkPHP5 https://www.kancloud.cn/manual/thinkphp5/118003

jieba 中文分词 https://github.com/fxsjy/jieba https://github.com/fukuball/jieba-php

七牛云 https://developer.qiniu.com/kodo/sdk/1236/android https://developer.qiniu.com/kodo/sdk/1241/php

https://lnmp.org/faq/lnmp-vhost-add-howto.html

Api

测试 api 可以使用 postman ,postman 是一个跨平台的 post|get 检测软件,很方便

需要什么 API 直接跟我说,我尽快写,尽快完善。

网址改成 http://39.106.168.133:8080/

接口名称 请求方法 url
获取博物馆信息 GET /api/museum/:id
搜索博物馆 GET /api/museum/search/
获取最近的博物馆 GET /api/museum/nearest
获取展览信息 GET /api/exhibition/:id
搜索展览 GET /api/exhibition/search/
获取展品信息 GET /api/exhibits/:id
搜索展品 GET /api/exhibits/search/
管理员登录 POST /api/admin/login/
管理员注册 POST /api/admin/reg/
管理员注销 GET /api/admin/logout
获取管理员用户信息 POST /api/admin/getinfo
用户登录 POST /api/user/login/
用户注册 POST /api/user/reg/
用户注销 GET /api/user/logout
获取用户信息 POST /api/user/getinfo
设置用户信息 POST api/user/updateinfo
获取新闻 GET /api/news/:id
搜索新闻 GET /api/news/search/
获取最新新闻 GET /api/news/latest/
获取音频信息 GET /api/audio/:id
某个用户的音频 GET /api/audiobyuser/:userid
搜索音频 GET /api/audio/search
获取七牛云上传token POST /api/getqiniutoken
添加音频 POST /api/audio/add
获取某条评论消息 GET /api/comment/:id
修改某条评论 PUT /api/comment/:id
删除某条评论 DELETE /api/comment/:id
发布新的评论 POST /api/comments/
给博物馆打分 POST /api/star/
获取博物馆分数及评论总数 GET /api/getstar/
评论并且打分 POST /api/commentandstar
获取评论和打分 GET /api/getcommentandstar
获取某一评论和打分 GET /api/getcommentandstar/:id

获取博物馆信息

GET http://39.106.168.133:8080/api/museum/:id

返回

{
    "id": 2,
    "name": "测试中国国家博物馆",
    "introduce": "这是测试数据",
    "open_time": "8:00-20:00",
    "edu_activity": null,
    "collection": null,
    "academic": null,
    "lng": null,
    "lat": null
}

搜索博物馆

GET http://39.106.168.133:8080/api/museum/search/

待完善

参数 意义 备注
name 搜索关键字 必填

返回

[
    {
        "id": 1,
        "name": "测试中国国家博物馆1",
        "introduce": "这是测试数据",
        "open_time": "这是测试数据8:00-20:00",
        "edu_activity": "",
        "collection": "",
        "academic": "",
        "lng": 0,
        "lat": 0
    },
    {
        "id": 2,
        "name": "测试中国国家博物馆",
        "introduce": "这是测试数据",
        "open_time": "8:00-20:00",
        "edu_activity": null,
        "collection": null,
        "academic": null,
        "lng": null,
        "lat": null
    }
]

获取最近的博物馆

GET http://39.106.168.133:8080/api/museum/nearest
参数 意义 备注
lng 经度 必填
lat 纬度 必填
page 页码 非必填,默认返回最近的十家

获取展览信息

GET http://39.106.168.133:8080/api/exhibition/:id

搜索展览

GET http://39.106.168.133:8080/api/exhibition/search/

待完善

参数 意义 备注
name 搜索关键字 必填

获取展品信息

GET http://39.106.168.133:8080/api/exhibits/:id

id 为博物馆 ID

搜索展品

GET http://39.106.168.133:8080/api/exhibits/search/

待完善

参数 意义 备注
name 搜索关键字 必填
page 分页 选填

管理员登录

测试账号 admin 密码 123456

POST http://39.106.168.133:8080/api/admin/login/
参数 意义 备注
loginname 登录名 必填
password 密码 必填

返回值

{
    "valid": 1,
    "msg": "登录成功"
}

管理员注册

POST http://39.106.168.133:8080/api/admin/reg/
参数 意义 备注
loginname 登录名 必填
password 密码 必填
role 角色 规定1为普通管理员,0为超级管理员

管理员注销

GET http://39.106.168.133:8080/api/admin/logout/

获取管理员用户信息

POST http://39.106.168.133:8080/api/admin/getinfo
参数 意义 备注
id 用户id 必填

用户登录

测试账号 user001 密码 123456

POST http://39.106.168.133:8080/api/user/login/
参数 意义 备注
loginname 登录名 必填
password 密码 必填

返回值

{
    "valid": 1,
    "msg": "登录成功"
}

用户注册

POST http://39.106.168.133:8080/api/user/reg/
参数 意义 备注
loginname 登录名 必填
password 密码 必填

用户注销

GET http://39.106.168.133:8080/api/user/logout/

获取用户信息

POST http://39.106.168.133:8080/api/user/getinfo

设置用户信息

POST http://39.106.168.133:8080/api/user/updateinfo
参数 意义 备注
id 用户 id 必填
password 密码 必填
sex 性别 1男2女
nickname 昵称 选填
phone 手机 选填
email 邮箱 选填
wechat 微信 选填
qq QQ 选填
avatar image file 选填
intro 介绍 选填

avatar 为相对地址 需在前面加 http://39.106.168.133:8080/

例如 http://39.106.168.133:8080/static/upload/avatar/15234315276.png

获取新闻

POST http://39.106.168.133:8080/api/news/:id

返回

{
    "id": 1,
    "title": "浙江良渚古城遗址申遗 博物馆迎参观热",
    "author": "浙江新闻网",
    "release_time": "2018-01-31 00:00:00",
    "modify_time": null,
    "excerpt": "图为:浙江博物馆展出的镇馆之宝——“良渚玉琮王”。 王远 摄 中新网浙江新闻1月31日电(见习记者 王远)近日,中国联合国教科文组织全国委员会秘书处致函联合国 ",
    "content": null,
    "status": 0,
    "nature": null,
    "comment_status": 0,
    "url": null
}

搜索新闻

GET http://39.106.168.133:8080/api/news/search/
参数 意义 备注
title 按 title 搜索 非必填
key 按关键字搜索,包括 title excerpt content 非必填
page 分页的第 n 页 非必填,默认返回第一页(前10条数据)

获取最新新闻

GET http://39.106.168.133:8080/api/news/latest/
参数 意义 备注
page 分页的第 n 页 非必填,默认返回第一页(前10条数据)

获取音频信息

GET http://39.106.168.133:8080/api/audio/:id

返回

{
    "id": 1,
    "user_id": 1,
    "musemu_id": 1,
    "status": 0,
    "upload_time": "2018-03-18 10:50:30",
    "pass_time": null,
    "addr": "http://p4buh8sqx.bkt.clouddn.com/%E8%B5%B5%E9%9B%B7-%E6%88%90%E9%83%BD%20%28Live%29.mp3",
    "description": "测试数据,这里放了一首歌的链接",
    "totext": null
}

某个用户的音频

GET http://39.106.168.133:8080/api/audiobyuser/:userid

搜索音频

GET http://39.106.168.133:8080/api/audio/search

待完善

参数 意义 备注
description 按 description 搜索 必填

获取七牛云上传token

POST http://39.106.168.133:8080/api/getqiniutoken

返回 url 前缀,url 前缀加文件名即为文件的完整 url

添加音频

POST http://39.106.168.133:8080/api/audio/add
参数 意义 备注
user_id 用户 ID 必填
museum_id 博物馆 ID 必填
addr 音频地址 必填
description 描述 必填

注意!!!下面的评论前两个 url 是 comment/:id 第三个是 comments

获取某条评论消息

GET http://39.106.168.133:8080/api/comments/:id

获取博物馆、展览、新闻、音频对应的评论

GET http://39.106.168.133:8080/api/comments/museum/:id
GET http://39.106.168.133:8080/api/comments/exhibition/:id
GET http://39.106.168.133:8080/api/comments/new/:id
GET http://39.106.168.133:8080/api/comments/audio/:id
参数 意义 备注
page 分页 选填

修改某条评论

PUT http://39.106.168.133:8080/api/comments/:id
参数 意义 备注
id 评论 id 必填
content 评论正文 10-140字 必填

删除某条评论

DELETE http://39.106.168.133:8080/api/comments/:id

发布新的评论

POST http://39.106.168.133:8080/api/comments
参数 意义 备注
coption 评论种类,博物馆1,展览2,新闻3,音频4 必填
museum_id 若coption=1,则必填 四个里填一个
exhibition_id 若coption=2 则必填 四个里填一个
news_id 若 coption=3 则必填 四个里填一个
audip_id 若 coption=4 则必填 四个里填一个
user_id 用户 id 必填
content 10 - 140 字的评论 必填

给博物馆打分

POST http://39.106.168.133:8080/api/star
参数 意义 备注
user_id 用户id 必填
museum_id 博物馆id 必填
comment_id 评论id 选填
exhibition_star 展览分数 必填1-5的数字
service_star 服务分数 必填1-5的数字
environment_star 环境分数 必填1-5的数字

获取博物馆分数及评论总数

GET http://39.106.168.133:8080/api/getstar:id

id为博物馆 id

参数 意义 备注
user_id 用户id 如果带了这个参数,返回的是该用户对这个博物馆的评分,如果不带这个参数,返回的是博物馆的平均分

isuser 是个布尔值,说明是不是带了 user_id 参数。

返回值:

{
    "isuser": false,
    "exhibition_star": 4,
    "service_star": 5,
    "environment_star": 3,
    "avg": 3.6666666666667,
    "comment_count": 2
}

评论并且打分

POST  http://39.106.168.133:8080/api/commentandstar
参数 意义 备注
coption 博物馆评论 填写 1
user_id 用户 id
content 评论内容 10-140字符
museum_id 博物馆 ID
exhibition_star 展览分数 必填1-5的数字
service_star 服务分数 必填1-5的数字
environment_star 环境分数 必填1-5的数字

成功的返回值

{
    "valid": 1,
    "comment_id": "7",
    "msg": "评论成功"
}

获取评论和打分

GET  http://39.106.168.133:8080/api/getcommentandstar

默认返回前十条

参数 意义 备注
page 分页 选填

获取某一评论和打分

GET | http://39.106.168.133:8080/api/getcommentandstar/:id
参数 意义 备注
id 评论id 必填

Nginx 配置文件

server
	{
		listen 80;
		server_name www.csmuseum.xyz ;
		index index.html index.htm index.php default.html default.htm default.php;
		root  /home/wwwroot/www.csmuseum.xyz/think/public;

		location / {
        		try_files $uri $uri/ /index.php?s=$uri&$args;
    		}	

		location ~ .+.php($|/) {
			set $script $uri;
			set $path_info "/";
			if ($uri ~ "^(.+.php)(/.+)") {
				set $script $1;
				set $path_info $2;
			}

			fastcgi_pass  unix:/tmp/php-cgi.sock;
			fastcgi_index index.php?IF_REWRITE=1;
			include fastcgi.conf;
			fastcgi_param PHP_VALUE "open_basedir=/home/wwwroot/default/tp5/public/:/tmp/:/proc/";
			fastcgi_param PATH_INFO $path_info;
			fastcgi_param SCRIPT_FILENAME $root$fastcgi_script_name;
			include fastcgi_params;
		}


		include none.conf;
		#error_page   404   /404.html;

		include enable-php.conf;

		location ~ .*\.(gif|jpg|jpeg|png|bmp|swf)$
		{
			expires      30d;
		}

		location ~ .*\.(js|css)?$
		{
			expires      12h;
		}

		location ~ /.well-known {
			allow all;
		}

		location ~ /\.
		{
			deny all;
		}

		access_log off;
	}

=================== 华丽的分割线,以下是 ThinkPHP 5.0 的 README ===================

ThinkPHP 5.0

Total Downloads Latest Stable Version Latest Unstable Version License

ThinkPHP5在保持快速开发和大道至简的核心理念不变的同时,PHP版本要求提升到5.4,对已有的CBD模式做了更深的强化,优化核心,减少依赖,基于全新的架构思想和命名空间实现,是ThinkPHP突破原有框架思路的颠覆之作,其主要特性包括:

  • 基于命名空间和众多PHP新特性
  • 核心功能组件化
  • 强化路由功能
  • 更灵活的控制器
  • 重构的模型和数据库类
  • 配置文件可分离
  • 重写的自动验证和完成
  • 简化扩展机制
  • API支持完善
  • 改进的Log类
  • 命令行访问支持
  • REST支持
  • 引导文件支持
  • 方便的自动生成定义
  • 真正惰性加载
  • 分布式环境支持
  • 更多的社交类库

ThinkPHP5的运行环境要求PHP5.4以上。

详细开发文档参考 ThinkPHP5完全开发手册

目录结构

初始的目录结构如下:

www  WEB部署目录(或者子目录)
├─application           应用目录
│  ├─common             公共模块目录(可以更改)
│  ├─module_name        模块目录
│  │  ├─config.php      模块配置文件
│  │  ├─common.php      模块函数文件
│  │  ├─controller      控制器目录
│  │  ├─model           模型目录
│  │  ├─view            视图目录
│  │  └─ ...            更多类库目录
│  │
│  ├─command.php        命令行工具配置文件
│  ├─common.php         公共函数文件
│  ├─config.php         公共配置文件
│  ├─route.php          路由配置文件
│  ├─tags.php           应用行为扩展定义文件
│  └─database.php       数据库配置文件
│
├─public                WEB目录(对外访问目录)
│  ├─index.php          入口文件
│  ├─router.php         快速测试文件
│  └─.htaccess          用于apache的重写
│
├─thinkphp              框架系统目录
│  ├─lang               语言文件目录
│  ├─library            框架类库目录
│  │  ├─think           Think类库包目录
│  │  └─traits          系统Trait目录
│  │
│  ├─tpl                系统模板目录
│  ├─base.php           基础定义文件
│  ├─console.php        控制台入口文件
│  ├─convention.php     框架惯例配置文件
│  ├─helper.php         助手函数文件
│  ├─phpunit.xml        phpunit配置文件
│  └─start.php          框架入口文件
│
├─extend                扩展类库目录
├─runtime               应用的运行时目录(可写,可定制)
├─vendor                第三方类库目录(Composer依赖库)
├─build.php             自动生成定义文件(参考)
├─composer.json         composer 定义文件
├─LICENSE.txt           授权说明文件
├─README.md             README 文件
├─think                 命令行入口文件

router.php用于php自带webserver支持,可用于快速测试 切换到public目录后,启动命令:php -S localhost:8888 router.php 上面的目录结构和名称是可以改变的,这取决于你的入口文件和配置参数。

命名规范

ThinkPHP5遵循PSR-2命名规范和PSR-4自动加载规范,并且注意如下规范:

目录和文件

  • 目录不强制规范,驼峰和小写+下划线模式均支持;
  • 类库、函数文件统一以.php为后缀;
  • 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致;
  • 类名和类文件名保持一致,统一采用驼峰法命名(首字母大写);

函数和类、属性命名

  • 类的命名采用驼峰法,并且首字母大写,例如 UserUserType,默认不需要添加后缀,例如UserController应该直接命名为User
  • 函数的命名使用小写字母和下划线(小写字母开头)的方式,例如 get_client_ip
  • 方法的命名使用驼峰法,并且首字母小写,例如 getUserName
  • 属性的命名使用驼峰法,并且首字母小写,例如 tableNameinstance
  • 以双下划线“__”打头的函数或方法作为魔法方法,例如 __call__autoload

常量和配置

  • 常量以大写字母和下划线命名,例如 APP_PATHTHINK_PATH
  • 配置参数以小写字母和下划线命名,例如 url_route_onurl_convert

数据表和字段

  • 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如 think_user 表和 user_name字段,不建议使用驼峰和中文作为数据表字段命名。

参与开发

请参阅 ThinkPHP5 核心框架包

版权信息

ThinkPHP遵循Apache2开源协议发布,并提供免费使用。

本项目包含的第三方源码和二进制文件之版权信息另行标注。

版权所有Copyright © 2006-2017 by ThinkPHP (http://thinkphp.cn)

All rights reserved。

ThinkPHP® 商标和著作权所有者为上海顶想信息科技有限公司。

更多细节参阅 LICENSE.txt