摘要：原文發(fā)表于入門教程之模型提供了四種方式操作數(shù)據(jù)庫模型數(shù)據(jù)庫抽象層以及原生。創(chuàng)建模型模型類的命名必須符合駝峰命名法，而且須繼承自類文件路徑繼承自類。

原文發(fā)表于：Phalcon入門教程之模型

Phalcon 提供了四種方式操作Mysql數(shù)據(jù)庫：模型、PHQL、數(shù)據(jù)庫抽象層以及原生SQL。不論何種方式，首先都需要在DI中注冊 db 服務(wù)才能正常使用：

//  文件路徑：app/core/services.php
$di -> setShared("db", function () use($config) {
    $dbconfig = $config -> database -> db;
    $dbconfig = $dbconfig -> toArray();
    if (!is_array($dbconfig) || count($dbconfig)==0) {
        throw new Exception("the database config is error");
    }
    $connection = new PhalconDbAdapterPdoMysql(array(
        "host" => $dbconfig["host"], "port" => $dbconfig["port"],
        "username" => $dbconfig["username"],
        "password" => $dbconfig["password"],
        "dbname" => $dbconfig["dbname"],
        "charset" => $dbconfig["charset"])
    );
    return $connection;
});

數(shù)據(jù)庫連接信息配置如下：

// 文件路徑：app/config/system.php
return array(
    //數(shù)據(jù)庫表配置
    "database" => array(
        //數(shù)據(jù)庫連接信息
        "db" => array(
            "host" => "127.0.0.1",
            "port" => 3306,
            "username" => "admin",
            "password" => "admin",
            "dbname" => "test",
            "charset" => "utf8",
        ),

        //表前綴
        "prefix" => "test_",
    ),
);

在我們開發(fā)過程中，有時候需要通過SQL語句來分析定位問題。那么，我們需要將ORM生成的底層SQL記錄到日志中。修改DI中注冊的 db 服務(wù)如下：

//文件路徑：app/core/services.php
$di -> setShared("db", function () use($config) {
    $dbconfig = $config -> database -> db;
    $dbconfig = $dbconfig -> toArray();
    if (!is_array($dbconfig) || count($dbconfig)==0) {
        throw new Exception("the database config is error");
    }
    $eventsManager = new PhalconEventsManager();
    // 分析底層sql性能，并記錄日志
    $profiler = new PhalconDbProfiler();
    $eventsManager -> attach("db", function ($event, $connection) use ($profiler) {
        if($event -> getType() == "beforeQuery"){
            //在sql發(fā)送到數(shù)據(jù)庫前啟動分析
            $profiler -> startProfile($connection -> getSQLStatement());
        }
        if($event -> getType() == "afterQuery"){
            //在sql執(zhí)行完畢后停止分析
            $profiler -> stopProfile();
            //獲取分析結(jié)果
            $profile = $profiler -> getLastProfile();
            $sql = $profile->getSQLStatement();
            $params = $connection->getSqlVariables();
            (is_array($params) && count($params)) && $params = json_encode($params);
            $executeTime = $profile->getTotalElapsedSeconds();
            //日志記錄
            $currentDay = date("Ymd");
            $logger = new PhalconLoggerAdapterFile(ROOT_PATH . "/app/cache/logs/{$currentDay}.log");
            $logger -> debug("{$sql} {$params} {$executeTime}");
        }
    });

    $connection = new PhalconDbAdapterPdoMysql(array(
        "host" => $dbconfig["host"], "port" => $dbconfig["port"],
        "username" => $dbconfig["username"],
        "password" => $dbconfig["password"],
        "dbname" => $dbconfig["dbname"],
        "charset" => $dbconfig["charset"])
    );

    /* 注冊監(jiān)聽事件 */
    $connection->setEventsManager($eventsManager);

    return $connection;
});

通過代碼可以看到，不僅是底層SQL，還將SQL綁定的參數(shù)（PDO預(yù)處理）和SQL執(zhí)行時間也記錄到日志中了。日志記錄demo如下：

SELECT `users`.`uid` AS `uid`, `users`.`mobile` AS `mobile` FROM `users` WHERE `users`.`uid` = :uid LIMIT :APL0 {"uid":1,"APL0":1} 0.034402132034302

