Skip to content

guozqiu/think

 
 

Repository files navigation

thinkphp5.0 beta

Build Status Coverage Status Downloads Releases Releases Downloads Packagist Status Packagist Downloads

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为后缀;
  • 类的文件名均以命名空间定义,并且命名空间的路径和类库文件所在路径一致;

函数和类、属性命名

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

常量和配置

  • 常量以大写字母和下划线命名,例如 APP_DEBUGAPP_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 本项目并进行改动。

修改流程:

  1. fork本项目;
  2. 克隆(clone)你 fork 的项目到本地;
  3. 新建分支(branch)并检出(checkout)新分支;
  4. 添加本项目到你的本地 git 仓库作为上游(upstream);
  5. 进行修改,若你的修改包含方法或函数的增减,请记得修改单元测试文件
  6. 变基(衍合 rebase)你的分支到上游 master 分支;
  7. push 你的本地仓库到 github;
  8. 提交 pull requests;
  9. 等待 CI 验证(若不通过则重复 5~7,github 会自动更新你的 pull requests);
  10. 等待管理员处理。

进行改动时请注意:

  • 本项目代码格式化标准选用 PSR-2
  • 若对上述修改流程有任何不清楚的地方,请查阅 GIT 教程,如 这个
  • 对于代码不同方面的修改,请在自己 fork 的项目中创建不同的分支(原因参见修改流程第9条备注部分);
  • 对于 Issues 的处理,请在 pull requests 时使用诸如 fix #xxx(Issue ID) 的 title 直接关闭 issue。

About

ThinkPHP5 全新设计的基于PHP5.4的ThinkPHP分支版本

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • PHP 98.1%
  • Smarty 1.9%