phalcon 作為一個(gè)開(kāi)源高性能的 PHP 框架，在國(guó)內(nèi)其實(shí)挺小眾的，網(wǎng)上關(guān)于該框架的討論也不多，最近因?yàn)楣ぷ餍枰_(kāi)始學(xué)習(xí)，寫一個(gè)極速的入門教程，希望能幫助到有需要的人。

安裝

phalcon 是 PHP 的一個(gè) C 擴(kuò)展，截止到目前 phalcon 的最新版本為 5.6，支持 php8.0 及以上版本，這里使用的是 pecl 安裝，安裝步驟如下：

pecl channel-update pecl.php.net
pecl install phalcon

編譯有點(diǎn)慢需要等待，安裝完成后，需要在 php.ini 中添加如下配置：

extension=phalcon.so

運(yùn)行 php -m 查看是否安裝成功，如果有 phalcon 則表示安裝成功。

開(kāi)發(fā)工具

phalcon 中的開(kāi)發(fā)工具 devtools 是開(kāi)發(fā)中常用的工具，類似于 laravel 中的 artisan，自帶了一些腳手架的功能，可以通過(guò) composer 安裝：

composer require phalcon/devtools

從這里開(kāi)始小坑不斷，首先是安裝完成后，按照官方文檔的指引輸入 phalcon 就可以啟動(dòng)命令了，但是這里報(bào)報(bào)錯(cuò)提示找不到 phalcon，原因是該命令位于 vendor/bin 目錄下，需要先到這個(gè)目錄下，再執(zhí)行 php phalcon 才可以：

cd vendor/bin
php phalcon

屏幕截圖 2024-03-12 104037.png

這里可以看到 devtools 的版本號(hào)是 4.2 版本，和 phalcon5.6 的版本是不一致的，如果版本不一致，devtools 中的一些命令是無(wú)法執(zhí)行的，比如給我們現(xiàn)在執(zhí)行生成項(xiàng)目的命令：

php phalcon project store

會(huì)產(chǎn)生報(bào)錯(cuò) Uncaught Error: Class "Phalcon\Config" not found，這就是因?yàn)榘姹静灰恢聦?dǎo)致的問(wèn)題：

屏幕截圖 2024-03-12 104538.png

這個(gè)時(shí)候可以到 Packagist 上查看 devtools 的包信息，可以看到目前的正式發(fā)行版本就是 4.2，如果想安裝更高的版本需要使用它的開(kāi)發(fā)版本，我們?cè)谶@里選擇 5.0.x-dev 版本來(lái)和 phalcon 的大版本對(duì)齊：

屏幕截圖 2024-03-12 104858.png

刪除原先的舊版本依賴，在目錄中重新執(zhí)行命令安裝 devtools：

composer require phalcon/devtools 5.0.x-dev

安裝完成后，再次按照上邊的步驟創(chuàng)建項(xiàng)目，這個(gè)時(shí)候就可以正常執(zhí)行了：

屏幕截圖 2024-03-12 105757.png

最后還要解決一下 phalcon 命令的執(zhí)行問(wèn)題，畢竟不能每次都要進(jìn)入 vendor/bin 目錄下才能執(zhí)行命令，這里提供幾種方式解決：
1、設(shè)置命令別名，前邊的路徑替換成你自己的，該方式可以實(shí)現(xiàn)全局的效果：

alias phalcon="php /path/to/vendor/bin/phalcon"

2、在 composer.json 添加一個(gè)行配置，將路徑替換成自己，然后運(yùn)行 composer install，這樣是將 vendor/bin 中的所有可執(zhí)行文件都放到該目錄下，執(zhí)行時(shí)前邊需要加 php：

"config": {
        "bin-dir": "/pah/to/bin"
    }

至此，phalcon 的安裝到一段落，接下來(lái)是創(chuàng)建項(xiàng)目開(kāi)始使用。

創(chuàng)建項(xiàng)目

這里通過(guò)創(chuàng)建一個(gè)簡(jiǎn)單的項(xiàng)目來(lái)學(xué)習(xí) phalcon 的使用，首先使用 devtools 創(chuàng)建一個(gè)項(xiàng)目：

php phalcon project store

store/public/index.php 為項(xiàng)目的入口文件，完成了框架的引導(dǎo)工作，和 laravel 開(kāi)箱即用不同的是，phalcon 因?yàn)槭撬神詈霞軜?gòu)，所有的組件都是按需引入和加載的，需要自己去設(shè)置引導(dǎo)程序，這點(diǎn)和 laravel 相比會(huì)比較繁瑣，也拉高了學(xué)習(xí)門檻。

引導(dǎo)程序說(shuō)明

引導(dǎo)過(guò)程主要包含以下幾個(gè)方面：

• 注冊(cè)自動(dòng)加載器
• 注冊(cè)DI服務(wù)
• 處理請(qǐng)求

先說(shuō)下注冊(cè)自動(dòng)加載器，Phalcon\Autoload\Loader 類負(fù)責(zé)將指定目錄作為掃描路徑傳入加載器，這樣在項(xiàng)目運(yùn)行時(shí)，這個(gè)文件才能被正常使用，方法為：

$loader = new Loader();
$loader->registerDirs([
    '/path/to/controllerDir/',
    '/path/to/modelDir/',
    ...
]);

$loader->register();

