Phalcon之微应用（Micro Applications）

最新推荐文章于 2021-09-12 17:08:00 发布

风知前

最新推荐文章于 2021-09-12 17:08:00 发布

阅读量6.1k

点赞数 1

分类专栏： phalcon 文章标签： Phalcon文档 Phalcon中文

phalcon 专栏收录该内容

30 篇文章 0 订阅

订阅专栏

使用Phalcon框架开发者可以创建微框架应用。这样开发者只需要书写极少的代码即可创建一个PHP应用。微应用适用于书写小的应用， API或原型等

 
  <?php

$app = new Phalcon\Mvc\Micro();

$app->get('/say/welcome/{name}', function ($name) {
    echo "<h1>Welcome $name!</h1>";
});

$app->handle();

创建微应用（Creating a Micro Application）¶

Phalcon中使用 Phalcon\Mvc\Micro 来实现微应用。

 
   <?php

$app = new Phalcon\Mvc\Micro();

定义路由（Defining routes）¶

实例化后，开发者需要添加一些路由规则。 Phalcon内部使用 Phalcon\Mvc\Router 来管理路由。路由必须以 / 开头。定义路由时通常会书写http方法约束，这样路由规则只适用于那些和规则及htttp方法相匹配的路由。下面的方法展示了如何定义了HTTP get方法路由：

 
   <?php

$app->get('/say/hello/{name}', function ($name) {
    echo "<h1>Hello! $name</h1>";
});

get 方法指定了要匹配的请求方法。路由规则 /say/hello/{name} 中含有一个参数 {$name}, 此参数会直接传递给路由的处理器（此处为匿名函数）。路由规则匹配时处理器即会执行。处理器是PHP中任何可以被调用的项。下面的示例中展示了如何定义不同种类的处理器：

 
   <?php

//  函数
function say_hello($name) {
    echo "<h1>Hello! $name</h1>";
}

$app->get('/say/hello/{name}', "say_hello");

//  静态方法
$app->get('/say/hello/{name}', "SomeClass::someSayMethod");

//  对象内的方法
$myController = new MyController();
$app->get('/say/hello/{name}', array($myController, "someAction"));

// 匿名函数
$app->get('/say/hello/{name}', function ($name) {
    echo "<h1>Hello! $name</h1>";
});
 
  

Phalcon\Mvc\Micro 提供了一系列的用于定义http方法的限定方法：

 
   <?php

// 匹配http get 方法：
$app->get('/api/products', "get_products");

//匹配HTTP post方法
$app->post('/api/products/add', "add_product");

// 匹配http put 方法
$app->put('/api/products/update/{id}', "update_product");

// 匹配http delete方法
$app->delete('/api/products/remove/{id}', "delete_product");

// 匹配http options方法
$app->options('/api/products/info/{id}', "info_product");

// 匹配http patch方法
$app->patch('/api/products/update/{id}', "info_product");

// 匹配http get 或 post方法
$app->map('/repos/store/refs',"action_product")->via(array('GET', 'POST'));
 
  

路由参数（Routes with Parameters）¶

如上面的例子中展示的那样在路由中定义参数是非常容易的。参数名需要放在花括号内。参数格式亦可使用正则表达式以确保数据一致性。例子如下：

 
    <?php

// 此路由有两个参数每个参数有一格式
$app->get('/posts/{year:[0-9]+}/{title:[a-zA-Z\-]+}', function ($year, $title) {
    echo "<h1>Title: $title</h1>";
    echo "<h2>Year: $year</h2>";
});
 
   

起始路由（Starting Route）¶

通常情况下，应用一般由 / 路径开始访问，当然此访问多为 GET方法。这种情况代码如下：

 
    <?php

// 超始路由
$app->get('/', function () {
    echo "<h1>Welcome!</h1>";
});

重写规则（Rewrite Rules）¶

下面的规则用来实现apache重写：

 
    <IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteRule ^(.*)$ index.php?_url=/$1 [QSA,L]
</IfModule>
 
   

处理响应（Working with Responses）¶

开发者可以在路由处理器中设置任务种类的响应：直接输出，使用模板引擎，包含视图，返回json数据等。

 
   <?php

// 直接输出
$app->get('/say/hello', function () {
    echo "<h1>Hello! $name</h1>";
});

// 包含其它文件
$app->get('/show/results', function () {
    require 'views/results.php';
});

// 返回JSON
$app->get('/get/some-json', function () {
    echo json_encode(array("some", "important", "data"));
});
 
  

另外开发者还可以使用 “response” ，这样开发者可以更好的处理结果：

 
   <?php

