FleaPHP 开发指南 - 3. 应用程序入口

与许多开发框架一样，fleaphp 通常也使用一个入口文件来启动框架，并运行应用程序代码。虽然 fleaphp 并不要求应用程序必须使用单一的入口文件，不过在本系列文章中，我大部分时间都使用单一入口文件。

单一入口应用程序

在 fleaphp 应用程序使用 mvc 模式时，应用程序的所有功能都通过一个单一的文件来调用。这种通过单一文件来执行所有功能的应用程序，称为单一入口应用程序。有关单一入口应用程序的一些信息，可以参考 chinaunix 上的一篇帖子。

许多著名的 php 应用程序都是单一入口，例如 drupal、wordpress、xoops、mambo 等。当然也有 phpmyadmin 这样的非单一入口应用程序。

创建入口文件

现在，我们来创建一个最简单的入口文件。打开文本编辑器，创建 htdocs/index.php 文件，内容如下：

<?phprequire('flea/flea.php');run();?>

现在启动浏览器，输入地址：http://localhost/index.php，应该就可以看到如下的画面：

这个画面显示了一个错误信息，但是也表明 index.php 中的两行代码已经成功启动了 fleaphp 框架。

实现我们的第一个控制器

在 fleaphp 应用程序中，应用程序包含多个控制器。每一个控制器又提供一组控制器动作（后文及本系列文章中都简称为“动作”）。每一个浏览器发送给 fleaphp 应用程序的请求，都是由一个动作来处理的。将一组相关的动作集中到一起，就形成了一个控制器。

现在我们来实现第一个控制器：

创建 htdocs/app/controller 目录，并创建文件 htdocs/app/controller/default.php （注意严格匹配目录名和文件名的大小写），内容如下：

<?phpclass controller_default{    function actionindex() {        echo "my first controller.";    }}?>

同时修改 index.php 入口文件，内容改为：

<?phprequire('flea/flea.php');import(dirname(__file__) . '/app');run();?>

现在切换到浏览器，点击“刷新”按钮，可以看到 default.php 文件中的 actionindex 方法正确执行了。

从刚刚这个例子可以看到，每一个控制器实际上就是一个类，而一个动作则是该类的一个方法。

添加更多的动作

现在我们为这个控制器添加更多的 action 方法：

<?phpclass controller_default{    function actionindex() {        echo "my first controller.";    }    function actionsay() {        echo "oh, fleaphp great!";    }}?>

切换到浏览器，将浏览地址从 http://localhost/index.php 改为 http://localhost/index.php?action=say 并按回车键。可以看到输出内容改变了。

由此可见，action 参数的值决定了要调用控制器中的哪一个动作方法。在上面的例子中，action=say 时，调用的动作方法为 actionsay。因为 fleaphp 默认要求每一个动作方法必须加上前缀 action。如果不提供 action 参数，则名为 index 的动作方法 actionindex() 会被调用。

实现更多的控制器

创建新文件 htdocs/app/controller/book.php，并输入内容：

<?phpclass controller_book{    function actionindex() {        echo "book controller default action.";    }    function actionsaytitle() {        echo h("<< boost up with fleaphp >>");    }}?>

现在切换到浏览器，输入地址 http://localhost/index.php?controller=book&action=saytitle，并按回车键。可以看到我们成功的调用了另一个控制器的动作方法。

与使用 action 参数指定要调用的动作类似，用 controller 参数可以指定要调用的控制器。而此时 action 参数指定的就是该控制器的动作。