介绍本手册内容已经过时，也不再更新请阅读最新的 5.0完全开发手册 或者 5.0快 速入门。推荐阅读ThinkPHP5.0快速入门是官方出品的学习和掌握 ThinkPHP5.0 不可多得的入门指引教程，针对新手用户由浅入深给出了详尽的使用。本系列围绕WEB开发和API开发常用的一系列基础功能进行循序渐进的讲解。ThinkPHP 5 简明开发手册- 1 -本文档使用 看云 构建快速入门本章内容提供了ThinkPHP5.0的一些基本用法，并且处于不断完善过程。注意：本章内容会随着最新版本的功能变化而做出一定的调整，因此相关功能的说明均针对Github的最新版本，而非官网下载版本。GITHUB地址：https:/github.com/top-think/think安装配置ThinkPHP5的环境要求如下：PHP = 5.4.0PDO PHP ExtensionCURL PHP Extension严格来说，ThinkPHP无需安装过程，这里所说的安装其实就是把ThinkPHP框架放入WEB运行环境（前提是你的WEB运行环境已经OK），可以通过两种方式获取和安装ThinkPHP。一、下载ThinkPHP安装获取ThinkPHP的方式很多，官方网站（http:/thinkphp.cn）是最好的下载和文档获取来源。官网提供了稳定版本的下载：http:/thinkphp.cn/down/framework.html由于ThinkPHP5.0还在测试阶段，所以需要通过Git服务器下载，Git服务地址：https:/github.com/top-think/think下载或者使用GIT克隆到本地后，请（解压缩后）放置于你的WEB根目录下面的 tp5 子目录。二、使用Composer安装ThinkPHP支持使用Composer安装，如果还没有安装 Composer，你可以按 Composer安装 中的方法安装。在 Linux 和 Mac OS X 中可以运行如下命令：curl -sS https:/getcomposer.org/installer | php mv composer.phar /usr/local/bin/composer在 Windows 中，你需要下载并运行 Composer-Setup.exe。ThinkPHP 5 简明开发手册- 2 -本文档使用 看云 构建如果遇到任何问题或者想更深入地学习 Composer，请参考 Composer 文档（英文），Composer 中文。如果你已经安装有 Composer 请确保使用的是最新版本，你可以用 composer self-update 命令更新Composer 为最新版本。然后在命令行下面，切换到你的web根目录下面并执行下面的命令： composer create-project topthink/think tp5 dev-master -prefer-dist由于目前尚未正式发布，所以先用 dev-master 分支。如果出现错误提示，请根据提示操作或者参考Composer中文文档。如果国内访问composer的速度比较慢，可以参考这里的说明使用国内镜像无论你采用什么方式获取的ThinkPHP框架，现在只需要做最后一步来验证是否正常运行。在浏览器中输入地址：http:/localhost/tp5/public/如果浏览器输出如图所示：恭喜你，现在已经完成ThinkPHP的安装！如果你无法正常运行并显示ThinkPHP的欢迎页面，那么请参考下面的列表检查下你的服务器环境：PHP5.4以上版本（注意：PHP5.4dev版本和PHP6均不支持）WEB服务器是否正常启动目录结构下载最新版框架后，解压缩到web目录下面，可以看到初始的目录结构如下：ThinkPHP 5 简明开发手册- 3 -本文档使用 看云 构建project 应用部署目录 composer.json composer定义文件 README.md README文件 build.php 自动生成定义文件（参考） 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 快速测试文件（用于自带webserver） thinkphp 框架系统目录 library 框架类库目录 behavior 行为类库目录 think Think类库包目录 org Org类库包目录 traits 系统Traits目录 . 更多类库目录 extend 扩展类库目录（可自定义） vendor 第三方类库目录 mode 应用模式目录 tpl 系统模板目录 base.php 基础文件 convention.php 框架惯例配置文件 start.php 框架引导文件router.php用于php自带webserver支持，可用于快速测试进入public目录后，启动命令：php -S localhost:8888 router.php5.0版本自带了一个完整的应用目录结构和默认的应用入口文件，开发人员可以在这个基础之上灵活调整。上面的目录结构和名称是可以改变的，这取决于你的入口文件和配置参数。由于ThinkPHP5.0.0的架构设计对模块的目录结构保留了很多的灵活性，尤其是对于用于存储的目录具有高度的定制化，因此上述的目录结构仅供规范参考。ThinkPHP 5 简明开发手册- 4 -本文档使用 看云 构建系统架构URL设计ThinkPHP5.0在没有启用路由的情况下典型的URL访问规则是：http:/serverName/应用（或应用入口文件）/模块/控制器/操作/参数名/参 数值.支持切换到命令行访问，如果切换到命令行模式下面的访问规则是：php.exe index.php(应用入口文件） 模块/控制器/操作/参数名/参数值.可以看到，无论是URL访问还是命令行访问，都采用PATHINFO模式的访问地址，其中PATHINFO的分隔符是可以设置的。注意：5.0取消了URL模式的概念，普通模式的URL访问不再支持，如果不支持PATHINFO的服务器可以使用兼容模式访问如下：http:/serverName/应用入口文件?s=/模块/控制器/操作/参数名/参数值.首先，解释下其中的几个概念：应用基于同一个入口文件访问的项目我们称之为一个应用。（但应用可能具有多个入口）模块一个应用下面可以包含多个模块，每个模块在应用目录下面都是一个独立的子目录（小写）。控制器每个模块可以包含多个控制器，一个控制器通常体现为一个（控制器）类（驼峰法命名）。操作每个控制器类可以包含多个操作方法，每个操作是URL访问的最小单元。简化URL访问在ThinkPHP5.0中，出于优化的URL访问原则，我们还做出了如下的URL访问设计，这些设计包括：隐藏应用入口文件 应用入口文件通常就是指index.php，可以通过URL重写隐藏。隐藏应用入口文件index.php,以Apache为例说明如何设置。下面是Apache的配置过程，可以参考下：1、httpd.conf配置文件中加载了mod_rewrite.so模块2、AllowOverride None 将None改为 AllThinkPHP 5 简明开发手册- 5 -本文档使用 看云 构建3、把下面的内容保存为 .htaccess 文件放到应用入口文件的同级目录下RewriteEngine on RewriteCond %REQUEST_FILENAME !-d RewriteCond %REQUEST_FILENAME !-f RewriteRule (.*)$ index.php/$1 QSA,PT,L隐藏模块 由于默认是采用多模块的支持，所以多个模块的情况下必须在URL地址中标识当前模块，如果只有一个模块的话，可以进行模块绑定，方法是应用的公共文件中添加如下代码：/ 绑定index模块 thinkRoute:bind(module,index);设置后，我们的URL访问地址则变成：http:/serverName/应用入口/控制器/操作/参数名/参数值. / 访问的模块 是index模块隐藏控制器 如果你的应用比较简单，模块和控制器都只有一个，那么可以在应用公共文件中绑定模块和控制器，如下：/ 绑定index模块的index控制器 thinkRoute:bind(module,index/index);设置后，我们的URL访问地址则变成：http:/serverName/应用入口/操作/参数名/参数值. / 访问的模块是 index模块，控制器是Index控制器单一模块如果你的应用比较简单，只有一个模块，那么可以尝试使用单一模块结构，方法如下：首先在入口文件中设置/ 关闭多模块设计 define(APP_MULTI_MODULE,false);应用的目录结构就变成：ThinkPHP 5 简明开发手册- 6 -本文档使用 看云 构建application 应用目录（可设置） runtime 应用的运行时目录（可写，可设置） controller 控制器目录 model 模型目录 view 视图目录 . 更多类库目录 common.php 函数文件 route.php 路由配置文件 database.php 数据库配置文件 config.php 配置文件URL访问地址变成http:/serverName/应用入口/控制器/操作/参数名/参数值.单一模块设计的应用类库的命名空间有所调整，例如：appcontrollerIndex appmodelUser更多的URL简化和定制还可以通过URL路由