181 lines
6.5 KiB
Markdown
181 lines
6.5 KiB
Markdown
|
||
|
||
ThinkPHP 5.1（LTS版本） —— 12载初心，你值得信赖的PHP框架
|
||
===============
|
||
|
||
[](https://scrutinizer-ci.com/g/top-think/framework/?branch=5.1)
|
||
[](https://travis-ci.org/top-think/framework)
|
||
[](https://packagist.org/packages/topthink/framework)
|
||
[](https://packagist.org/packages/topthink/framework)
|
||
[](http://www.php.net/)
|
||
[](https://packagist.org/packages/topthink/framework)
|
||
|
||
ThinkPHP5.1对底层架构做了进一步的改进，减少依赖，其主要特性包括：
|
||
|
||
+ 采用容器统一管理对象
|
||
+ 支持Facade
|
||
+ 注解路由支持
|
||
+ 路由跨域请求支持
|
||
+ 配置和路由目录独立
|
||
+ 取消系统常量
|
||
+ 助手函数增强
|
||
+ 类库别名机制
|
||
+ 增加条件查询
|
||
+ 改进查询机制
|
||
+ 配置采用二级
|
||
+ 依赖注入完善
|
||
+ 支持`PSR-3`日志规范
|
||
+ 中间件支持（V5.1.6+）
|
||
+ Swoole/Workerman支持（V5.1.18+）
|
||
|
||
|
||
> ThinkPHP5的运行环境要求PHP5.6以上。
|
||
|
||
## 安装
|
||
|
||
使用composer安装
|
||
|
||
~~~
|
||
composer create-project topthink/think tp
|
||
~~~
|
||
|
||
启动服务
|
||
|
||
~~~
|
||
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)
|
||
|
||
## 目录结构
|
||
|
||
初始的目录结构如下：
|
||
|
||
~~~
|
||
www WEB部署目录（或者子目录）
|
||
├─application 应用目录
|
||
│ ├─common 公共模块目录（可以更改）
|
||
│ ├─module_name 模块目录
|
||
│ │ ├─common.php 模块函数文件
|
||
│ │ ├─controller 控制器目录
|
||
│ │ ├─model 模型目录
|
||
│ │ ├─view 视图目录
|
||
│ │ └─ ... 更多类库目录
|
||
│ │
|
||
│ ├─command.php 命令行定义文件
|
||
│ ├─common.php 公共函数文件
|
||
│ └─tags.php 应用行为扩展定义文件
|
||
│
|
||
├─config 应用配置目录
|
||
│ ├─module_name 模块配置目录
|
||
│ │ ├─database.php 数据库配置
|
||
│ │ ├─cache 缓存配置
|
||
│ │ └─ ...
|
||
│ │
|
||
│ ├─app.php 应用配置
|
||
│ ├─cache.php 缓存配置
|
||
│ ├─cookie.php Cookie配置
|
||
│ ├─database.php 数据库配置
|
||
│ ├─log.php 日志配置
|
||
│ ├─session.php Session配置
|
||
│ ├─template.php 模板引擎配置
|
||
│ └─trace.php Trace配置
|
||
│
|
||
├─route 路由定义目录
|
||
│ ├─route.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 命令行入口文件
|
||
~~~
|
||
|
||
> 可以使用php自带webserver快速测试
|
||
> 切换到根目录后，启动命令：php think run
|
||
|
||
## 命名规范
|
||
|
||
`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`字段，不建议使用驼峰和中文作为数据表字段命名。
|
||
|
||
## 参与开发
|
||
|
||
请参阅 [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)
|