在 Linux 环境下安装 Phalcon 框架的核心在于配置好 PHP 开发环境，通过安装 Zephir 语言编译器或直接使用 PECL 安装预编译的 Phalcon 扩展，并将其在 php.ini 中启用。
Phalcon 5.0 安装环境要求
安装 Phalcon 之前，必须确保系统环境满足其底层依赖，由于 Phalcon 是用 C 语言编写的 PHP 扩展，它对编译环境的要求比纯 PHP 框架高得多。
基础依赖软件包
在大多数 Linux 发行版中，你需要安装以下基础构建工具：
- GCC/G++：用于编译 C 代码。
- Make：构建自动化工具。
- Autoconf：自动生成配置脚本。
- PHP-Dev：包含 phpize 和 php-config，这是安装任何 PHP 扩展的前提。
PHP 版本兼容性
Phalcon 5.x 版本要求 PHP 8.0 或更高版本，如果你的服务器仍在使用 PHP 7.4，则只能安装 Phalcon 4.x。
| 组件 | Phalcon 4.x 要求 | Phalcon 5.x 要求 |
|---|---|---|
| PHP 版本 | PHP 7.2 – 7.4 | PHP 8.0 – 8.3 |
| 编译器 | GCC 4.8+ | GCC 7.0+ |
| 关键依赖 | php-devel / php-pear | php-devel / php-pear |
| 运行模式 | FPM / Apache Mod | FPM / Apache Mod |
Ubuntu 22.04 安装 Phalcon 5 详细步骤
在 Ubuntu 系统上，最稳妥的安装方式是通过 PECL 或是从源码编译，这里推荐使用 PECL，因为它能自动处理大部分依赖关系。
更新系统并安装依赖
确保软件包列表是最新的,并安装必要的开发库。
- 执行
sudo apt update更新索引。 - 安装构建工具：
sudo apt install build-essential php-dev php-pear。 - 安装必要的库：
sudo apt install libpcre3-dev。
使用 PECL 安装 Phalcon 扩展
PECL 是 PHP 扩展库的标准管理工具，可以极大简化安装流程。
- 运行命令：
sudo pecl install phalcon
。
- 在安装过程中,系统可能会提示你确认某些配置选项，通常直接按回车选择默认值即可。
- 安装完成后,终端会输出
install ok以及扩展文件的安装路径（通常在/usr/lib/php/202x.../phalcon.so）。
配置 PHP 启用扩展
安装完二进制文件后,PHP 并不会自动加载它，需要手动修改配置文件。
- 找到
php.ini路径：执行php --ini查看加载的配置文件。 - 编辑文件：
sudo nano /etc/php/8.x/cli/php.ini（根据具体版本修改路径）。 - 在文件末尾添加：
extension=phalcon。 - 如果是使用 FPM 模式，还需修改
/etc/php/8.x/fpm/php.ini。 - 重启服务：
sudo systemctl restart php8.x-fpm或sudo systemctl restart apache2。
验证安装状态
使用命令行检查扩展是否成功加载。
- 执行
php -m | grep phalcon。 - 如果输出
phalcon字样，说明安装成功。 - 执行
php -v确认 PHP 版本与扩展版本匹配。
CentOS 7 安装 Phalcon 扩展报错怎么解决
CentOS 7 由于内核和基础库版本较低，在安装 Phalcon 时经常会遇到 phpize 找不到或 gcc 版本过低的问题。
解决 phpize 缺失问题
很多用户在执行 pecl install 时会遇到 phpize: command not found。
- 原因是缺少
php-devel包。 - 解决方法：执行
sudo yum install php-devel php-pear。 - 如果使用的是 Remi 仓库的 PHP，请安装对应版本的开发包，
sudo yum install php81-php-devel。
解决 GCC 版本过低导致的编译失败
Phalcon 5 使用了较新的 C 标准，CentOS 7 默认的 GCC 4.8.5 无法编译。
- 业内专家指出,此时必须通过 SCL (Software Collections) 安装高版本 GCC。
- 安装 SCL：
sudo yum install centos-release-scl。 - 安装 GCC 9：
sudo yum install devtoolset-9-gcc devtoolset-9-gcc-c++。 - 激活环境：
sclo enable devtoolset-9 bash。 - 在激活该环境的终端中重新执行
pecl install phalcon。
处理内存不足导致的编译中断
在 1GB 内存的 VPS 上编译 Phalcon 经常会出现 collect2: fatal error: ld terminated with signal 9 [Killed]
。
- 原因是内存溢出,导致编译器被系统杀死。
- 解决方法：创建临时交换分区（Swap）。
- 执行
sudo dd if=/dev/zero of=/swapfile bs=1M count=2048。 - 执行
sudo chmod 600 /swapfile。 - 执行
sudo mkswap /swapfile。 - 执行
sudo swapon /swapfile。 - 编译完成后,使用
sudo swapoff /swapfile关闭即可。
Phalcon 框架与 Laravel 性能对比
选择 Phalcon 的核心原因通常是性能，与 Laravel 这种纯 PHP 编写的框架不同，Phalcon 采用了完全不同的架构。
架构差异
- Laravel：在每次请求时，需要加载大量的 PHP 文件到内存中，虽然有 OPcache 优化，但依然存在文件解析和类加载的开销。
- Phalcon：作为 C 扩展，它在 PHP 进程启动时就已加载到内存中，这意味着框架的所有核心功能在请求到达之前就已经准备就绪，无需在运行时解析 PHP 代码。
关键性能指标
行业共识认为,在处理高并发请求时，Phalcon 的资源占用远低于传统框架。
| 指标 | Laravel (典型值) | Phalcon (典型值) | 性能提升 |
|---|---|---|---|
| 每秒请求数 (RPS) | 200 – 500 | 2000 – 5000 | 约 10 倍 |
| 内存占用 (每请求) | 10MB – 20MB | 1MB – 3MB | 约 5-8 倍 |
| 启动延迟 | 较高 (需加载类) | 极低 (内存常驻) | 显著降低 |
适用场景分析
- 选择 Laravel 的场景：开发速度优先，需要极其丰富的第三方生态，团队成员对 PHP 熟悉度高但对 C 扩展配置不感兴趣。
- 选择 Phalcon 的场景：对响应时间有极致要求，服务器硬件资源有限，需要支撑极高并发的 API 服务。
安装后的优化与实操路径
安装成功并不意味着性能最大化,还需要针对 Linux 环境进行微调。
开启 OPcache
虽然 Phalcon 核心是 C 编写的，但你的业务代码依然是 PHP。
- 在
php.ini中确保opcache.enable=1。 - 设置
opcache.memory_consumption=128。 - 设置
opcache.interned_strings_buffer=8。 - 这能确保你的业务逻辑层运行速度与框架层匹配。
目录权限配置
Phalcon 遵循典型的 MVC 结构，对缓存和日志目录有严格的权限要求。
- 假设项目根目录为
/var/www/phalcon_app。 - 创建缓存目录：
mkdir -p cache logs。 - 赋予 Web 服务器权限：
sudo chown -R www-data:www-data cache logs（Ubuntu）或sudo chown -R apache:apache cache logs（CentOS）。 - 设置权限：
sudo chmod -R 775 cache logs。
环境变量配置
为了方便开发,建议在 Linux 的 .bashrc 或 .zshrc 中添加 Phalcon 相关的路径别名，或者配置 Composer 的全局路径，确保 phalcon 命令行工具可用。
Linux 安装 Phalcon 核心总结
安装 Phalcon 的关键在于确保 PHP 开发环境完整以及编译器版本达标，在 Ubuntu 上通过 PECL 安装最为便捷，而在 CentOS 上则需重点关注 GCC 版本升级和 Swap 分区配置，通过将框架逻辑下沉到 C 扩展层，Phalcon 在内存占用和请求吞吐量上具有原生优势。
Linux 安装 Phalcon 常见问题 Q&A
Q: 安装 Phalcon 时提示 “Zephir not found” 是什么原因？
A: 这通常发生在从源码编译而非使用 PECL 安装时，Phalcon 是用 Zephir 语言编写的，源码编译需要先安装 Zephir 编译器，建议直接使用 pecl install phalcon，因为 PECL 提供的预编译包无需在本地安装 Zephir。
Q: Phalcon 安装后 php -m 能看到，但网页访问报 500 错误？
A: 这种情况通常是由于 PHP-FPM 和 PHP-CLI 使用了不同的 php.ini 配置文件，你只在 CLI 模式下启用了扩展，而没有在 FPM 配置文件中添加 extension=phalcon，请检查 FPM 对应的配置文件并重启服务。
Q: Phalcon 5.0 支持哪些 Linux 发行版？
A: Phalcon 5.0 支持所有能够安装 PHP 8.0+ 和 GCC 7.0+ 的主流 Linux 发行版，包括 Ubuntu 20.04/22.04、Debian 11/12、CentOS 7/8 以及 AlmaLinux 和 Rocky Linux。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/linux-%e5%ae%89%e8%a3%85-phalcon/