花括號（{}）中的就是SQL預(yù)處理時綁定的參數(shù)，最后的浮點(diǎn)數(shù)就是SQL執(zhí)行時間（單位為秒）。

模型類的命名必須符合駝峰命名法，而且須繼承自 PhalconMvcModel 類：

// 文件路徑：app/frontend/models/ArticlesModel.php
class Articles extends MarserAppFrontendModelsBaseModel {
    // MarserAppFrontendModelsBaseModel繼承自 PhalconMvcModel 類。
    // 此處是再次封裝一個基礎(chǔ)模型類，  以方便后續(xù)的通用方法封裝
    //...
}

默認(rèn)情況下，Articles 模型類對應(yīng)的數(shù)據(jù)表名是 articles ；若是 ArticlesTags 模型類，則對應(yīng)的數(shù)據(jù)庫表名是 articles_tags ， 即類名對應(yīng)著表名。如果想映射到其他數(shù)據(jù)庫表，可以使用 setSource() 方法設(shè)置：

// 文件路徑：app/frontend/models/ArticlesModel.php
class Articles extends MarserAppFrontendModelsBaseModel {
  public function initialize()
    {
        $this->setSource("articles_tags");
    }
}

在項(xiàng)目開發(fā)中，建議一個數(shù)據(jù)表對應(yīng)著一個模型類。即使是關(guān)聯(lián)表，也強(qiáng)烈建議創(chuàng)建其對應(yīng)的模型類，因?yàn)?Phalcon 中提供的連表操作，都是基于模型類的（后續(xù)的教程會分享）。

在進(jìn)行數(shù)據(jù)庫表設(shè)計(jì)的時候，有時會在表名前加上一段前綴，如 test_articles 。我們依然可以通過 setSource() 映射數(shù)據(jù)表：

// 文件路徑：app/frontend/models/ArticlesModel.php
class Articles extends MarserAppFrontendModelsBaseModel {
  public function initialize()
    {
        $this->setSource("test_articles");
    }
}

假設(shè)，我們的項(xiàng)目中有100張數(shù)據(jù)表，那么就意味著有100個模型類。此時我們在每個模型類中都必須調(diào)用 setSource() 來映射完整的表名。如果某天我們需要修改這100張表的前綴，那么將要修改這100個模型類，不僅耗時耗力還麻煩。我們嘗試著將此處理過程提取出來進(jìn)行封裝：

// 文件路徑： app/frontend/models/ArticlesModel.php
class ArticlesModel extends MarserAppFrontendModelsBaseModel {

    /**
     * 表名
     */
    const TABLE_NAME = "articles";

    public function initialize(){
        parent::initialize();
        //映射數(shù)據(jù)表（補(bǔ)上表前綴）
        $this->set_table_source(self::TABLE_NAME);
    }
}

在 BaseModel 模型基類中的 set_table_source() 方法定義如下：

// 文件路徑： app/frontend/models/BaseModel.php
class BaseModel extends PhalconMvcModel {

    public function initialize(){

    }

    /**
     * 映射數(shù)據(jù)表（補(bǔ)上表前綴）
     * @param string $tableName
     * @param null $prefix
     */
    protected function set_table_source($tableName, $prefix = null){
        //默認(rèn)從配置中讀取表前綴配置
        empty($prefix) && $prefix = $this->getDI()->get("config")->database->prefix;
        //拼接成完整表名之后，再通過setSource()映射數(shù)據(jù)表
        $this->setSource($prefix . $tableName);
    }
}

我們在每個模型類中定義一個 類常量 來存儲無前綴的表名，再通過 set_table_source() 成員方法來拼接表前綴并映射。眼尖的讀者，應(yīng)該在上面的數(shù)據(jù)庫連接信息配置中有看到 prefix 的表前綴配置。
還是以上面為例，此時我們就不需要修改100個模型類的代碼，而只需修改配置文件中的 prefix 配置即可。

以上代碼已托管在github：https://github.com/KevinJay/m...

最后，歡迎大家加入QQ群交流討論：

廣州PHP高端交流群：158587573

Phalcon玩家群：150237524