文件结构

Phalcon不会强制要求应用程序的开发遵循特定的文件结构。因为它是松散耦合的，你可以实现Phalcon驱动的应用程序，以及使用对你来说最舒服的文件结构。

本教程的目的以此为起点，我们建议使用以下结构：

tutorial/

app/

controllers/

models/

views/

public/

css/

img/

js/

优美的 URL(Beautiful URLs)¶

在本教程中，我们将使用相当(友好)URL。友好的URL不但利于SEO而且便于用户记忆。Phalcon支持一些最流行的Web服务器提供重写模块。让你的应用程序的URL友好不是必要的，没有它们你可以同样轻松地开发。

在这个例子中，我们将使用Apache的重写模块。 让我们在 /tutorial/.htaccess 文件中创建几个重写规则:

#/tutorial/.htaccess

RewriteEngine on

RewriteRule ^$ public/ [L]

RewriteRule ((?s).*) public/$1 [L]

对该项目的所有请求都将被重定向到为public/文档根目录。此步骤可确保内部项目的文件夹仍然对公共访客隐藏，从而消除了一些安全威胁。

第二组规则将检查是否存在所请求的文件，如果存在所要请求的文件，就不需要Web服务器模块来重写：

#/tutorial/public/.htaccess

RewriteEngine On

RewriteCond %{REQUEST_FILENAME} !-d

RewriteCond %{REQUEST_FILENAME} !-f

RewriteRule ^((?s).*)$ index.php?_url=/$1 [QSA,L]

引导程序(Bootstrap)¶

你需要创建的第一个文件是引导文件。这个文件很重要; 因为它作为你的应用程序的基础，用它来控制应用程序的各个方面。 在这个文件中，你可以实现组件的初始化和应用程序的行为。

这个引导文件 tutorial/public/index.php 文件基本内容如下:

try {

// Register an autoloader

$loader = new Phalcon\Loader();

$loader->registerDirs(array(

'../app/controllers/',

'../app/models/'

))->register();

// Create a DI

$di = new Phalcon\DIFactoryDefault();

// Setup the view component

$di->set('view', function () {

$view = new Phalcon\Mvc\View();

$view->setViewsDir('../app/views/');

return $view;

});

// Setup a base URI so that all generated URIs include the "tutorial" folder

$di->set('url', function () {

$url = new Phalcon\Mvc\Url();

$url->setBaseUri('/tutorial/');

return $url;

});

// Handle the request

$application = new Phalcon\Mvc\Application($di);

echo $application->handle()->getContent();

} catch (\Exception $e) {

echo "Exception: ", $e->getMessage();

}

自动加载

我们可以看出，引导程序的第一部分是注册一个自动加载器。在这个应用程序里，它将用于加载控制器和模型类。例如，我们可以为控制器注册一个或多个目录来增加应用程序的灵活性的。在我们的例子中，我们使用了 Phalcon\Loader 组件。

有了它，我们可以加载使用各种策略类，但在这个例子中，我们选择了在预定义的目录中查找类：

use Phalcon\Loader;

// ...

$loader = new Loader();

$loader->registerDirs(

array(

'../app/controllers/',

'../app/models/'

)

)->register();

依赖管理

在使用Phalcon时必须理解的一个非常重要的概念是 依赖注入容器(dependency injection container). 这听起来复杂,但实际上非常简单实用。

服务容器是一个全局存储的将要被使用的应用程序功能包。每次框架需要的一个组件时，会请求这个使用协定好名称的服务容器。因为Phalcon是一个高度解耦的框架， Phalcon\Di 作为黏合剂，促使不同组件的集成，以一个透明的方式实现他们一起进行工作。

use Phalcon\DI\FactoryDefault;

// ...

// Create a DI

$di = new FactoryDefault();

