## 常量参考 ### 预定义常量 预定义常量是指系统内置定义好的常量，不会随着环境的变化而变化，包括： ~~~ URL_COMMON 普通模式 URL （0） URL_PATHINFO PATHINFO URL （1） URL_REWRITE REWRITE URL （2） URL_COMPAT 兼容模式 URL （3） EXT 类库文件后缀（.class.php） THINK_VERSION 框架版本号 ~~~ ### 路径常量 系统和应用的路径常量用于系统默认的目录规范，可以通过重新定义改变，如果不希望定制目录，这些常量一般不需要更改。 ~~~ THINK_PATH 框架系统目录 APP_PATH 应用目录（默认为入口文件所在目录） LIB_PATH 系统类库目录（默认为 THINK_PATH.'Library/'） CORE_PATH 系统核心类库目录 （默认为 LIB_PATH.'Think/'） MODE_PATH 系统应用模式目录 （默认为 THINK_PATH.'Mode/'） BEHAVIOR_PATH 行为目录 （默认为 LIB_PATH.'Behavior/'） COMMON_PATH 公共模块目录 （默认为 APP_PATH.'Common/'） VENDOR_PATH 第三方类库目录（默认为 LIB_PATH.'Vendor/'） RUNTIME_PATH 应用运行时目录（默认为 APP_PATH.'Runtime/'） HTML_PATH 应用静态缓存目录（默认为 APP_PATH.'Html/'） CONF_PATH 应用公共配置目录（默认为 COMMON_PATH.'Conf/'） LANG_PATH 公共语言包目录 （默认为 COMMON_PATH.'Lang/'） LOG_PATH 应用日志目录 （默认为 RUNTIME_PATH.'Logs/'） CACHE_PATH 项目模板缓存目录（默认为 RUNTIME_PATH.'Cache/'） TEMP_PATH 应用缓存目录（默认为 RUNTIME_PATH.'Temp/'） DATA_PATH 应用数据目录 （默认为 RUNTIME_PATH.'Data/'） ADDON_PATH 插件控制器目录 （默认为 APP_PATH.'Addon'） 3.2.3新增 ~~~ ### 系统常量 系统常量会随着开发环境的改变或者设置的改变而产生变化。 ~~~ IS_CGI 是否属于 CGI模式 IS_WIN 是否属于Windows 环境 IS_CLI 是否属于命令行模式 __ROOT__ 网站根目录地址 __APP__ 当前应用（入口文件）地址 __MODULE__ 当前模块的URL地址 __CONTROLLER__ 当前控制器的URL地址 __ACTION__ 当前操作的URL地址 __SELF__ 当前URL地址 __INFO__ 当前的PATH_INFO字符串 __EXT__ 当前URL地址的扩展名 MODULE_NAME 当前模块名 MODULE_PATH 当前模块路径 CONTROLLER_NAME 当前控制器名 CONTROLLER_PATH 当前控制器路径 3.2.3新增 ACTION_NAME 当前操作名 APP_DEBUG 是否开启调试模式 APP_MODE 当前应用模式名称 APP_STATUS 当前应用状态 STORAGE_TYPE 当前存储类型 MODULE_PATHINFO_DEPR 模块的PATHINFO分割符 MEMORY_LIMIT_ON 系统内存统计支持 RUNTIME_FILE 项目编译缓存文件名 THEME_NAME 当前主题名称 THEME_PATH 当前模板主题路径 LANG_SET 当前浏览器语言 MAGIC_QUOTES_GPC MAGIC_QUOTES_GPC NOW_TIME 当前请求时间（时间戳） REQUEST_METHOD 当前请求类型 IS_GET 当前是否GET请求 IS_POST 当前是否POST请求 IS_PUT 当前是否PUT请求 IS_DELETE 当前是否DELETE请求 IS_AJAX 当前是否AJAX请求 BIND_MODULE 当前绑定的模块（3.2.1新增） BIND_CONTROLLER 当前绑定的控制器（3.2.1新增） BIND_ACTION 当前绑定的操作（3.2.1新增） CONF_EXT 配置文件后缀（3.2.2新增） CONF_PARSE 配置文件解析方法（3.2.2新增） TMPL_PATH 用于改变全局视图目录（3.2.3新增） ~~~ ## 配置参考 ### 惯例配置 #### 应用设定 ~~~ 'APP_USE_NAMESPACE' => true, // 应用类库是否使用命名空间 3.2.1新增 'APP_SUB_DOMAIN_DEPLOY' => false, // 是否开启子域名部署 'APP_SUB_DOMAIN_RULES' => array(), // 子域名部署规则 'APP_DOMAIN_SUFFIX' => '', // 域名后缀 如果是com.cn net.cn 之类的后缀必须设置 'ACTION_SUFFIX' => '', // 操作方法后缀 'MULTI_MODULE' => true, // 是否允许多模块 如果为false 则必须设置 DEFAULT_MODULE 'MODULE_DENY_LIST' => array('Common','Runtime'), // 禁止访问的模块列表 'MODULE_ALLOW_LIST' => array(), // 允许访问的模块列表 'CONTROLLER_LEVEL' => 1, 'APP_AUTOLOAD_LAYER' => 'Controller,Model', // 自动加载的应用类库层（针对非命名空间定义类库） 3.2.1新增 'APP_AUTOLOAD_PATH' => '', // 自动加载的路径（针对非命名空间定义类库） 3.2.1新增 ~~~ #### 默认设定 ~~~ 'DEFAULT_M_LAYER' => 'Model', // 默认的模型层名称 'DEFAULT_C_LAYER' => 'Controller', // 默认的控制器层名称 'DEFAULT_V_LAYER' => 'View', // 默认的视图层名称 'DEFAULT_LANG' => 'zh-cn', // 默认语言 'DEFAULT_THEME' => '', // 默认模板主题名称 'DEFAULT_MODULE' => 'Home', // 默认模块 'DEFAULT_CONTROLLER' => 'Index', // 默认控制器名称 'DEFAULT_ACTION' => 'index', // 默认操作名称 'DEFAULT_CHARSET' => 'utf-8', // 默认输出编码 'DEFAULT_TIMEZONE' => 'PRC', // 默认时区 'DEFAULT_AJAX_RETURN' => 'JSON', // 默认AJAX 数据返回格式,可选JSON XML ... 'DEFAULT_JSONP_HANDLER' => 'jsonpReturn', // 默认JSONP格式返回的处理方法 'DEFAULT_FILTER' => 'htmlspecialchars', // 默认参数过滤方法 用于I函数... ~~~ ### Cookie设置 ~~~ 'COOKIE_EXPIRE' => 0, // Cookie有效期 'COOKIE_DOMAIN' => '', // Cookie有效域名 'COOKIE_PATH' => '/', // Cookie路径 'COOKIE_PREFIX' => '', // Cookie前缀 避免冲突 'COOKIE_HTTPONLY' => '', // Cookie的httponly属性 3.2.2新增 ~~~ #### 数据库设置 ~~~ 'DB_TYPE' => '', // 数据库类型 'DB_HOST' => '', // 服务器地址 'DB_NAME' => '', // 数据库名 'DB_USER' => '', // 用户名 'DB_PWD' => '', // 密码 'DB_PORT' => '', // 端口 'DB_PREFIX' => '', // 数据库表前缀 'DB_FIELDTYPE_CHECK' => false, // 是否进行字段类型检查 3.2.3版本废弃 'DB_FIELDS_CACHE' => true, // 启用字段缓存 'DB_CHARSET' => 'utf8', // 数据库编码默认采用utf8 'DB_DEPLOY_TYPE' => 0, // 数据库部署方式:0 集中式(单一服务器),1 分布式(主从服务器) 'DB_RW_SEPARATE' => false, // 数据库读写是否分离 主从式有效 'DB_MASTER_NUM' => 1, // 读写分离后 主服务器数量 'DB_SLAVE_NO' => '', // 指定从服务器序号 'DB_SQL_BUILD_CACHE' => false, // 数据库查询的SQL创建缓存 3.2.3版本废弃 'DB_SQL_BUILD_QUEUE' => 'file', // SQL缓存队列的缓存方式 支持 file xcache和apc 3.2.3版本废弃 'DB_SQL_BUILD_LENGTH' => 20, // SQL缓存的队列长度 3.2.3版本废弃 'DB_SQL_LOG' => false, // SQL执行日志记录 3.2.3版本废弃 'DB_BIND_PARAM' => false, // 数据库写入数据自动参数绑定 'DB_DEBUG' => false, // 数据库调试模式 3.2.3新增 'DB_LITE' => false, // 数据库Lite模式 3.2.3新增 ~~~ #### 数据缓存设置 ~~~ 'DATA_CACHE_TIME' => 0, // 数据缓存有效期 0表示永久缓存 'DATA_CACHE_COMPRESS' => false, // 数据缓存是否压缩缓存 'DATA_CACHE_CHECK' => false, // 数据缓存是否校验缓存 'DATA_CACHE_PREFIX' => '', // 缓存前缀 'DATA_CACHE_TYPE' => 'File', // 数据缓存类型,支持:File|Db|Apc|Memcache|Shmop|Sqlite|Xcache|Apachenote|Eaccelerator 'DATA_CACHE_PATH' => TEMP_PATH,// 缓存路径设置 (仅对File方式缓存有效) 'DATA_CACHE_SUBDIR' => false, // 使用子目录缓存 (自动根据缓存标识的哈希创建子目录) 'DATA_PATH_LEVEL' => 1, // 子目录缓存级别 ~~~ #### 错误设置 ~~~ 'ERROR_MESSAGE' => '页面错误！请稍后再试～',//错误显示信息,非调试模式有效 'ERROR_PAGE' => '', // 错误定向页面 'SHOW_ERROR_MSG' => false, // 显示错误信息 'TRACE_MAX_RECORD' => 100, // 每个级别的错误信息 最大记录数 ~~~ #### 日志设置 ~~~ 'LOG_RECORD' => false, // 默认不记录日志 'LOG_TYPE' => 'File', // 日志记录类型 默认为文件方式 'LOG_LEVEL' => 'EMERG,ALERT,CRIT,ERR',// 允许记录的日志级别 'LOG_EXCEPTION_RECORD' => false, // 是否记录异常信息日志 ~~~ #### SESSION设置 ~~~ 'SESSION_AUTO_START' => true, // 是否自动开启Session 'SESSION_OPTIONS' => array(), // session 配置数组 支持type name id path expire domain 等参数 'SESSION_TYPE' => '', // session hander类型 默认无需设置 除非扩展了session hander驱动 'SESSION_PREFIX' => '', // session 前缀 ~~~ #### 模板引擎设置 ~~~ 'TMPL_CONTENT_TYPE' => 'text/html', // 默认模板输出类型 'TMPL_ACTION_ERROR' => THINK_PATH.'Tpl/dispatch_jump.tpl', // 默认错误跳转对应的模板文件 'TMPL_ACTION_SUCCESS' => THINK_PATH.'Tpl/dispatch_jump.tpl', // 默认成功跳转对应的模板文件 'TMPL_EXCEPTION_FILE' => THINK_PATH.'Tpl/think_exception.tpl',// 异常页面的模板文件 'TMPL_DETECT_THEME' => false, // 自动侦测模板主题 'TMPL_TEMPLATE_SUFFIX' => '.html', // 默认模板文件后缀 'TMPL_FILE_DEPR' => '/', //模板文件CONTROLLER_NAME与ACTION_NAME之间的分割符 'TMPL_ENGINE_TYPE' => 'Think', // 默认模板引擎 以下设置仅对使用Think模板引擎有效 'TMPL_CACHFILE_SUFFIX' => '.php', // 默认模板缓存后缀 'TMPL_DENY_FUNC_LIST' => 'echo,exit', // 模板引擎禁用函数 'TMPL_DENY_PHP' => false, // 默认模板引擎是否禁用PHP原生代码 'TMPL_L_DELIM' => '{', // 模板引擎普通标签开始标记 'TMPL_R_DELIM' => '}', // 模板引擎普通标签结束标记 'TMPL_VAR_IDENTIFY' => 'array', // 模板变量识别。留空自动判断,参数为'obj'则表示对象 'TMPL_STRIP_SPACE' => true, // 是否去除模板文件里面的html空格与换行 'TMPL_CACHE_ON' => true, // 是否开启模板编译缓存,设为false则每次都会重新编译 'TMPL_CACHE_PREFIX' => '', // 模板缓存前缀标识，可以动态改变 'TMPL_CACHE_TIME' => 0, // 模板缓存有效期 0 为永久，(以数字为值，单位:秒) 'TMPL_LAYOUT_ITEM' => '{__CONTENT__}', // 布局模板的内容替换标识 'LAYOUT_ON' => false, // 是否启用布局 'LAYOUT_NAME' => 'layout', // 当前布局名称 默认为layout ~~~ #### URL设置 ~~~ 'URL_CASE_INSENSITIVE' => true, // 默认false 表示URL区分大小写 true则表示不区分大小写 'URL_MODEL' => 1, // URL访问模式,可选参数0、1、2、3,代表以下四种模式： // 0 (普通模式); 1 (PATHINFO 模式); 2 (REWRITE 模式); 3 (兼容模式) 默认为PATHINFO 模式 'URL_PATHINFO_DEPR' => '/', // PATHINFO模式下，各参数之间的分割符号 'URL_PATHINFO_FETCH' => 'ORIG_PATH_INFO,REDIRECT_PATH_INFO,REDIRECT_URL', // 用于兼容判断PATH_INFO 参数的SERVER替代变量列表 'URL_REQUEST_URI' => 'REQUEST_URI', // 获取当前页面地址的系统变量 默认为REQUEST_URI 'URL_HTML_SUFFIX' => 'html', // URL伪静态后缀设置 'URL_DENY_SUFFIX' => 'ico|png|gif|jpg', // URL禁止访问的后缀设置 'URL_PARAMS_BIND' => true, // URL变量绑定到Action方法参数 'URL_PARAMS_BIND_TYPE' => 0, // URL变量绑定的类型 0 按变量名绑定 1 按变量顺序绑定 'URL_404_REDIRECT' => '', // 404 跳转页面 部署模式有效 'URL_ROUTER_ON' => false, // 是否开启URL路由 'URL_ROUTE_RULES' => array(), // 默认路由规则 针对模块 'URL_MAP_RULES' => array(), // URL映射定义规则 ~~~ #### 系统变量名称设置 ~~~ 'VAR_MODULE' => 'm', // 默认模块获取变量 'VAR_CONTROLLER' => 'c', // 默认控制器获取变量 'VAR_ACTION' => 'a', // 默认操作获取变量 'VAR_AJAX_SUBMIT' => 'ajax', // 默认的AJAX提交变量 'VAR_JSONP_HANDLER' => 'callback', 'VAR_PATHINFO' => 's', // 兼容模式PATHINFO获取变量例如 ?s=/module/action/id/1 后面的参数取决于URL_PATHINFO_DEPR 'VAR_TEMPLATE' => 't', // 默认模板切换变量 'VAR_ADDON' => 'addon', // 默认的插件控制器命名空间变量 3.2.2新增 ~~~ #### 其他设置 ~~~ 'HTTP_CACHE_CONTROL' => 'private', // 网页缓存控制 'CHECK_APP_DIR' => true, // 是否检查应用目录是否创建 'FILE_UPLOAD_TYPE' => 'Local', // 文件上传方式 'DATA_CRYPT_TYPE' => 'Think', // 数据加密方式 ~~~ ## 常见资源 qq sdk 调试[http://connect.qq.com/sdk/webtools/index.html](http://connect.qq.com/sdk/webtools/index.html) linux tree 命令 [http://mama.indstate.edu/users/ice/tree/](http://mama.indstate.edu/users/ice/tree/) composer入门指南中文版 [http://docs.phpcomposer.com/00-intro.md](http://docs.phpcomposer.com/00-intro.md) ## 常见问题 ### 如何获取ThinkPHP [官网下载频道](http://www.thinkphp.cn/down.html)  有所有版本。 ### ThinkPHP的自动生成 #### 目录安全文件 在自动生成目录结构的同时，在各个目录下面我们还看到了index.html文件，这是ThinkPHP自动生成的目录安全文件。 为了避免某些服务器开启了目录浏览权限后可以直接在浏览器输入URL地址查看目录，系统默认开启了目录安全文件机制，会在自动生成目录的时候生成空白的`index.html`文件，当然安全文件的名称可以设置，例如你想给安全文件定义为`default.html`可以在入口文件中添加： ~~~ define('DIR_SECURE_FILENAME', 'default.html'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php'; ~~~ 如果你的环境足够安全，不希望生成目录安全文件，可以在入口文件里面关闭目录安全文件的生成，例如： ~~~ define('BUILD_DIR_SECURE', false); ~~~ #### 自动生成模块目录 可以支持自动生成默认模块之外的模块目录以及批量生成控制器和模型类。 例如，如果我们需要生成一个Admin模块用于后台应用，在应用入口文件中定义如下： ~~~ // 绑定Admin模块到当前入口文件 define('BIND_MODULE','Admin'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php'; ~~~ 然后访问URL地址 ~~~ http://serverName/index.php ~~~ 就会生成Admin模块的目录，并生成一个默认的控制器类`Admin\Controller\IndexController`。 如果需要生成更多的控制器类，可以定义`BUILD_CONTROLLER_LIST`常量，例如： ~~~ // 绑定Admin模块到当前入口文件 define('BIND_MODULE','Admin'); define('BUILD_CONTROLLER_LIST','Index,User,Menu'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php'; ~~~ 访问后会自动生成三个指定的控制器类： ~~~ Admin\Controller\IndexController Admin\Controller\UserController Admin\Controller\MenuController ~~~ > 注意：默认生成的控制器类都是继承`Think\Controller`，如果需要继承其他的公共类需要另外调整。 如果在应用的公共配置文件中设置关闭了 `APP_USE_NAMESPACE`的话，生成的控制器类则不会采用命名空间定义。 同样，也可以定义`BUILD_MODEL_LIST`支持生成多个模型类： ~~~ // 绑定Admin模块到当前入口文件 define('BIND_MODULE','Admin'); define('BUILD_MODEL_LIST','User,Menu'); define('APP_PATH','./Application/'); require './ThinkPHP/ThinkPHP.php'; ~~~ 访问会自动生成模型类： ~~~ Admin\Model\UserModel Admin\Model\MenuModel ~~~ > 注意：默认生成的模型类都是继承`Think\Model`，如果需要继承公共的模型类需要另外调整。 如果在应用的公共配置文件中设置关闭了 `APP_USE_NAMESPACE`的话，生成的模型类则不会采用命名空间定义。 还可以自己手动调用`Think\Build`类的方法来生成控制器类和模型类，例如： ~~~ // 生成Admin模块的Role控制器类 // 默认类库为Admin\Controller\RoleController // 如果已经存在则不会重新生成 \Think\Build::buildController('Admin','Role'); // 生成Admin模块的Role模型类 // 默认类库为Admin\Model\RoleModel // 如果已经存在则不会重新生成 \Think\Build::buildModel('Admin','Role'); ~~~ 更多的方法可以参考Think\Build类库。 ### 单模块省略模块名 `define('BIND_MODULE','Home');` ### 命名空间 详情参考[php手册](http://php.net/language.namespaces) ### Coding 上如何部署一个 ThinkPHP演示应用 #### 提交代码 #### 演示中新建 mysql和filesystem 服务 #### 配置文件中获取`$_ENV['VCAP_SERVICES']`环境变量 #### 用composer文件开启php扩展 参见 [http://docs.coding.io/languages/php](http://docs.coding.io/languages/php) #### 恢复数据导coding上   #### 创建webhook coding 为用户提供了 webhook 功能，方便用户在 push 代码改动后自动 POST 请求你指定的 Web URL，你可以利用这个 URL 在程序后台完成程序的自动部署等操作。更多的介绍跟使用方法请参考 [”WebHook 的内容是什么？"](https://coding.net/help/about_git/about_web_hook_content) 以及 ["WebHook 是什么？我该如何使用？"](https://coding.net/help/about_git/what_is_web_hook)。 [Coding 云端演示平台静态网站部署指南](http://static-site.coding.io/) ## 随书演示地址： <http://yang-book.coding.io> 大家可以随时push request 补充，如果需要数据库表支持请添加自己的添加自己的表前缀，放到attach里，update20150823.sql这种。 ## 如何正确的做事xmind <http://pan.baidu.com/s/1o6Khi7C>