安装
最后更新于：2022-04-02 01:47:56
`ThinkPHP5.1`的环境要求如下：
>[info] * PHP >= 5.6.0
> * PDO PHP Extension
> * MBstring PHP Extension
严格来说，`ThinkPHP`无需安装过程，这里所说的安装其实就是把`ThinkPHP`框架放入`WEB`运行环境（**前提是你的WEB运行环境已经OK**），可以通过下面几种方式获取和安装ThinkPHP。
>[danger] `5.1`版本开始，官网不再提供下载版本，请使用`Composer`或者`git`方式安装和更新。
### Composer安装
`ThinkPHP5`支持使用`Composer`安装
> 如果还没有安装 `Composer`，在 `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)。
由于众所周知的原因，国外的网站连接速度很慢。因此安装的时间可能会比较长，我们建议通过下面的方式使用国内镜像。
>[info] 打开命令行窗口（windows用户）或控制台（Linux、Mac 用户）并执行如下命令：
> ~~~
> composer config -g repo.packagist composer https://packagist.phpcomposer.com
> ~~~
>
>[danger] 注意：最近`phpcomposer`镜像存在问题，可以改成
> ~~~
>composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
> ~~~
如果你是第一次安装的话，在命令行下面，切换到你的WEB根目录下面并执行下面的命令：
~~~cmd
composer create-project topthink/think=5.1.* tp5
~~~
这里的`tp5`目录名你可以任意更改，执行完毕后，会在当前目录下的`tp5`子目录安装最新版本的ThinkPHP，这个目录就是我们后面会经常提到的应用根目录。
如果你之前已经安装过，那么切换到你的**应用根目录**下面，然后执行下面的命令进行更新：
~~~cmd
composer update topthink/framework
~~~
>[danger] 更新操作会删除`thinkphp`目录重新下载安装新版本，但不会影响`application`目录，因此不要在核心框架目录添加任何应用代码和类库。
>[info] 安装和更新命令所在的目录是不同的，更新必须在你的应用根目录下面执行
如果出现错误提示，请根据提示操作或者参考[Composer中文文档](http://www.kancloud.cn/thinkphp/composer)。
一般情况下，`composer` 安装的是最新的稳定版本，不一定是最新版本，如果你需要安装实时更新的版本（适合学习过程），可以安装`5.1.x-dev`版本。
~~~cmd
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`
>[info] 之所以设计为应用和核心仓库的分离，是为了支持`Composer`单独更新核心框架。
安装也需要分两步操作，首先克隆下载应用项目仓库
~~~
git clone https://github.com/top-think/think tp5
~~~
然后切换到`tp5`目录下面，再克隆核心框架仓库（注意目录名称不要改变）：
~~~
git clone https://github.com/top-think/framework thinkphp
~~~
> 如果你访问`github`速度比较慢，可以考虑下面两个国内GIT仓库（国内仓库以稳定版本为主，不确保实时更新）：
### [ 码云 ]
~~~php
应用项目：https://gitee.com/liu21st/thinkphp5.git
核心框架：https://gitee.com/liu21st/framework.git
~~~
### [ Coding ]
~~~php
应用项目：https://git.coding.net/liu21st/thinkphp5.git
核心框架：https://git.coding.net/liu21st/framework.git
~~~
>[danger] 由于目前仓库默认分支不是`5.1`版本，你需要切换到`5.1`分支（首先进入thinkphp目录后执行下面的命令）
> ~~~cmd
> git checkout 5.1
> ~~~
两个仓库克隆完成后，就完成了`ThinkPHP5.1`的`Git`方式下载，如果需要更新核心框架的时候，只需要切换到`thinkphp`核心目录下面，然后执行：
~~~cmd
git pull
~~~
>[danger] 请不要在应用目录下执行git更新操作。
> 如果不熟悉`git`命令行，可以使用任何一个GIT客户端进行操作，在此不再详细说明。
现在只需要做最后一步来验证是否正常运行。
在浏览器中输入地址：
~~~
http://localhost/tp5/public/
~~~
如果浏览器输出如图所示：
恭喜你，现在已经完成`ThinkPHP5.1`的安装！
>[danger] 实际部署中，应该是绑定域名访问到`public`目录，确保其它目录不在WEB目录下面。
';