ThinkPHP5在保持快速开发和大道至简的核心理念不变的同时,PHP版本要求提升到5.4,对已有的CBD模式做了更深的强化,优化核心,减少依赖,基于全新的架构**和命名空间实现,是ThinkPHP突破原有框架思路的颠覆之作,其主要特性包括:
- 基于命名空间和众多PHP新特性
- 核心功能组件化
- 强化路由功能
- 更灵活的控制器
- 配置文件可分离
- 简化扩展机制
- API支持完善
- 整合SocketLog用于支持远程调试
- 命令行访问支持
- REST支持
- 引导文件支持
- 方便的自动生成定义
- 真正惰性加载
- 分布式环境支持
- 更多的社交类库
ThinkPHP5的运行环境要求PHP5.4以上,目前处于开发测试阶段,不排除正式发布之前有所调整, 请谨慎用于实际项目 ^_^。
详细开发文档参考 ThinkPHP5开发手册
初始的目录结构如下:
www WEB部署目录(或者子目录)
├─composer.json composer定义文件
├─README.md README文件
├─LICENSE.txt 授权说明文件
├─application 应用目录
│ ├─common 公共模块目录(可以更改)
│ ├─runtime 应用的运行时目录(可写,可定制)
│ ├─module 模块目录
│ │ ├─config.php 模块配置文件
│ │ ├─common.php 模块函数文件
│ │ ├─controller 控制器目录
│ │ ├─model 模型目录
│ │ ├─view 视图目录
│ │ ├─ ... 更多类库目录
│ ├─common.php 公共函数文件
│ ├─route.php 路由配置文件
│ ├─database.php 数据库配置文件
│ └─config.php 公共配置文件
├─public WEB目录(对外访问目录)
│ ├─index.php 入口文件
│ ├─.htaccess 用于apache的重写
│ └─router.php 快速测试文件
├─thinkphp 框架系统目录
│ ├─library 框架类库目录
│ │ ├─behavior 行为类库目录
│ │ ├─com Com类库包目录
│ │ ├─think Think类库包目录
│ │ ├─org Org类库包目录
│ │ ├─ ... 更多类库目录
│ ├─traits 系统Traits目录
│ ├─vendor 第三方类库目录
│ ├─mode 应用模式目录
│ ├─tpl 系统模板目录
│ ├─base.php 基础文件
│ ├─convention.php 框架惯例配置文件
│ └─start.php 框架入口文件
router.php用于php自带webserver支持,可用于快速测试 启动命令:php -S localhost:8888 -t . router.php 上面的目录结构和名称是可以改变的,这取决于你的入口文件和配置参数。
ThinkPHP5的命名规范如下:
- 目录和文件名采用小写+下划线,并且以小写字母开头;
- 类库、函数文件统一以
.php
为后缀; - 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致;
- 类的命名采用驼峰法,并且首字母大写,例如
User
、UserType
,不需要添加后缀,例如UserController应该直接命名为User; - 函数的命名使用小写字母和下划线(小写字母开头)的方式,例如
get_client_ip
; - 方法的命名使用驼峰法,并且首字母小写或者使用下划线“_”,例如
getUserName
,_parseType
,通常下划线开头的方法属于私有方法; - 属性的命名使用驼峰法,并且首字母小写或者使用下划线“_”,例如
tableName
、_instance
,通常下划线开头的属性属于私有属性; - 以双下划线“__”打头的函数或方法作为魔法方法,例如
__call
和__autoload
;
- 常量以大写字母和下划线命名,例如
APP_DEBUG
和APP_MODE
; - 配置参数以小写字母和下划线命名,例如
url_route_on
;
- 数据表和字段采用小写加下划线方式命名,并注意字段名不要以下划线开头,例如 think_user 表和 user_name字段,类似 _username 这样的数据表字段可能会被过滤。
在ThinkPHP5.0中实例化一个类,可以采用:
\Think\Route
或者\think\Route
都是有效的,并且都是加载think\route.php
文件,如果实例化一个
\Org\UploadFile
类的话会自动加载
org\upload_file.php
文件。
注册并登录 Github 帐号, fork 本项目并进行改动。
修改流程:
- fork本项目;
- 克隆(clone)你 fork 的项目到本地;
- 新建分支(branch)并检出(checkout)新分支;
- 添加本项目到你的本地 git 仓库作为上游(upstream);
- 进行修改,若你的修改包含方法或函数的增减,请记得修改单元测试文件;
- 变基(衍合 rebase)你的分支到上游 master 分支;
- push 你的本地仓库到 github;
- 提交 pull requests;
- 等待 CI 验证(若不通过则重复 5~7,github 会自动更新你的 pull requests);
- 等待管理员处理,并及时 rebase 你的分支到上游 master 分支(若上游 master 分支有修改),若有必要,可以
git push -f
强行推送 rebase 后的分支到自己的 github fork。
进行改动时请注意:
- 本项目代码格式化标准选用 PSR-2;
- 若对上述修改流程有任何不清楚的地方,请查阅 GIT 教程,如 这个;
- 对于代码不同方面的修改,请在自己 fork 的项目中创建不同的分支(原因参见
修改流程
第9条备注部分); - 对于 Issues 的处理,请在 pull requests 时使用诸如
修复 #xxx(Issue ID)
的 title 直接关闭 issue。