构建自己的PHP框架 02 --抽象框架的内容

上一篇博客中，我们搭建了一个最简单的框架，从单一入口的public/index.php进入，解析出相应的Controller和Action，去执行，渲染出相应的页面或者输出相应的数据。

但是我们可以看到在public/index.php文件中，是一堆代码，如果之后，我要添加权限/事件等等的机制是不是也要也在这里，那不难想象，不就的将来，index.php就会变成一个巨大无比的php文件。我们当然不想看到这样的情景，所以我们需要将这些内容抽象出来，保持入口文件的简单明了。

那我们要将这些内容抽象到那里去呢？有聪明的同学已经想到了，就是之前在composer.json中定义的位置，我们来看一下composer.json文件：

{
    "name": "craryprimitiveman/simple-framework",
    "description": "A simple php framework",
    "license": "MIT",
    "authors": [
        {
            "name": "harrysun",
            "email": "sunguangjun@126.com"
        }
    ],
    "require": {},
    "autoload": {
        "psr-4": {
            "sf\\": "src/",
            "app\\": ""
        }
    },
    "repositories": [
        {"type": "composer", "url": "http://packagist.phpcomposer.com"},
        {"packagist": false}
    ]
}

可以看到autoload里的psr-4里还有个sf\，他的地址是src/，这就是我们要放抽象出的内容的地方。

有人会问，为什么不直接使用app\ 作为namespace呢？因为想到之后要将src下的内容做成一个composer包，迁移到vendor中。

下面就正式开始抽象了。

在src下创建两个文件夹，一个是base，一个是web。base用来存放基础的类，web用来存放与web相关的类。因为将来框架可能还要支持php脚本的执行，所以要将base和web分开，将来要加php脚本时，只需要建立一个console的文件夹就好了。

在两个文件夹中分别建立Application.php文件。

先来看在base里的Application.php

<?php
namespace sf\base;

use Exception;

/**
 * Application is the base class for all application classes.
 * @author Harry Sun <sunguangjun@126.com>
 */
abstract class Application
{
    /**
     * @var string the namespace that controller classes are located in.
     * This namespace will be used to load controller classes by prepending it to the controller class name.
     * The default namespace is `app\controllers`.
     */
    public $controllerNamespace = 'app\\controllers';

    /**
     * Runs the application.
     * This is the main entrance of an application.
     */
    public function run()
    {
        try {
            return $this->handleRequest();
        } catch (Exception $e) {
            return $e;
        }
    }

    /**
     * Handles the specified request.
     */
    abstract public function handleRequest();
}

它是一个抽象类，实现了一个简单的run方法，run方法就是去执行以下handleRequest方法。

它定义了一个抽象方法handleRequest，等待被继承，实现。

它定义了一个controllerNamespace属性，记录controller存放的namesapce，默认值是'app\controllers'。

再来看在web里的Application.php

<?php
namespace sf\web;

/**
 * Application is the base class for all application classes.
 * @author Harry Sun <sunguangjun@126.com>
 */
class Application extends \sf\base\Application
{
    /**
     * Handles the specified request.
     * @return Response the resulting response
     */
    public function handleRequest()
    {
        $router = $_GET['r'];
        list($controllerName, $actionName) = explode('/', $router);
        $ucController = ucfirst($controllerName);
        $controllerName = $this->controllerNamespace . '\\' . $ucController . 'Controller';
        $controller = new $controllerName();
        return call_user_func([$controller, 'action'. ucfirst($actionName)]);
    }
}

是不是觉得很眼熟，其实就是将之前放在index.php中的内容放到Application的handleRequest方法里了。

然后我们需要从入口文件调用到这里的代码，这就很简单了，index.php的内容如下：

<?php
require_once(__DIR__ . '/../vendor/autoload.php');

$application = new sf\web\Application();
$application->run();

直接去new一个web Application的实例，执行run方法就可以了，是不是很简单。

访问 http://localhost/simple-framework/public/index.php?r=site/test ，你可以看到上一次一样的结果。

好了，今天就先到这里。项目内容和博客内容也都会放到Github上，欢迎大家提建议。

code：https://github.com/CraryPrimitiveMan/simple-framework/tree/0.2

blog project：https://github.com/CraryPrimitiveMan/create-your-own-php-framework