이 문서의 예에서는 Zend Framework 튜토리얼 프런트엔드 컨트롤러 Zend_Controller_Front의 사용법을 설명합니다. 다음과 같이 참고할 수 있도록 모든 사람과 공유하세요.
주요 기능
ZendFramework MVC 구현의 핵심 메커니즘은 요청 환경을 초기화하는 데 사용되는 Zend_Controller_Front 프런트엔드 컨트롤러를 통한 것입니다. 요청을 처리하고 경로를 배포합니다. 응답 작업을 완료하기 위해 Zend_Controller_Front는 싱글톤 모드를 채택하므로 애플리케이션에는 프런트엔드 컨트롤러가 하나만 있습니다. 일부 특수 기능을 제공하기 위해 프런트엔드 컨트롤러가 필요한 경우 Zend_Controller_Front를 상속하여 프런트엔드 컨트롤러를 사용자 정의할 수 있습니다.
메인 메소드
getInstance()
는 프런트엔드 컨트롤러 인스턴스를 얻는 데 사용됩니다. 프론트 컨트롤러 객체를 생성하는 유일한 방법입니다.
$front = Zend_Controller_Front::getInstance();
setControllerDirectory() 및 addControllerDirectory()
setControllerDirectory()는 액션 컨트롤러 액션 컨트롤러 클래스 파일의 저장 위치를 설정합니다. 매개변수는 경로 문자열 또는 연관 배열일 수 있습니다.
예:
//路径是相对于应用的/application目录下 // 字符串 $front->setControllerDirectory('../application/controllers'); // 关联数组 $front->setControllerDirectory(array( 'default' => '../application/controllers', 'blog' => '../modules/blog/controllers', 'news' => '../modules/news/controllers', )); // Add a 'foo' module directory: $front->addControllerDirectory('../modules/foo/controllers', 'foo');
참고: 모듈 이름 없이 addControllerDirectory()를 사용하면 디렉터리가 기본 모듈 ——디렉토리가 설정되어 있으면 덮어씁니다.
컨트롤러 디렉토리의 현재 설정은 getControllerDirectory()를 통해 얻을 수 있으며 모듈/디렉터리 쌍의 연관 배열을 반환합니다.
addModuleDirectory() 및 getModuleDirectory()
프런트 엔드 컨트롤러의 한 가지 기능은 모듈 디렉터리 구조를 정의하여 "모듈"이라는 독립적인 구성 요소를 생성할 수 있다는 것입니다.
각 모듈은 자체 디렉터리에 있으며 기본 모듈과 동일한 디렉터리 구조를 갖습니다. 예를 들어 최소한 "controllers" 하위 디렉터리와 "views" 하위 디렉터리 및 기타 응용 프로그램 하위 디렉터리가 있습니다.
addModuleDirectory()를 사용하면 하나 이상의 모듈 디렉터리가 포함된 디렉터리의 이름을 전달할 수 있습니다. 그런 다음 검색되어 전면 컨트롤러에 컨트롤러 디렉터리로 추가됩니다.
그런 다음 특정 모듈이나 현재 모듈 경로를 확인하려면 getModuleDirectory()를 호출하고 선택적으로 모듈 이름을 전달하여 모듈 디렉터리를 가져옵니다.
dispatch()
dispatch(Zend_Controller_Request_Abstract $request = null, Zend_Controller_Response_Abstract $response = null)는 프런트엔드 컨트롤러의 가장 무거운 작업을 완료합니다. 이 메소드는 선택적 매개변수인 요청 객체 및/또는 응답 객체를 취하므로 개발자는 각각에 대해 사용자 정의 객체를 전달할 수 있습니다.
요청이나 응답 객체가 전달되지 않으면, dispatch()는 이전에 등록된 객체를 확인하여 사용하고, 아무것도 발견되지 않으면 기본 객체 버전을 생성합니다(둘 다 기본적으로 HTTP 객체를 사용합니다).
마찬가지로, dispatch()는 먼저 등록된 라우터 및 디스패처 개체를 확인하고, 찾을 수 없으면 기본 버전을 인스턴스화합니다.
배포 프로세스에는 라우팅, 디스패칭, 응답의 세 가지 이벤트가 있습니다.
라우팅은 한 번만 발생합니다. 배포는 루프에서 발생합니다. 요청은 여러 작업이 디스패치되어야 함을 나타내거나 컨트롤러 또는 플러그인이 요청 개체를 재설정하여 추가 작업이 디스패치되도록 할 수 있습니다. 모두 완료되면 전면 컨트롤러가 응답 객체를 반환합니다.
run()
Zend_Controller_Front::run($path)은 컨트롤러가 포함된 디렉터리의 경로인 하나의 매개 변수만 사용하는 정적 메서드입니다. 먼저 getInstance()를 통해 프런트 엔드 컨트롤러 인스턴스를 얻은 다음 setControllerDirectory()를 통해 들어오는 경로를 등록하고 마지막으로 배포합니다.
기본적으로 프론트엔드 컨트롤러 환경을 커스터마이징할 필요가 없다면 run()은 프론트엔드 컨트롤러 환경을 구축하는 데 매우 편리한 방법입니다.
Zend_Controller_Front::run('../application/controllers');
Environment Accessor 메소드
위에 나열된 메소드 외에도 전면 컨트롤러에 영향을 줄 수 있는 많은 accessor 메소드가 있습니다. - 따라서 전면 컨트롤러 대리자 클래스의 환경에도 영향을 미칩니다.
resetInstance() 메서드는 현재 설정을 모두 지웁니다. 주로 테스트용으로 사용되지만 여러 전면 컨트롤러를 함께 연결하려는 경우에도 사용할 수 있습니다.
(set|get)DefaultControllerName() 메서드는 기본 컨트롤러에 대해 다른 이름을 지정하고(그렇지 않으면 'index' 사용) 현재 값을 가져올 수 있습니다. 그들은 배포자를 대리합니다.
(set|get)DefaultAction() 메서드는 기본 작업에 대해 다른 이름을 지정하고(그렇지 않으면 'index' 사용) 현재 값을 가져올 수 있습니다. 그들은 배포자를 대리합니다.
(set|get)Request() 메소드는 배포 프로세스에서 사용되는 요청 클래스 또는 객체를 지정하고 현재 요청 객체를 가져옵니다. 요청 객체를 설정할 때 요청 클래스의 이름을 전달할 수 있으며, 이 메서드는 클래스 파일을 로드하고 인스턴스를 생성합니다.
(set|get)Router() 메소드는 배포 과정에서 사용되는 라우터 클래스나 객체를 지정하고 현재 객체를 가져옵니다. 라우터를 설정할 때 라우터 클래스 이름을 전달할 수 있으며 이 메서드는 클래스 파일을 로드하고 인스턴스를 생성합니다.
라우터 개체를 얻을 때 먼저 개체가 있는지 확인하세요. 없으면 기본 라우터 인스턴스를 만듭니다(다시 쓰기 라우터).
(set|get)BaseUrl()方法指定路由请求时剥离(strip)的基地址(base URL),以及获取当前值。这个值将在路由前提供给路由器。
(set|get)Dispatcher()方法指定分发过程中使用的分发器类或对象,以及获取当前对象。设定分发器对象时,可以传入一个分发器类的名字,该方法将加载类文件并创建实例。
获取分发器对象时,首先检查是否已有一个存在,如果没有,将创建一个默认的分发器实例。
(set|get)Response()方法指定分发过程中使用的响应类或对象,已经获取当前对象。设定响应对象时,可以传入一个响应类的名字,该方法将加载类文件并创建实例。
registerPlugin(Zend_Controller_Plugin_Abstract $plugin, $stackIndex = null)方法允许注册一个插件对象。通过设置可选参数$stackIndex,插件执行的顺序。
unregisterPlugin($plugin)方法移除插件对象。$plugin可以是一个插件对象或者代表移除插件类的字符串。
throwExceptions($flag)方法用来开启或者关闭分发过程中抛出异常的能力。默认的,异常引起并放置在响应对象中;开启throwExceptions()将覆盖这一行为。
returnResponse($flag)方法通知前端控制器是否从dispatch()中返回请求对象(true),否则自动发送响应对象(false—)。默认的,响应对象被自动发送(通过调用Zend_Controller_Response_Abstract::sendResponse());开启returnResponse()将覆盖这一行为。
返回响应对象的原因包括希望在发送响应前检查异常,记录响应的各种属性(例如消息头)等等。
前端控制器参数
介绍里曾提到前端控制器可以用作各种控制器组件的注册表。它通过一个"param"家族的方法来做到这些。这些方法允许通过前端控制器注册任意类型的数据 —— 对象和变量,可以在分发链中的任何时候获取。这些变量被传递到路由器,分发器,以及动作控制器。这些方法包括:
setParam($name, $value)方法设定值为$value的单个参数$name。
setParams(array $params)方法通过关联数组一次设定多个参数。
getParam($name)方法通过$name标识符获取单个参数。
getParams()方法一次获取整个参数列表。
clearParams()方法可以清空一个参数(传入单个字符串标识符),清空多个参数(传入字符串标识符数组),清空整个参数栈(不传入参数)。
有几个预定义的参数可供设定,它们在分发链中有特别的用途:
useDefaultControllerAlways用来提示 分发器遇到无法分发的请求时使用默认模块的默认控制器。这默认是关闭的。
阅读可能遭遇的MVC异常获得使用该设定的更详尽信息。
disableOutputBuffering用来提示 is used to hint to 分发器不使用输出缓冲来捕捉动作控制器产生的输出。默认的,分发器捕捉任何输出并追加到响应对象的主体内容。
noViewRenderer用来禁用ViewRenderer。设定该参数为true可以禁用该助手。
noErrorHandler 用来禁用错误处理器插件。设定该参数为true可以禁用该插件。
自定义前端控制器
要继承前端控制器,至少需要覆盖getInstance()方法:
class My_Controller_Front extends Zend_Controller_Front { public static function getInstance() { if (null === self::$_instance) { self::$_instance = new self(); } return self::$_instance; } }
覆盖getInstance()保证后面调用Zend_Controller_Front::getInstance()会返回子类的实例,而不是Zend_Controller_Front实例,这对于一些可替换的路由器和视图助手非常有用。
通常不需要继承前端控制器,除非你需要增加新的功能(比如,一个插件自动加载器,或者一个方法来指定动作助手路径)。你想要改动的地方可能包括修改控制器目录的存储方式,使用的默认路由器以及分发器。
ZendFramewrok提供的默认前端控制器已经足够我们使用了,通过Bootstrap功能,完全没有必要手动编写代码改变Zend_Controller_Front的默认机制。所以通常情况下Zend_Controller_Front对于应用来说是不存在。如果需要使用Zend_Controller_Front提供的功能,通过Zend_Controller_Front::getInstance();获取实例即可。
希望本文所述对大家PHP程序设计有所帮助。
更多Zend Framework教程之前端控制器Zend_Controller_Front用法详解相关文章请关注PHP中文网!