Phalcon\Di\FactoryDefault 是 Phalcon\Di 的一个变体。为了让事情变得更容易，它已注册了Phalcon的大多数组件。 因此，我们不需要一个一个注册这些组件。在以后更换工厂服务的时候也不会有什么问题。

在接下来的部分，我们注册了“视图(view)”服务，指示框架将去指定的目录寻找视图文件。由于视图并非PHP类，它们不能被自动加载器加载。

服务可以通过多种方式进行登记，但在我们的教程中，我们将使用一个匿名函数 anonymous function:

use Phalcon\Mvc\View;

// ...

// Setup the view component

$di->set('view', function () {

$view = new View();

$view->setViewsDir('../app/views/');

return $view;

});

接下来，我们注册一个基础URI，这样通过Phalcon生成包括我们之前设置的“tutorial”文件夹在内的所有的URI。 我们使用类 Phalcon\Tag 生成超链接，这将在本教程后续部分很重要。

use Phalcon\Mvc\Url as UrlProvider;

// ...

// Setup a base URI so that all generated URIs include the "tutorial" folder

$di->set('url', function () {

$url = new UrlProvider();

$url->setBaseUri('/tutorial/');

return $url;

});

在这个文件的最后部分，我们发现 Phalcon\Mvc\Application。其目的是初始化请求环境，并接收路由到来的请求，接着分发任何发现的动作；收集所有的响应，并在过程完成后返回它们。

use Phalcon\Mvc\Application;

// ...

$application = new Application($di);

echo $application->handle()->getContent();

正如你所看到的，引导文件很短，我们并不需要引入任何其他文件。在不到30行的代码里，我们已经为自己设定一个灵活的MVC应用程序。

创建控制器

默认情况下Phalcon会寻找一个名为“Index”的控制器。当请求中没有控制器或动作时，则使用“Index”控制器作为起点。这个“Index”控制器 (app/controllers/IndexController.php) 看起来类似：

use Phalcon\Mvc\Controller;

class IndexController extends Controller

{

public function indexAction()

{

echo "

Hello!

";

}

}

该控制器类必须有“Controller”后缀，且控制器动作必须有“Action”后缀。

输出到视图

从控制器发送输出到屏幕上有时是必要的，但是在MVC社区，大多数纯粹主义者证明这样做不可取。一切必须传递给视图，视图负责在屏幕上输出数据。Phalcon将在最后执行的控制器的同名目录中，查找最后执行的动作的同名的视图。在我们的例子 (app/views/index/index.phtml) ：

<?php echo "

Hello!";

我们的控制器 (app/controllers/IndexController.php) 现在定义了一个空的动作：

use Phalcon\Mvc\Controller;

class IndexController extends Controller

{

public function indexAction()

{

}

}

浏览器输出应该保持不变。当这个动作已经执行结束 Phalcon\Mvc\View 静态组件会自动创建。

学习更多关于 视图使用教程 。

设计注册表单

现在我们将改变index.phtml视图文件，添加一个链接到一个名为“signup”的新控制器。我们的目标是在应用程序中允许用户注册。

echo "

Hello!

";

echo $this->tag->linkTo("signup", "Sign Up Here!");

生成的HTML代码显示一个锚 (“a”) HTML标签链接到一个新的控制器：

Hello!

Sign Up Here!

我们使用类 Phalcon\Tag 去生成标记。 这是一个让我们构建HTML标记的实用类。 关于生成HTML更详细的文章可以查看 视图助手

这是一个注册控制器 (app/controllers/SignupController.php):

use Phalcon\Mvc\Controller;

class SignupController extends Controller

{

public function indexAction()

{

}

}

这个空index动作整洁的传递了表单定义给一个视图 (app/views/signup/index.phtml):

Sign up using this form

<?php echo $this->tag->form("signup/register"); ?>

Name

<?php echo $this->tag->textField("name") ?>

E-Mail

<?php echo $this->tag->textField("email") ?>

<?php echo $this->tag->submitButton("Register") ?>