FleaPHP 参数定制

FleaPHP很方便，可以节省很多时间，不过配置起来也有很多要注意的事情~

从 http://www.beyondidea.cn/archives/309 这里引用一些说明~

核心配置

• namespace 应用程序的默认名字空间，默认值为空字符串这个设置会影响到应用程序所有类的名称定义。例如 namespace 设置为 FOO 时，应用程序所有控制器、模型的类名字都要加上前缀 FOO_。变成诸如 FOO_Controller_Default、FOO_Model_News 等。

  为了让你的代码能够更容易的在其他应用程序中复用，最好将 namespace 设置为空字符串。

• controllerAccessor 指示控制器的 URL 参数名，默认值为 controller这个设置指定在 URL 查询参数中，用什么名字的参数指定控制器名字。例如 controllerAccessor 设置为 “ctl” 时，就必须用 index.php?ctl=MyController 来指定要调用的控制器。
• defaultController 指示默认控制器的名字，默认值为 Default当 url 参数中没有指定要调用的控制器时，将依据 defaultController 的设置调用默认的控制器。
• actionAccessor 和 defaultAction，默认值分别为 action 和 index这两个设置的作用和 controllerAccessor、defaultController 类似。只不过用于指定控制器动作的参数名和默认动作名。
• urlMode 指定 URL 分析和构造模式，默认值为 URL_STANDARDURL 的分析和构造模式，目前支持三种，分别是：URL_STANDARD、URL_PATHINFO 和 URL_REWRITE。

  URL_STANDARD 模式中，URL 参数采用采用标准的方式，例如 index.php?controller=MyController&action=MyAction&class_id=2&sort=1

  关于 URL_PATHINFO 和 URL_REWRITE 的详细说明，请参考使用 PATHINFO 和 URL 重写。

• urlLowerChar 指示是否将 url 参数中包含的控制器名字和动作名字强制转为小写字符，默认值为 false对于 Windows 系统来说，这个设置无关紧要。而对于 Linux/Unix 系统来说，这个设置会关系到控制器类定义文件的命名。

  当 urlLowerChar 为 true 时，控制器名字会被转为小写字符，而该控制器的类名字除第一个字母为大写外，其他全为小写。例如控制器名为 MyController，实际的控制器类名称为 Mycontroller，对应的类定义文件为 Mycontroller.php。

  当 urlLowerChar 为 false 时，控制器名字和控制器的类名字完全对应，例如控制器名为 QuickBenchmark，实际的控制器类名称为 QuickBenchmark，对应的类定义文件为 QuickBenchmark.php。

• controllerClassPrefix 指示控制器类名称前缀，默认值为 Controller_
• actionMethodPrefix 和 actionMethodSuffix 指示控制器动作的方法名要加上的前缀和后缀，默认值分别为 action 和空字符串使用前缀和后缀可以，让控制器动作方法的名称和控制器中的其他方法区别开来。同时也可以避免无意中造成控制器内的私有方法被浏览器访问到。
• dispatcher 指示应用程序要使用的 URL 调度器，默认值为 FLEA_Dispatcher_SimpleURL 调度器分析 URL 参数，决定要调用的控制器和控制器动作方法，最后调用控制器动作方法。默认的 FLEA_Dispatcher_Simple 是一个简单的调度器，仅仅是分析 URL 参数，然后完成调用工作。而更复杂的 FLEA_Dispatcher_Auth 则可以结合 FleaPHP 自带的 RBAC（基于角色的访问控制）组件完成访问控制功能。

  如果开发者自己编写了调度器，那么修改这个设置即可让应用程序使用开发者自己编写的调度器。

• dispatcherFailedCallback 指示调度器调度失败后，要调用的处理程序，默认值为 null如果希望应用程序处理调度失败的情况（例如控制器或控制器方法不存在），则需要覆盖这个设置。

• internalCacheDir 指示 FleaPHP 内部及 cache 系列函数使用的缓存目录，默认值为 FLEA/_Cache/ 目录

• autoLoad 指示要自动载入的文件，默认载入 FLEA_Helper_Array.php、FLEA_Helper_Html.php 和 FLEA_Controller_Action.php 三个文件这个设置必须是一个数组，数组中每一个项目为要自动载入的文件。
• sessionProvider 指示要使用的 session 服务提供程序，默认值为 null如果设置为 null，则表示使用 PHP 自带的 session 服务。
• autoSessionStart 指示是否自动起用 session 支持，默认值为 true如果该设置为 true，则每次 FleaPHP 框架初始化后都会自动执行 session_start() 函数。
• requestFilters 指示使用哪些过滤器对 HTTP 请求进行过滤，默认值为空数组和 autoLoad 设置类似，该设置必须为数组。但数组中每一个项目为要运行的过滤器类名字。过滤器按照出现在数组中的顺序初始化和运行。

  每一个过滤器实际上都是一个脚本，无需要实现为一个类。可以参考 FLEA/Filter/ 目录中的过滤器代码实现自己的过滤器。

  FleaPHP 初始化时，会根据 PHP 运行环境设置和应用程序设置来决定是否自动运行 FLEA_Filter_MagicQuotes 和 FLEA_Filter_Uri 过滤器。因此开发者不应该在 requestFilters 设置中调用这两个过滤器。

  日志服务和错误处理

  • logEnabled 指示是否启用日志服务，默认值为 false如果该设置为 true，则会自动载入由 logProvider 设置指定的日志服务提供程序。
  • logProvider 指示日志服务的程序，默认值为 FLEA_Com_Log
  • logFileDir 指示用什么目录保存日志文件，默认值为 null最好将日志保存在浏览器无法访问的目录中。
  • logFilename 指示用什么文件名保存日志，默认值为 access.log
  • logFileMaxSize 指示当日志文件超过多少 KB 时，自动创建新的日志文件，单位是 KB，不能小于 512KB，默认值为 4096
  • logErrorLevel 指示哪些级别的错误要保存到日志中，默认值为 ‚warning, error, exception‘
  • displayErrors 指示是否显示错误信息，默认值为 true
  • friendlyErrorsMessage 指示是否显示友好的错误信息，默认值为 true