ThinkPHP 5.0_PLus

框架说明

此框架在thinkphp5.0基础上修改,开发需遵循官方规范,开发不规范,同事俩行泪。

开发目录说明

application为应用目录

application/api为接口目录

application/common为公共类目录

#####静态类目录 application/common/logic 静态类目录

application/common/AuthManager.php 自动续期授权类

application/common/CacheManager.php 编码生成缓存类

application/common/LogManager.php Log日志生成缓存类

application/common/TokenManager.php refresh_token刷新类

#####工具类目录

application/common/util

application/common/util/ApiExceptionHandle.php Api异常处理工具类

application/common/util/ErrCode.php 错误代码工具类

#####公共基类(接口开发必须继承)

application/common/AuthApi.php 权限基类 自动续期版本 必须继承

application/common/Base.php 接口基类 必须继承

application/common/Replay.php 防止接口重放类 必须继承

application/common/RestfulApi.php Restful接口类 用于快速生成restful接口 必须继承

application/common/Token.php 权限基类 自动续期版本 必须继承

接口开发规范

• api目录下为api接口模块
• api目录下common目录为api公共接口目录 所有公共接口需要写到此处
• api目录下要单独建立业务逻辑模块文件夹
• 业务逻辑模块下Api结尾的为模块基类,其他业务开发必须继承,业务控制器命名不必加Api结尾
• 生成token时一定要注意模块基类tokenType 一定要设置不一样,防止token互用
• restful 基类为快速生成接口所用,具体用法查看restful类 ,

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

目录结构

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为后缀；
• 类的文件名均以命名空间定义，并且命名空间的路径和类库文件所在路径一致；
• 类名和类文件名保持一致，统一采用驼峰法命名（首字母大写）；

函数和类、属性命名

• 类的命名采用驼峰法，并且首字母大写，例如 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字段，不建议使用驼峰和中文作为数据表字段命名。