教程：INVO 简介（Tutorial: Introducing INVO）

在第二部分，我们将会说明一个完整的应用用来加深Phalcon的开发。INVO是我们创建的一个程序样本。INVO是一个简单的用来允许用户生成发票的网站，并且可以做其他的任务，比如管理他们的客户或者产品。你可以从 Github 中复制它的代码。

同样，INVO使用 Bootstrap 做的前端框架。虽然这个应用不能生成发票，但是它仍然可以作为一个例子来理解框架是如何工作的。

项目结构（Project Structure）

一旦你从你的文档根目录复制了这个项目，你将会看到以下结构：

  1. invo/
  2.     app/
  3.         config/
  4.         controllers/
  5.         forms/
  6.         library/
  7.         logs/
  8.         models/
  9.         plugins/
  10.         views/
  11.     cache/
  12.     docs/
  13.     public/
  14.         css/
  15.         fonts/
  16.         js/
  17.     schemas/

正如你所知道的，Phalcon不会强求应用程序使用特定的文件结构。这个项目提供了一个简单的MVC模型和公共文档根目录。

一旦你打开浏览器输入 http://localhost/invo 浏览应用程序你将会看到下面这样：
教程：INVO 简介（Tutorial: Introducing INVO） - 图1
这个应用分为两部分，一部分是前端，这个是一个公开的部分，浏览者可以接收关于INVO的信息，也可以请求联系人信息。第二部分是后端，一个管理员区域，一个注册用户可以管理他/她的产品和客户。

路由（Routing）

INVO使用内置的标准路由. Router 组件. 路由符合以下格式：/:controller/:action/:params. 这就意味着第一部分URI是控制器，第二部分是方法，剩余的是参数。

下面的路由 /session/register 执行的是 SessionController 控制器和它的 registerAction 方法。

配置（Configuration）

INVO有一个设置应用常规参数的配置文件。这个文件位于 app/config/config.ini，并且他在应用引导文件的最开始就开始加载 (public/index.php)：

  1. <?php
  2.  
  3. use Phalcon\Config\Adapter\Ini as ConfigIni;
  4.  
  5. // ...
  6.  
  7. // Read the configuration
  8. $config = new ConfigIni(APP_PATH . 'app/config/config.ini');

Phalcon\Config 允许我们使用面向对象的方式来操作文件。在这个例子中，我们使用ini文件作为配置文件，然而，它对于配置文件有更多的适配支持。这个配置文件包含以下配置：

  1. [database]
  2. host     = localhost
  3. username = root
  4. password = secret
  5. name     = invo
  6.  
  7. [application]
  8. controllersDir = app/controllers/
  9. modelsDir      = app/models/
  10. viewsDir       = app/views/
  11. pluginsDir     = app/plugins/
  12. formsDir       = app/forms/
  13. libraryDir     = app/library/
  14. baseUri        = /invo/

对于配置文件，Phalcon 没有任何提前预约好的惯例配置。通过节（Sections）帮助我们组织相应选项。在这个文件里 application 和 database 这两个部分将被用于后面的程序。

自动加载器（Autoloaders）

在引导文件 (public/index.php) 的第二部分是自动加载器:

  1. <?php
  2.  
  3. /**
  4.  * Auto-loader configuration
  5.  */
  6. require APP_PATH . 'app/config/loader.php';

自动加载器注册一组目录列表，应用程序将根据需要从这组目录里查找需要的类文件。

  1. <?php
  2.  
  3. $loader = new Phalcon\Loader();
  4.  
  5. // We're a registering a set of directories taken from the configuration file
  6. $loader->registerDirs(
  7.     array(
  8.         APP_PATH . $config->application->controllersDir,
  9.         APP_PATH . $config->application->pluginsDir,
  10.         APP_PATH . $config->application->libraryDir,
  11.         APP_PATH . $config->application->modelsDir,
  12.         APP_PATH . $config->application->formsDir,
  13.     )
  14. )->register();

注意, 以上代码注册的目录是在配置文件中定义的. 唯一没有注册的目录是 viewsDir, 因为它包含 HTML + PHP 文件但不是类.同时, 也要注意我们使用了常量 APP_PATH, 这个常量在引导文件 (public/index.php) 中被定义, 允许我们对我们项目的根路径有一个参考:

  1. <?php
  2.  
  3. // ...
  4.  
  5. define('APP_PATH', realpath('..') . '/');

注册服务（Registering services）

服务注册已经在前面的教程中实现了, 利用一个闭包来实现惰性加载组件：

  1. <?php
  2.  
  3. use Phalcon\Mvc\Url as UrlProvider;
  4.  
  5. // ...
  6.  
  7. /**
  8.  * The URL component is used to generate all kind of URLs in the application
  9.  */
  10. $di->set('url', function () use ($config) {
  11.     $url = new UrlProvider();
  12.  
  13.     $url->setBaseUri($config->application->baseUri);
  14.  
  15.     return $url;
  16. });

We will discuss this file in depth later.

处理请求（Handling the Request）

如果我们忽略文件 (public/index.php) 的结束, 请求最终会被 Phalcon\Mvc\Application 处理, 它会初始化并执行所有必要条件，使应用程序运行：

  1. <?php
  2.  
  3. use Phalcon\Mvc\Application;
  4.  
  5. // ...
  6.  
  7. $app = new Application();
  8.  
  9. echo $app->handle()->getContent();

依赖注入（Dependency Injection）

Phalcon 是一个高度解耦的框架，所以我们一个组件来充当胶水来让每个组件都能正常工作。这个组件就是 Phalcon\Di。这是一个服务容器，可以执行依赖注入和服务定位，实例化应用所需要的所有组件。

在容器中有多种注册服务的方法。在INVO里, 大部分服务使用匿名函数或者闭包来进行注册的, 对象以惰性的方式被实例化，减少了应用程序所需要的资源。

例如，下面摘录了 Session 服务的注册。当应用程序需要访问 Session 数据的时候，匿名函数才会被调用：

  1. <?php
  2.  
  3. use Phalcon\Session\Adapter\Files as Session;
  4.  
  5. // ...
  6.  
  7. // Start the session the first time a component requests the session service
  8. $di->set('session', function () {
  9.     $session = new Session();
  10.  
  11.     $session->start();
  12.  
  13.     return $session;
  14. });

这里，我们可以自由的更改适配器，执行额外的初始化或者其他操作。注意，这个服务器是使用 session 名字进行注册的。这是一个惯例，来允许框架在服务容器中识别正在活动的服务.

一个请求可以使用多个服务，单独注册每个服务可以说是一个繁重的任务。因此，框架提供了 Phalcon\Di 的一个变种，称作 Phalcon\Di\FactoryDefault，其任务是注册所有 MVC 所需要的服务来提供一个全栈框架。

  1. <?php
  2.  
  3. use Phalcon\Di\FactoryDefault;
  4.  
  5. // ...
  6.  
  7. // The FactoryDefault Dependency Injector automatically registers the
  8. // right services providing a full-stack framework
  9. $di = new FactoryDefault();

它注册了大部分框架提供的标准服务和组件。如果我们需要重写某些已经定义的服务，我们仅仅需要重新定义它，就像上面的 “session” 和 “url”一样，这就是变量 $di 存在的原因.

在下一章，我们将会看到如何在INVO中实施认证和授权。

原文: http://www.myleftstudio.com/reference/tutorial-invo.html