再說(shuō)下注冊(cè)DI服務(wù)，DI 是依賴注入的縮寫，是 phalcon 的一個(gè)重要組件，它可以將服務(wù)注冊(cè)到容器中，然后在項(xiàng)目中通過(guò)容器來(lái)獲取服務(wù)，這樣可以實(shí)現(xiàn)解耦，提高代碼的可維護(hù)性，注冊(cè)服務(wù)的方法為：

$di = new FactoryDefault();
$di->set('db', function () {
    return new DbAdapter([
        'host' => 'localhost',
        'username

上邊的 FactoryDefault() 是 Phalcon\Di\FactoryDefault 類的實(shí)例化，phalcon 為了使注入配置簡(jiǎn)單，提供了一個(gè)默認(rèn)標(biāo)準(zhǔn)配置。

最后說(shuō)下處理請(qǐng)求，當(dāng)所有的服務(wù)都注冊(cè)完成后，將DI容器當(dāng)作參數(shù)傳遞給應(yīng)用程序，應(yīng)用程序?qū)嵗{(diào)用 handle() 方法來(lái)處理請(qǐng)求，在整個(gè)請(qǐng)求的生命周期內(nèi)，都可以直接使用DI容器中注冊(cè)的服務(wù)：

$application = new Application($container);

try {
    $response = $application->handle($_SERVER["REQUEST_URI"]);
    $response->send();
} catch (\Exception $e) {
    echo 'Exception: ', $e->getMessage();
}

路由匹配

phalcon 的路由規(guī)則有兩種，一種是根據(jù)框架自動(dòng)匹配程序，對(duì)控制器和方法進(jìn)行解析，另一種是使用注解的形式，這里先說(shuō)下第一種形式的路由配置：

• 框架自動(dòng)解析，這種方式通過(guò)將 URI 解析后，自動(dòng)匹配到對(duì)應(yīng)的控制器和方法，控制器的命名需要嚴(yán)格按照駝峰命名+Controller 的規(guī)則，方法名需要使用駝峰命名+Action 的規(guī)則，并且自定義的控制類必須繼承 Phalcon\Mvc\Controller 類，例如：

class IndexController extends ControllerBase
{
    public function indexAction()
    {
        echo 'Hello World!';
    }
}

• 注解解析，phalcon 并沒(méi)有真正提供注解的功能，而是通過(guò)注釋的方式來(lái)實(shí)現(xiàn)，這種方式只需要在控制器類和方法上添加注釋，就可以實(shí)現(xiàn)路由的匹配，注解匹配生效需要兩步，第一先注冊(cè)組件 Phalcon\Mvc\Router\Annotations 到 DI 容器：

$di = new FactoryDefault();
$di->set('router', function () {
    $router = new AnnotationsRouter();
    $router->addResource('Index', '/admin/index');
    return $router;
});

再將控制器中加上特定的注釋，這樣就可以實(shí)現(xiàn)路由的匹配：

/**
 * @RoutePrefix("/admin/index")
 */
class IndexController extends ControllerBase
{
    /**
     * @Get("/home")
     */
    public function indexAction()
    {
        echo 'Hello World!';
    }
}

數(shù)據(jù)庫(kù)配置

在 store/config/config.php 中，配置數(shù)庫(kù)連接，這里使用的是 mysql 數(shù)據(jù)庫(kù)，配置完并把該配置文件注冊(cè)到 DI 容器中，在用 devtools 生成的項(xiàng)目中已還有注冊(cè)的代碼，這里只說(shuō)明配置：

return new \Phalcon\Config\Config([
    'database' => [
        'adapter'     => 'Mysql',
        'host'        => '連接地址',
        'username'    => '賬號(hào)',
        'password'    => '密碼',
        'dbname'      => '數(shù)庫(kù)名稱',
        'charset'     => 'utf8mb4',
    ],
    ...
]);

創(chuàng)建模型

phalcon 的模型用于和數(shù)據(jù)庫(kù)進(jìn)行交互，可以用 devtools 工具來(lái)創(chuàng)建：

phalcon model user

這里需要注意的是，該命令需要數(shù)據(jù)庫(kù)連接成功，并且存在對(duì)應(yīng)的表才能執(zhí)行成功，model 后邊的參數(shù)為表名

模型的使用

模型創(chuàng)建成功會(huì)繼承 Phalcon\Mvc\Model 類，可以通過(guò)模型類來(lái)進(jìn)行數(shù)據(jù)庫(kù)的增刪改查操作，例如：

$user = new User();
$user->find();

$user->findFirst([]);

總結(jié)

至此，phalcon 已基本入門，期間學(xué)習(xí)了基本的引導(dǎo)->請(qǐng)求->路由->控制器->模型->響應(yīng)，進(jìn)階的學(xué)習(xí)需要掌握 DI 容器、命名空間、服務(wù)的使用，總的來(lái)說(shuō) phalcon 的學(xué)習(xí)曲線較為陡峭，主要是安裝配置的過(guò)程比較繁瑣，對(duì)初學(xué)者不太友好。

我也通過(guò) ab 測(cè)試對(duì)比了另外兩個(gè)框架 laravel、hyperf，就性能而言 laravel < phalcon < hyperf ，但是綜合國(guó)內(nèi)的使用情況來(lái)看，laravel 和 hyperf 還是首選。