phalcon 作為一個開源高性能的 PHP 框架，在國內其實挺小眾的，網上關于該框架的討論也不多，最近因為工作需要開始學習，寫一個極速的入門教程，希望能幫助到有需要的人。
安裝
phalcon 是 PHP 的一個 C 擴展，截止到目前 phalcon 的最新版本為 5.6，支持 php8.0 及以上版本，這里使用的是 pecl 安裝，安裝步驟如下：
pecl channel-update pecl.php.net
pecl install phalcon
編譯有點慢需要等待，安裝完成后，需要在 php.ini 中添加如下配置：
extension=phalcon.so
運行 php -m 查看是否安裝成功，如果有 phalcon 則表示安裝成功。
開發工具
phalcon 中的開發工具 devtools 是開發中常用的工具，類似于 laravel 中的 artisan，自帶了一些腳手架的功能，可以通過 composer 安裝：
composer require phalcon/devtools
從這里開始小坑不斷，首先是安裝完成后，按照官方文檔的指引輸入 phalcon 就可以啟動命令了，但是這里報報錯提示找不到 phalcon，原因是該命令位于 vendor/bin 目錄下，需要先到這個目錄下，再執行 php phalcon 才可以：
cd vendor/bin
php phalcon
這里可以看到 devtools 的版本號是 4.2 版本，和 phalcon5.6 的版本是不一致的，如果版本不一致，devtools 中的一些命令是無法執行的，比如給我們現在執行生成項目的命令：
php phalcon project store
會產生報錯 Uncaught Error: Class "Phalcon\Config" not found，這就是因為版本不一致導致的問題：
這個時候可以到 Packagist 上查看 devtools 的包信息，可以看到目前的正式發行版本就是 4.2，如果想安裝更高的版本需要使用它的開發版本，我們在這里選擇 5.0.x-dev 版本來和 phalcon 的大版本對齊：
刪除原先的舊版本依賴，在目錄中重新執行命令安裝 devtools：
composer require phalcon/devtools 5.0.x-dev
安裝完成后，再次按照上邊的步驟創建項目，這個時候就可以正常執行了：
最后還要解決一下 phalcon 命令的執行問題，畢竟不能每次都要進入 vendor/bin 目錄下才能執行命令，這里提供幾種方式解決：
1、設置命令別名，前邊的路徑替換成你自己的，該方式可以實現全局的效果：
alias phalcon="php /path/to/vendor/bin/phalcon"
2、在 composer.json 添加一個行配置，將路徑替換成自己，然后運行 composer install，這樣是將 vendor/bin 中的所有可執行文件都放到該目錄下，執行時前邊需要加 php：
"config": {
"bin-dir": "/pah/to/bin"
}
至此，phalcon 的安裝到一段落，接下來是創建項目開始使用。
創建項目
這里通過創建一個簡單的項目來學習 phalcon 的使用，首先使用 devtools 創建一個項目：
php phalcon project store
store/public/index.php 為項目的入口文件，完成了框架的引導工作，和 laravel 開箱即用不同的是，phalcon 因為是松耦合架構，所有的組件都是按需引入和加載的，需要自己去設置引導程序，這點和 laravel 相比會比較繁瑣，也拉高了學習門檻。
引導程序說明
引導過程主要包含以下幾個方面：
- 注冊自動加載器
- 注冊DI服務
- 處理請求
先說下注冊自動加載器，Phalcon\Autoload\Loader 類負責將指定目錄作為掃描路徑傳入加載器，這樣在項目運行時，這個文件才能被正常使用，方法為：
$loader = new Loader();
$loader->registerDirs([
'/path/to/controllerDir/',
'/path/to/modelDir/',
...
]);
$loader->register();
再說下注冊DI服務，DI 是依賴注入的縮寫，是 phalcon 的一個重要組件，它可以將服務注冊到容器中，然后在項目中通過容器來獲取服務，這樣可以實現解耦，提高代碼的可維護性，注冊服務的方法為：
$di = new FactoryDefault();
$di->set('db', function () {
return new DbAdapter([
'host' => 'localhost',
'username
上邊的 FactoryDefault() 是 Phalcon\Di\FactoryDefault 類的實例化，phalcon 為了使注入配置簡單，提供了一個默認標準配置。
最后說下處理請求，當所有的服務都注冊完成后，將DI容器當作參數傳遞給應用程序，應用程序實例調用 handle() 方法來處理請求，在整個請求的生命周期內，都可以直接使用DI容器中注冊的服務：
$application = new Application($container);
try {
$response = $application->handle($_SERVER["REQUEST_URI"]);
$response->send();
} catch (\Exception $e) {
echo 'Exception: ', $e->getMessage();
}
路由匹配
phalcon 的路由規則有兩種，一種是根據框架自動匹配程序，對控制器和方法進行解析，另一種是使用注解的形式，這里先說下第一種形式的路由配置：
- 框架自動解析，這種方式通過將 URI 解析后，自動匹配到對應的控制器和方法，控制器的命名需要嚴格按照駝峰命名+Controller 的規則，方法名需要使用駝峰命名+Action 的規則，并且自定義的控制類必須繼承 Phalcon\Mvc\Controller 類，例如：
class IndexController extends ControllerBase
{
public function indexAction()
{
echo 'Hello World!';
}
}
- 注解解析，phalcon 并沒有真正提供注解的功能，而是通過注釋的方式來實現，這種方式只需要在控制器類和方法上添加注釋，就可以實現路由的匹配，注解匹配生效需要兩步，第一先注冊組件 Phalcon\Mvc\Router\Annotations 到 DI 容器：
$di = new FactoryDefault();
$di->set('router', function () {
$router = new AnnotationsRouter();
$router->addResource('Index', '/admin/index');
return $router;
});
再將控制器中加上特定的注釋，這樣就可以實現路由的匹配：
/**
* @RoutePrefix("/admin/index")
*/
class IndexController extends ControllerBase
{
/**
* @Get("/home")
*/
public function indexAction()
{
echo 'Hello World!';
}
}
數據庫配置
在 store/config/config.php 中，配置數庫連接，這里使用的是 mysql 數據庫，配置完并把該配置文件注冊到 DI 容器中，在用 devtools 生成的項目中已還有注冊的代碼，這里只說明配置：
return new \Phalcon\Config\Config([
'database' => [
'adapter' => 'Mysql',
'host' => '連接地址',
'username' => '賬號',
'password' => '密碼',
'dbname' => '數庫名稱',
'charset' => 'utf8mb4',
],
...
]);
創建模型
phalcon 的模型用于和數據庫進行交互，可以用 devtools 工具來創建：
phalcon model user
這里需要注意的是，該命令需要數據庫連接成功，并且存在對應的表才能執行成功，model 后邊的參數為表名
模型的使用
模型創建成功會繼承 Phalcon\Mvc\Model 類，可以通過模型類來進行數據庫的增刪改查操作，例如：
$user = new User();
$user->find();
$user->findFirst([]);
總結
至此，phalcon 已基本入門，期間學習了基本的引導->請求->路由->控制器->模型->響應，進階的學習需要掌握 DI 容器、命名空間、服務的使用，總的來說 phalcon 的學習曲線較為陡峭，主要是安裝配置的過程比較繁瑣，對初學者不太友好。
我也通過 ab 測試對比了另外兩個框架 laravel、hyperf，就性能而言 laravel < phalcon < hyperf ，但是綜合國內的使用情況來看，laravel 和 hyperf 還是首選。
