This commit is contained in:
gongfuxiang 2018-12-15 13:51:45 +08:00
parent 2995b258d2
commit 1e5645ce13
2 changed files with 145 additions and 134 deletions

View File

@ -1,32 +1,16 @@
ThinkPHP遵循Apache2开源协议发布并提供免费使用。
版权所有Copyright © 2006-2018 by ThinkPHP (http://thinkphp.cn)
ShopXO遵循Apache2开源协议发布并提供免费使用。
版权所有Copyright © 2006-2018 by ThinkPHP (http://shopxo.net)
All rights reserved。
ThinkPHP® 商标和著作权所有者为上海顶想信息科技有限公司。
Apache Licence是著名的非盈利开源组织Apache采用的协议。
该协议和BSD类似鼓励代码共享和尊重原作者的著作权
允许代码修改,再作为开源或商业软件发布。需要满足
的条件:
1 需要给代码的用户一份Apache Licence
2 如果你修改了代码,需要在被修改的文件中说明;
3 在延伸的代码中(修改和有源代码衍生的代码中)需要
带有原来代码中的协议,商标,专利声明和其他原来作者规
定需要包含的说明;
4 如果再发布的产品中包含一个Notice文件则在Notice文
件中需要带有本协议内容。你可以在Notice中增加自己的
许可但不可以表现为对Apache Licence构成更改。
具体的协议参考http://www.apache.org/licenses/LICENSE-2.0
Apache Licence是著名的非盈利开源组织Apache采用的协议
该协议和BSD类似鼓励代码共享和尊重原作者的著作权同样允许代码修改再作为开源或商业软件发布
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
需要满足的条件也和BSD类似
1.需要给代码的用户一份Apache Licence
2.如果你修改了代码,需要在被修改的文件中说明;
3.在延伸的代码中(修改和有源代码衍生的代码中)需要带有原来代码中的协议,商标,专利声明和其他原来作者规定需要包含的说明;
4.如果再发布的产品中包含一个Notice文件则在Notice文件中需要带有Apache icence
5.你可以在Notice中增加自己的许可但不可以表现为对Apache Licence构成更改
6.Apache Licence也是对商业应用友好的许可使用者也可以在需要的时候修改代码来满足需要并作为开源或商业产品发布/销售;
具体的协议参考http://www.apache.org/licenses/LICENSE-2.0.html

237
README.md
View File

@ -1,73 +1,47 @@
![](https://box.kancloud.cn/5a0aaa69a5ff42657b5c4715f3d49221)
# ShopXO 国内领先企业级B2C免费开源电商系统
* 求实进取、创新专注、自主研发、国内领先企业级B2C电商系统解决方案。
* 遵循Apache2开源协议发布并提供免费使用。
* PC+WAP、支付宝小程序、微信小程序、百度小程序。
ThinkPHP 5.1LTS版本 —— 12载初心你值得信赖的PHP框架
===============
# ------ 当前为开发版本 ------
[![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/top-think/framework/badges/quality-score.png?b=5.1)](https://scrutinizer-ci.com/g/top-think/framework/?branch=5.1)
[![Build Status](https://travis-ci.org/top-think/framework.svg?branch=master)](https://travis-ci.org/top-think/framework)
[![Total Downloads](https://poser.pugx.org/topthink/framework/downloads)](https://packagist.org/packages/topthink/framework)
[![Latest Stable Version](https://poser.pugx.org/topthink/framework/v/stable)](https://packagist.org/packages/topthink/framework)
[![PHP Version](https://img.shields.io/badge/php-%3E%3D5.6-8892BF.svg)](http://www.php.net/)
[![License](https://poser.pugx.org/topthink/framework/license)](https://packagist.org/packages/topthink/framework)
### 传送门
* 官网地址http://shopxo.net/
* 演示地址http://demo.shopxo.net/ (管理账户/密码可进入官网查看)
* 支付宝小程序http://shopxo.net/alipay.html
ThinkPHP5.1对底层架构做了进一步的改进,减少依赖,其主要特性包括:
### 官方QQ群
* 群号833531593
* 答案shopxo.net
+ 采用容器统一管理对象
+ 支持Facade
+ 注解路由支持
+ 路由跨域请求支持
+ 配置和路由目录独立
+ 取消系统常量
+ 助手函数增强
+ 类库别名机制
+ 增加条件查询
+ 改进查询机制
+ 配置采用二级
+ 依赖注入完善
+ 支持`PSR-3`日志规范
+ 中间件支持V5.1.6+
+ Swoole/Workerman支持V5.1.18+
### 源代码平台
* Githubhttps://github.com/gongfuxiang/shopxo
* 码云/开源中国https://gitee.com/gongfuxiang/shopxo
* 腾讯云开发者https://dev.tencent.com/u/gongfuxiang/p/shopxo/git
### 扩展性
* 支持多语言,独立模块式开发,完善的注释,易扩展。
> ThinkPHP5的运行环境要求PHP5.6以上。
### 安全性
* 防止sql注入代码高安全性。
## 安装
### 轻量级,高性能
* 支持多数据库,读写分离,高并发,内置缓存机制。
使用composer安装
# 后端基于ThinkPHP v3.2.3
ThinkPHP是一个快速、简单的基于MVC和面向对象的轻量级PHP开发框架遵循Apache2开源协议发布从诞生以来一直秉承简洁实用的设计原则在保持出色的性能和至简的代码的同时尤其注重开发体验和易用性并且拥有众多的原创功能和特性为WEB应用开发提供了强有力的支持。
~~~
composer create-project topthink/think tp
~~~
# 前端基于AmazeUI v2.7.2
##### 组件丰富,模块化
      以移动优先Mobile first为理念从小屏逐步扩展到大屏最终实现所有屏幕适配适应移动互联潮流。
##### 本地化支持
      相比国外框架Amaze UI 关注中文排版,根据用户代理调整字体,实现更好的中文排版效果;兼顾国内主流浏览器及 App 内置浏览器兼容支持。
##### 轻量级,高性能
      Amaze UI 面向 HTML5 开发,使用 CSS3 来做动画交互,平滑、高效,更适合移动设备,让 Web 应用更快速载入。
启动服务
~~~
cd tp
php think run
~~~
然后就可以在浏览器中访问
~~~
http://localhost:8000
~~~
更新框架
~~~
composer update topthink/framework
~~~
## 在线手册
+ [完全开发手册](https://www.kancloud.cn/manual/thinkphp5_1/content)
+ [升级指导](https://www.kancloud.cn/manual/thinkphp5_1/354155)
## 目录结构
初始的目录结构如下:
~~~
# 项目结构
```
shopxo
www WEB部署目录或者子目录
├─application 应用目录
│ ├─common 公共模块目录(可以更改)
@ -128,53 +102,106 @@ www WEB部署目录或者子目录
├─LICENSE.txt 授权说明文件
├─README.md README 文件
├─think 命令行入口文件
~~~
```
> 可以使用php自带webserver快速测试
> 切换到根目录后启动命令php think run
# 功能简介
### 后端功能列表
```
后端配置
站点配置
> 站点设置
> 短信设置
> 邮箱设置
> SEO设置
权限控制
> 管理员
> 角色管理
> 权限分配
用户管理
> 用户管理
商品管理
> 商品管理
> 商品分类
订单管理
> 订单管理
问答留言
> 问答留言
网站管理
> 导航管理
> 自定义页面
> 友情链接
> 主题管理
> 首页轮播
> 筛选价格
品牌管理
> 品牌管理
> 品牌分类
手机端管理
> 基础配置
> 首页导航
> 轮播管理
支付宝小程序
> 基础配置
> 小程序源码包
支付宝生活号
> 生活号管理
> 生活号分类
> 消息管理
> 菜单管理
> 批量上下架
> 用户管理
文章管理
> 文章管理
> 文章分类
数据管理
> 消息管理
> 支付日志
> 用户积分日志
资源管理
> 地区管理
> 快递管理
> 支付方式
工具
> 缓存管理
```
## 命名规范
### 前端
```
首页
所有分类
商品搜索
商品详情
自定义页面
文章
购物车
订单确认页
用户中心
> 聚合内容
交易管理
> 订单管理
> 订单详情
> 评论页
> 我的收藏
资料管理
> 个人资料
> 我的地址
> 安全设置
> 我的消息
> 我的积分
> 我的足迹
> 安全退出
```
`ThinkPHP5`遵循PSR-2命名规范和PSR-4自动加载规范并且注意如下规范
# 如何贡献
非常欢迎您对ShopXO的开发作出贡献
你可以选择以下方式向ShopXO贡献
- [Github - 发布issue进行问题反馈和建议](https://github.com/gongfuxiang/shopxo/pulls)
- [码云/开源中国 - 发布issue进行问题反馈和建议](https://gitee.com/gongfuxiang/shopxo/pulls)
- 通过Pull Request提交修复
- 完善我们的文档和例子
### 目录和文件
# 开源协议
Apache License Version 2.0 see http://www.apache.org/licenses/LICENSE-2.0.html
* 目录不强制规范,驼峰和小写+下划线模式均支持;
* 类库、函数文件统一以`.php`为后缀;
* 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致;
* 类名和类文件名保持一致,统一采用驼峰法命名(首字母大写);
### 函数和类、属性命名
* 类的命名采用驼峰法,并且首字母大写,例如 `User`、`UserType`,默认不需要添加后缀,例如`UserController`应该直接命名为`User`
* 函数的命名使用小写字母和下划线(小写字母开头)的方式,例如 `get_client_ip`
* 方法的命名使用驼峰法,并且首字母小写,例如 `getUserName`
* 属性的命名使用驼峰法,并且首字母小写,例如 `tableName`、`instance`
* 以双下划线“__”打头的函数或方法作为魔法方法例如 `__call``__autoload`
### 常量和配置
* 常量以大写字母和下划线命名,例如 `APP_PATH``THINK_PATH`
* 配置参数以小写字母和下划线命名,例如 `url_route_on` 和`url_convert`
### 数据表和字段
* 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如 `think_user` 表和 `user_name`字段,不建议使用驼峰和中文作为数据表字段命名。
## 参与开发
请参阅 [ThinkPHP5 核心框架包](https://github.com/top-think/framework)。
## 版权信息
ThinkPHP遵循Apache2开源协议发布并提供免费使用。
本项目包含的第三方源码和二进制文件之版权信息另行标注。
版权所有Copyright © 2006-2018 by ThinkPHP (http://thinkphp.cn)
All rights reserved。
ThinkPHP® 商标和著作权所有者为上海顶想信息科技有限公司。
更多细节参阅 [LICENSE.txt](LICENSE.txt)
# 更新日志
更多细节参阅 <a href="changelog.txt">changelog.txt</a>