# 安装
`ThinkPHP5.1`的环境要求如下:
> - PHP >= 5.6.0
> - PDO PHP Extension
> - MBstring PHP Extension
严格来说,`ThinkPHP`无需安装过程,这里所说的安装其实就是把`ThinkPHP`框架放入`WEB`运行环境(**前提是你的WEB运行环境已经OK**),可以通过下面几种方式获取和安装ThinkPHP。
> `5.1`版本开始,官网不再提供下载版本,请使用`Composer`或者`git`方式安装和更新。
### Composer安装
`ThinkPHP5`支持使用`Composer`安装
> 如果还没有安装 `Composer`,你可以按 [这里提到](http://www.kancloud.cn/thinkphp/composer/35669) 方法安装)在 `Linux` 和 `Mac OS X` 中可以运行如下命令:
>
>
> ```
> curl -sS https://getcomposer.org/installer | php
> mv composer.phar /usr/local/bin/composer
>
> ```
> 在 Windows 中,你需要下载并运行 [Composer-Setup.exe](https://getcomposer.org/Composer-Setup.exe)。
> 如果遇到任何问题或者想更深入地学习 Composer,请参考 [Composer 文档(英文)](https://getcomposer.org/doc/),[Composer 中文](http://www.kancloud.cn/thinkphp/composer)。
由于众所周知的原因,国外的网站连接速度很慢。因此安装的时间可能会比较长,我们建议通过下面的方式使用国内镜像。
> 打开命令行窗口(windows用户)或控制台(Linux、Mac 用户)并执行如下命令:
>
>
> ```
> composer config -g repo.packagist composer https://packagist.phpcomposer.com
>
> ```
如果你是第一次安装的话,在命令行下面,切换到你的WEB根目录下面并执行下面的命令:
```
composer create-project topthink/think tp5
```
这里的`tp5`目录名你可以任意更改,执行完毕后,会在当前目录下的`tp5`子目录安装最新版本的ThinkPHP,这个目录就是我们后面会经常提到的应用根目录。
如果你之前已经安装过,那么切换到你的**应用根目录**下面,然后执行下面的命令进行更新:
```
composer update topthink/framework
```
> 更新操作会删除`thinkphp`目录重新下载安装新版本,但不会影响`application`目录,因此不要在核心框架目录添加任何应用代码和类库。
> 安装和更新命令所在的目录是不同的,更新必须在你的应用根目录下面执行
如果出现错误提示,请根据提示操作或者参考[Composer中文文档](http://www.kancloud.cn/thinkphp/composer)。
一般情况下,`composer` 安装的是最新的稳定版本,不一定是最新版本,如果你需要安装实时更新的版本(适合学习过程),可以安装`5.1.x-dev`版本。
```
composer create-project topthink/think=5.1.x-dev tp5
```
## Git安装
也可以使用`git`版本库安装和更新,`ThinkPHP5.1`主要分为应用和核心两个仓库,主要包括:
- 应用项目:`https://github.com/top-think/think`
- 核心框架:`https://github.com/top-think/framework`
> 之所以设计为应用和核心仓库的分离,是为了支持`Composer`单独更新核心框架。
安装也需要分两步操作,首先克隆下载应用项目仓库
```
git clone https://github.com/top-think/think tp5
```
然后切换到`tp5`目录下面,再克隆核心框架仓库(注意目录名称不要改变):
```
git clone https://github.com/top-think/framework thinkphp
```
> 如果你访问`github`速度比较慢,可以考虑下面两个国内GIT仓库(国内仓库以稳定版本为主,不确保实时更新):
### \[ 码云 \]
```
应用项目:https://gitee.com/liu21st/thinkphp5.git
核心框架:https://gitee.com/liu21st/framework.git
```
### \[ Coding \]
```
应用项目:https://git.coding.net/liu21st/thinkphp5.git
核心框架:https://git.coding.net/liu21st/framework.git
```
> 由于目前仓库默认分支还不是`5.1`版本,你需要切换到`5.1`分支(首先进入thinkphp目录后执行下面的命令)
>
>
> ```
> git checkout 5.1
>
> ```
两个仓库克隆完成后,就完成了`ThinkPHP5.1`的`Git`方式下载,如果需要更新核心框架的时候,只需要切换到`thinkphp`核心目录下面,然后执行:
```
git pull
```
> 请不要在应用目录下执行git更新操作。
> 如果不熟悉`git`命令行,可以使用任何一个GIT客户端进行操作,在此不再详细说明。
现在只需要做最后一步来验证是否正常运行。
在浏览器中输入地址:
```
http://localhost/tp5/public/
```
如果浏览器输出如图所示:
![](https://box.kancloud.cn/bba17bea0da7f91c9c79f2ae7d561e00_1133x441.png)
恭喜你,现在已经完成`ThinkPHP5.1`的安装!
> 实际部署中,应该是绑定域名访问到`public`目录,确保其它目录不在WEB目录下面。
- 序言
- 基础
- 安装
- 开发规范
- 目录结构
- 配置
- 架构
- 架构总览
- 入口文件
- URL访问
- 模块设计
- 命名空间
- 容器和依赖注入
- Facade
- 钩子和行为
- 中间件
- 路由
- 路由定义
- 变量规则
- 路由地址
- 闭包支持
- 路由参数
- 路由缓存
- 跨域请求
- 注解路由
- 路由分组
- MISS路由
- 资源路由
- 快捷路由
- 路由别名
- 路由绑定
- 域名路由
- URL生成
- 控制器
- 控制器定义
- 前置操作
- 跳转和重定向
- 空操作和空控制器
- 分层控制器
- 资源控制器
- 请求
- 请求对象
- 请求信息
- 输入变量
- 请求类型
- HTTP头信息
- 伪静态
- 参数绑定
- 请求缓存
- 响应
- 响应输出
- 响应参数
- 重定向
- 数据库
- 连接数据库
- 查询构造器
- 查询数据
- 添加数据
- 更新数据
- 删除数据
- 查询表达式
- 链式操作
- 聚合查询
- 时间查询
- 高级查询
- 视图查询
- JSON字段
- 子查询
- 原生查询
- 查询事件
- 事务操作
- 监听SQL
- 存储过程
- 数据集
- 分布式数据库
- 模型
- 定义
- 新增
- 更新
- 删除
- 查询
- JSON字段
- 获取器
- 修改器
- 自动时间戳
- 只读字段
- 软删除
- 类型转换
- 数据完成
- 查询范围
- 模型输出
- 模型事件
- 模型关联
- 一对一关联
- 一对多关联
- 远程一对多
- 多对多关联
- 多态关联
- 关联预载入
- 关联统计
- 关联输出
- 视图
- 视图渲染
- 视图赋值
- 视图过滤
- 模板引擎
- 模板
- 变量输出
- 使用函数
- 运算符
- 原样输出
- 模板注释
- 模板布局
- 模板继承
- 包含文件
- 输出替换
- 标签库
- 内置标签
- 循环标签
- 比较标签
- 条件判断
- 资源文件加载
- 标签嵌套
- 原生PHP
- 定义标签
- 标签扩展
- 错误和日志
- 异常处理
- 日志处理
- 调试
- 调试模式
- Trace调试
- 性能调试
- SQL调试
- 变量调试
- 远程调试
- 验证
- 验证器
- 验证规则
- 错误信息
- 验证场景
- 路由验证
- 内置规则
- 独立验证
- 静态调用
- 表单令牌
- 杂项
- 缓存
- Session
- Cookie
- 多语言
- 分页
- 上传
- 命令行
- 启动内置服务器
- 自动生成目录结构
- 创建类库文件
- 生成类库映射文件
- 清除缓存文件
- 生成配置缓存文件
- 生成数据表字段缓存
- 生成路由映射缓存
- 自定义指令
- 扩展库
- 验证码
- 图像处理
- Time
- 数据库迁移工具
- Workerman
- MongoDb
- 单元测试
- 安全和性能
- 安全建议
- 优化建议
- 附录
- 助手函数
- 升级指导
- 更新日志