Verwendung von Zend_Controller_Front im Zend Framework

Dieser Artikel stellt hauptsächlich die Verwendung des Front-End-Controllers Zend_Controller_Front im Zend Framework-Tutorial vor und analysiert detailliert die Funktionen, die Verwendung und die damit verbundenen Vorsichtsmaßnahmen des Front-End-Controllers Zend_Controller_Front >

Beispiel für diesen Artikel Beschreibt die Verwendung des Zend Framework Tutorial-Front-End-Controllers Zend_Controller_Front. Teilen Sie es als Referenz mit allen. Die Details lauten wie folgt:

Hauptfunktionen

Der Kernmechanismus der MVC-Implementierung von ZendFramework erfolgt über den Front-End-Controller Zend_Controller_Front. Dies wird zum Initialisieren der Anforderungsumgebung, zum Weiterleiten der Verteilung und zum Abschließen von Antwortvorgängen verwendet, sodass eine Anwendung nur einen Front-End-Controller hat. Wenn Sie den Front-End-Controller benötigen, um einige spezielle Funktionen bereitzustellen, können Sie Zend_Controller_Front erben, um den Front-End-Controller anzupassen.

Hauptmethode

getInstance()

wird verwendet, um die Front-End-Controller-Instanz abzurufen. Die einzige Möglichkeit, ein Front-Controller-Objekt zu erstellen.

$front = Zend_Controller_Front::getInstance();

setControllerDirectory() und addControllerDirectory()

setControllerDirectory() legt den Action-Controller-Klassendateispeicher fest Standort. Parameter können Pfadzeichenfolgen oder assoziative Arrays sein.

Zum Beispiel:

//路径是相对于应用的/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');

Hinweis: Wenn Sie addControllerDirectory() ohne Modulnamen verwenden, wird das Verzeichnis für das Standardmodul festgelegt —— Wenn das Verzeichnis bereits festgelegt ist, wird es überschrieben.

Die aktuelle Einstellung des Controller-Verzeichnisses kann über getControllerDirectory() abgerufen werden; es wird ein assoziatives Array von Modul-/Verzeichnispaaren zurückgegeben.

addModuleDirectory() und getModuleDirectory()

Eine Funktion des Front-End-Controllers besteht darin, dass Sie eine Modulverzeichnisstruktur definieren können, um unabhängige Komponenten, sogenannte „Module“, zu erstellen " .

Jedes Modul befindet sich in einem eigenen Verzeichnis und hat die gleiche Verzeichnisstruktur wie das Standardmodul – es verfügt beispielsweise mindestens über ein Unterverzeichnis „Controllers“ und ein Unterverzeichnis „Views“ sowie weitere Anwendungsunterverzeichnisse. Mit

addModuleDirectory() können Sie den Namen eines Verzeichnisses übergeben, das ein oder mehrere Modulverzeichnisse enthält. Anschließend werden sie gescannt und als Controller-Verzeichnisse zum Front-Controller hinzugefügt.

Wenn Sie dann ein bestimmtes Modul oder den aktuellen Modulpfad ermitteln möchten, rufen Sie getModuleDirectory() auf und übergeben optional den Modulnamen, um das Modulverzeichnis abzurufen.

dispatch()

dispatch(Zend_Controller_Request_Abstract $request = null, Zend_Controller_Response_Abstract $response = null) erledigt die schwerste Arbeit des Front-End-Controllers. Diese Methode verwendet optionale Parameter vom Typ „Anforderungsobjekt“ und/oder „Antwortobjekt“, sodass der Entwickler jeweils benutzerdefinierte Objekte übergeben kann.

Wenn kein Anforderungs- oder Antwortobjekt übergeben wird, prüft „dispatch()“ das zuvor registrierte Objekt und verwendet es und erstellt die Standardobjektversion, wenn keine gefunden wird (beide verwenden standardmäßig HTTP-Objekte).

Ähnlich überprüft „dispatch()“ zunächst die registrierten Router- und Dispatcher-Objekte und instanziiert deren Standardversionen, wenn sie nicht gefunden werden.

Der Verteilungsprozess umfasst drei verschiedene Ereignisse: Routing, Dispatching und Response

Routing erfolgt nur einmal, wenn „dispatch()“ aufgerufen wird. Die Verteilung erfolgt in einer Schleife; eine Anfrage kann darauf hinweisen, dass mehrere Aktionen gesendet werden sollen, oder ein Controller oder Plugin kann das Anfrageobjekt zurücksetzen und so die Ausgabe zusätzlicher Aktionen erzwingen. Wenn alles abgeschlossen ist, gibt der Frontcontroller das Antwortobjekt zurück.

run()

Zend_Controller_Front::run($path) ist eine statische Methode, die nur einen Parameter akzeptiert, nämlich den Pfad zu dem Verzeichnis, das den Controller enthält. Zuerst wird die Front-End-Controller-Instanz über getInstance () abgerufen, dann wird der eingehende Pfad über setControllerDirectory () registriert und schließlich verteilt.

Grundsätzlich ist run() eine sehr praktische Methode zum Einrichten der Front-End-Controller-Umgebung, wenn keine Anpassung der Front-End-Controller-Umgebung erforderlich ist.

Zend_Controller_Front::run('../application/controllers');

Umgebungszugriffsmethoden

Zusätzlich zu den oben aufgeführten Methoden stehen viele Zugriffsmethoden zur Verfügung. Beeinflusst die Front-Controller-Umgebung – und damit die Umgebung der Klasse, an die der Front-Controller delegiert.

Die Methode resetInstance() löscht alle aktuellen Einstellungen. Wird hauptsächlich zum Testen verwendet, kann aber auch in Fällen verwendet werden, in denen Sie mehrere Front-Controller miteinander verketten möchten. Die Methode

(set|get)DefaultControllerName() kann einen anderen Namen für den Standardcontroller angeben (andernfalls „index“ verwenden) und den aktuellen Wert abrufen. Sie werden den Vertriebshändler vertreten. Die Methode

(set|get)DefaultAction() kann einen anderen Namen für die Standardaktion angeben (andernfalls „index“ verwenden) und den aktuellen Wert abrufen. Sie werden den Vertriebshändler vertreten. Die Methode

(set|get)Request() gibt die im Verteilungsprozess verwendete Anforderungsklasse oder das Anforderungsobjekt an und ruft das aktuelle Anforderungsobjekt ab. Beim Festlegen des Anforderungsobjekts können Sie den Namen einer Anforderungsklasse übergeben. Diese Methode lädt die Klassendatei und erstellt eine Instanz.

(set|get)Router()方法指定分发过程中使用的路由器类或对象，以及获取当前对象。设置路由器时，可以传入一个路由器类的名字，该方法将加载类文件并创建实例。

获取路由器对象的时候，首先检查是否已有一个，如果没有，创建默认的路由器实例（rewrite路由器）。

(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 Zend_Db-Datenbankoperationen im Framework

Das obige ist der detaillierte Inhalt vonVerwendung von Zend_Controller_Front im Zend Framework. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!