$app->get('/show/data', function () use ($app) {

    // 设置返回头部内容格式
    $app->response->setContentType('text/plain')->sendHeaders();

    // 输出文件内容
    readfile("data.txt");

});

或回复response对象：

 
   <?php

$app->get('/show/data', function () {

    // 创建Response类实例
    $response = new Phalcon\Http\Response();

    //Set the Content-Type header 设置返回内容的类型
    $response->setContentType('text/plain');

    // 设置文件内容参数
    $response->setContent(file_get_contents("data.txt"));

    //返回response实例对象
    return $response;
});

重定向（Making redirections）¶

重定向用来在当前的处理中跳转到其它的处理流：

 
   <?php

// 此路由重定向到其它的路由
$app->post('/old/welcome', function () use ($app) {
    $app->response->redirect("new/welcome")->sendHeaders();
});

$app->post('/new/welcome', function () use ($app) {
    echo 'This is the new Welcome';
});
 
  

根据路由生成 URL（Generating URLs for Routes）¶

Phalcon中使用 Phalcon\Mvc\Url 来生成其它的基于路由的URL。开发者可以为路由设置名字，通过这种方式 “url” 服务可以产生相关的路由：

 
   <?php

// 设置名为 "show-post"的路由
$app->get('/blog/{year}/{title}', function ($year, $title) use ($app) {

    //.. show the post here

})->setName('show-post');

// 产生url
$app->get('/', function() use ($app) {

    echo '<a href="', $app->url->get(array(
        'for' => 'show-post',
        'title' => 'php-is-a-great-framework',
        'year' => 2012
    )), '">Show the post</a>';

});
 
  

与依赖注入的交互（Interacting with the Dependency Injector）¶

微应用中， Phalcon\DI\FactoryDefault 是隐含生成的，不过开发者可以明确的生成此类的实例以用来管理相关的服务：

 
   <?php

use Phalcon\DI\FactoryDefault,
    Phalcon\Mvc\Micro,
    Phalcon\Config\Adapter\Ini as IniConfig;

$di = new FactoryDefault();

$di->set('config', function() {
    return new IniConfig("config.ini");
});

$app = new Micro();

$app->setDI($di);

$app->get('/', function () use ($app) {
    //Read a setting from the config
    echo $app->config->app_name;
});

$app->post('/contact', function () use ($app) {
    $app->flash->success('Yes!, the contact was made!');
});
 
  

服务容器中可以使用数据类的语法来设置或取服务实例：

 
   <?php

use Phalcon\Mvc\Micro,
    Phalcon\Db\Adapter\Pdo\Mysql as MysqlAdapter;

$app = new Micro();

// 设置数据库服务实例
$app['db'] = function() {
    return new MysqlAdapter(array(
        "host" => "localhost",
        "username" => "root",
        "password" => "secret",
        "dbname" => "test_db"
    ));
};

$app->get('/blog', function () use ($app) {
    $news = $app['db']->query('SELECT * FROM news');
    foreach ($news as $new) {
        echo $new->title;
    }
});
 
  

处理Not-Found（Not-Found Handler）¶

当用户访问未定义的路由时，微应用会试着执行 “Not-Found”处理器。示例如下：

 
   <?php

$app->notFound(function () use ($app) {
    $app->response->setStatusCode(404, "Not Found")->sendHeaders();
    echo 'This is crazy, but this page was not found!';
});

微应用中的模型（Models in Micro Applications）¶

Phalcon中开发者可以直接使用 Models ，开发者只需要一个类自动加载器来加载模型：

 
   <?php

$loader = new \Phalcon\Loader();

$loader->registerDirs(array(
    __DIR__ . '/models/'
))->register();

$app = new \Phalcon\Mvc\Micro();

$app->get('/products/find', function(){

    foreach (Products::find() as $product) {
        echo $product->name, '<br>';
    }

});

$app->handle();

微应用中的事件（Micro Application Events）¶

当有事件发生时 Phalcon\Mvc\Micro 会发送事件到 EventsManager 。这里使用 “micro” 来绑定处理事件。支持如下事件：

事件名	如何触发	是否可中断执行
beforeHandleRoute	处理方法调用之前执行，此时应用程序还不知道是否存在匹配的路由	是
beforeExecuteRoute	存在匹配的路由及相关的处理器，不过处理器还未被执行	是
afterExecuteRoute	处理器执行之后触发	否
beforeNotFound	NotFound触发之前执行	是
afterHandleRoute	处理器执行之后执行	是

下面的例子中，我们阐述了如何使用事件来控制应用的安全性:

 
   <?php

use Phalcon\Mvc\Micro,
    Phalcon\Events\Manager as EventsManager;

// 创建事件监听器
$eventManager = new EventsManager();

