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 还是首选。
