Typecho Framework： Hello world!

fish 發(fā)布于2019-06-27 10:34 / 1128人閱讀

摘要：是所用的框架，本文將介紹如何用這個(gè)框架寫(xiě)一個(gè)程序。在目錄下建立目錄，并在其中創(chuàng)建文件首先我們定義一個(gè)命名空間，我們的程序使用為命名空間。入口程序這樣基本上就完成了。會(huì)自動(dòng)在目錄下找模板文件，約定大于配置。

Typecho Framework是SegmentFault所用的框架，本文將介紹如何用這個(gè)框架寫(xiě)一個(gè)Hello World程序。如果你不了解Typecho Framework，請(qǐng)先看這篇簡(jiǎn)介。

輸出Hello World!

首先我們創(chuàng)建Hello World程序的目錄：

mkdir ~/hellow-world

Typecho Framework簡(jiǎn)介中提到

  Action從Service獲取所需數(shù)據(jù)后，傳遞result給Server的響應(yīng)對(duì)象。

Hello World!不需要獲取數(shù)據(jù)，所以我們直接讓Action返回一個(gè)result即可。

在hello-world目錄下建立app/Action/目錄，并在其中創(chuàng)建Hello.php文件：

namespace HelloAction;

首先我們定義一個(gè)命名空間，我們的程序使用Hello為命名空間。

這是一個(gè)Action，所以我們需要繼承Action的類(lèi)，翻一下框架的源代碼，找到這樣一個(gè)文件Mvc/Action/AbstractAction.php,那我們就繼承AbstractAction這個(gè)類(lèi)好了：

use TEMvcActionAbstractAction;

/**
 * Hello
 *
 * @use AbstractAction
 */

class Hello extends AbstractAction
{
// 待填充
}

我們看到Mvc/Action/AbstractAction.php里有這樣一行代碼：

abstract public function execute();

這就告訴我們，需要在自己的類(lèi)中實(shí)現(xiàn)這個(gè)execute方法。我們實(shí)現(xiàn)一下這個(gè)方法，返回一個(gè)result數(shù)組。這時(shí)我們參考下Typecho Framework的示例代碼,發(fā)現(xiàn)它是這么寫(xiě)的：

public function execute()
    {
        // 只要你把Action的屬性設(shè)置為public狀態(tài)，它就會(huì)被注入到模板中，你可以直接在模板中使用它們
        $this->word = "Hello World";
        $this->peoples = new People($this->peopleService->listNewest(1, 20));
        $this->master = new People($this->peopleService->getByName("joyqi"));   // 不論你取出一行還是多行數(shù)據(jù)，都可以塞到Data對(duì)象中進(jìn)行處理

        return array("template", "index.php");
    }

嗯，看這行代碼的意思，應(yīng)該是指定返回的result使用模板（index.php是模板文件的名稱）。那么我們不用模板，直接返回一個(gè)字符串應(yīng)該怎么寫(xiě)呢？

繼續(xù)翻源代碼，發(fā)現(xiàn)Mvc/View目錄下是這樣的結(jié)構(gòu)：

AbstractView.php

Back.php

Blank.php

Content.php

Error.php

Json.php

Jsonp.php

NotFound.php

Redirect.php

Template.php

嗯，我們返回Hello World!，不用模板，也不用什么Json，那么應(yīng)該是Content了。點(diǎn)進(jìn)去一看，果然是這個(gè)：

/**
 * 渲染一個(gè)字符串
 *

好了，知道了result數(shù)組要用content后，我們來(lái)完成這個(gè)方法的定義：

class Hello extends AbstractAction
{
  public function execute()
  {
    return array("content", "Hello World!");
  }
}

路由

好了，Action部分已經(jīng)搞定，接下來(lái)我們綁定一下路由。參考示例代碼，我們新建一個(gè)config目錄，然后創(chuàng)建routes.php，內(nèi)容如下：


return [
  "/Hello" => "HelloActionHello",
];

路由設(shè)置很簡(jiǎn)單，就是返回一個(gè)數(shù)組，將路徑綁定到相應(yīng)的類(lèi)。

入口程序

這樣基本上就完成了。還剩下一個(gè)入口程序了。示例代碼的README中提到：

直接在瀏覽器里輸入http://app-root/portal/index.php即可, 其中app-root是你的程序目錄

所以說(shuō)portal/index.php就是入口程序。這里我們直接在hello-world目錄下面創(chuàng)立一個(gè)index.php文件作為入口，參考示例程序的寫(xiě)法，我們的文件內(nèi)容如下：

const ROOT = __DIR__;

require_once ROOT . "/typecho/Helper/Autoloader.php";

首先我們加載Autoloader，通過(guò)這個(gè)Autoloader來(lái)初始化程序：

use TEHelperAutoloader;
use TEMvcBase;
use TEMvcServerHttpServer;
use TEMvcRouterSimple;


Autoloader::registerNamespace(ROOT . "/typecho", "TE");
Autoloader::registerNamespace(ROOT . "/app", "Hello");

注冊(cè)命名空間，第一個(gè)參數(shù)是路徑，第二個(gè)參數(shù)是命名空間的名稱。

我們把框架放在typecho目錄下。如果你還沒(méi)有下載框架代碼，可以克隆一下倉(cāng)庫(kù)：

cd ~/hello-world
git clone https://github.com/typecho/framework typecho

new Server(new Simple(require(ROOT . "/config/routes.php")));

啟動(dòng)服務(wù)，指定配置文件的路徑。

然后在hello-world目錄下運(yùn)行：

php -S 127.0.0.1:8000/Hello

訪問(wèn) http://127.0.0.1:8000，發(fā)現(xiàn)有問(wèn)題，說(shuō)是Server需要兩個(gè)參數(shù)，現(xiàn)在只有一個(gè)，缺少了一個(gè)InterceptorManager。

缺的是攔截器，所以我們就把上面的代碼改一下：

new Server(new Simple(require(ROOT . "/config/routes.php")),
  new InterceptorManager(require(ROOT . "/config/interceptors.php")));

然后config/interceptors.php里返回一個(gè)空數(shù)組（因?yàn)槲覀儸F(xiàn)在不需要用到攔截器）：

return array();

大功告成！訪問(wèn) http://127.0.0.1:8000/Hello 就能看到輸出的 Hello world!

模板

上面是直接輸出字符串，接下來(lái)我們使用模板輸出.

先在路由里增加一條：

return [
  "/Hello" => "HelloActionHello",
  "/Hi" => "HelloActionHi"
];

我們打算訪問(wèn)/Hi通過(guò)模板輸出。

然后是實(shí)現(xiàn)Hi類(lèi)，創(chuàng)建app/Action/Hi.php，內(nèi)容如下：

namespace HelloAction;

use TEMvcActionAbstractAction;

/**
 * Hi
 *
 * @use AbstractAction
 */

class Hi extends AbstractAction
{
  public function execute()
  {
    $this->msg = "Hi!";
    return array("template", "hi.php");
  }
}

我們定義了$this->msg，在模板中可以直接使用這個(gè)變量。

最后是定義hi.php模板。我們創(chuàng)建一個(gè)template目錄：