// 监听应用的所有事件
$eventManager->attach('micro', function($event, $app) {

    if ($event->getType() == 'beforeExecuteRoute') {
        if ($app->session->get('auth') == false) {

            $app->flashSession->error("The user isn't authenticated");
            $app->response->redirect("/")->sendHeaders();

            // 返回false来中止操作
            return false;
        }
    }

});

$app = new Micro();

// 绑定事件管理器到应用
$app->setEventsManager($eventManager);
 
  

中间件事件（Middleware events）¶

此外，应用事件亦可使用 ‘before’, ‘after’, ‘finish’等来绑定：

 
   <?php

$app = new Phalcon\Mvc\Micro();

// 每个路由匹配之前执行
// 返回false来中止程序执行
$app->before(function() use ($app) {
    if ($app['session']->get('auth') == false) {
        return false;
    }
    return true;
});

$app->map('/api/robots', function(){
    return array(
        'status' => 'OK'
    );
});

$app->after(function() use ($app) {
    // 路由处理器执行后执行
    echo json_encode($app->getReturnedValue());
});

$app->finish(function() use ($app) {
    // 路由处理器执行后执行
});
 
  

开发者可以对同一事件注册多个处理器:

 
   <?php

$app->finish(function() use ($app) {
    // 第一个结束处理器
});

$app->finish(function() use ($app) {
    // 第二个结束处理器
});

把这些代码放在另外的文件中以达到重用的目的:

 
   <?php

use Phalcon\Mvc\Micro\MiddlewareInterface;

/**
 * CacheMiddleware
 *
 * 使用缓存来提升性能
 */
class CacheMiddleware implements MiddlewareInterface
{
    public function call($application)
    {

        $cache = $application['cache'];
        $router = $application['router'];

        $key = preg_replace('/^[a-zA-Z0-9]/', '', $router->getRewriteUri());

        // 检查请示是否被处理了
        if ($cache->exists($key)) {
            echo $cache->get($key);
            return false;
        }

        return true;
    }
}
 
  

添加实例到应用:

 
   <?php

$app->before(new CacheMiddleware());

支持如下的中间件事件：

事件名	触发	是否可中止操作?
before	应用请求处理之前执行，常用来控制应用的访问权限	Yes
after	请求处理后执行，可以用来准备回复内容	No
finish	发送回复内容后执行，可以用来执行清理工作	No

使用控制器处理（Using Controllers as Handlers）¶

中型的应用可以使用 Micro\Mvc 来组织控制器中的处理器。开发者也可以使用 Phalcon\Mvc\Micro\Collection 来对控制器中的处理器进行归组：

 
   <?php

use Phalcon\Mvc\Micro\Collection as MicroCollection;

$posts = new MicroCollection();

// 设置主处理器，这里是控制器的实例
$posts->setHandler(new PostsController());

// 对所有路由设置前缀
$posts->setPrefix('/posts');

//  使用PostsController中的index action
$posts->get('/', 'index');

// 使用PostController中的show action
$posts->get('/show/{slug}', 'show');

$app->mount($posts);

PostsController形如下：

 
   <?php

class PostsController extends Phalcon\Mvc\Controller
{

    public function index()
    {
        //...
    }

    public function show($slug)
    {
        //...
    }
}
 
  

上面的例子中，我们直接对控制器进行了实例化，使用集合时Phalcon会提供了迟加载的能力，这样程序只有在匹配路由时才加载控制器：

 
   <?php

$posts->setHandler('PostsController', true);
$posts->setHandler('Blog\Controllers\PostsController', true);

返回响应（Returning Responses）¶

处理器可能会返回原生的 Phalcon\Http\Response 实例或实现了相关接口的组件。当返回Response对象时，应用会自动的把处理结果返回到客户端。

 
   <?php

use Phalcon\Mvc\Micro,
    Phalcon\Http\Response;

$app = new Micro();

// 返回Response实例
$app->get('/welcome/index', function() {

    $response = new Response();

    $response->setStatusCode(401, "Unauthorized");

    $response->setContent("Access is not authorized");

    return $response;
});

渲染视图（Rendering Views）¶

Phalcon\Mvc\View\Simple 可用来渲染视图，示例如下：

 
   <?php

$app = new Phalcon\Mvc\Micro();

$app['view'] = function() {
    $view = new \Phalcon\Mvc\View();
    $view->setViewsDir('app/views/');
    return $view;
};

// 返回渲染过的视图
$app->get('/products/show', function() use ($app) {

    // 渲染视图时传递参数
    echo $app['view']->render('products/show', array(
        'id' => 100,
        'name' => 'Artichoke'
    ));

});
 
  