安装 Phalcon 扩展

约 336 字大约 1 分钟

2025-06-19

说明

适用系统：CentOS 6.x / CentOS 7.x
适用 PHP 版本：PHP 7.1+
Phalcon 扩展仓库：github.com/phalcon/cphalcon

安装依赖

yum install autoconf gcc gcc-c++ wget -y

如果编译时提示缺少其他依赖，请根据报错信息自行安装。

下载 Phalcon 稳定版

# 前往 https://github.com/phalcon/cphalcon/releases 获取最新稳定版下载地址
wget http://down.whsir.com/downloads/cphalcon-3.4.4.tar.gz
tar xf cphalcon-3.4.4.tar.gz
cd cphalcon-3.4.4/build/php7/64bits

运行 phpize（请根据实际 PHP 安装路径调整）：

/usr/local/php/bin/phpize

预期输出：

Configuring for:
PHP Api Version:         20160303
Zend Module Api No:      20160303
Zend Extension Api No:   320160303

不确定 phpize 路径？可使用 find / -name phpize 查找。

编译扩展模块

./configure --with-php-config=/usr/local/php/bin/php-config
make
make install

编译完成后会显示扩展模块的存放路径，例如：

/usr/local/php/lib/php/extensions/no-debug-non-zts-20160303/

配置 php.ini

编辑 php.ini，添加以下内容：

extension_dir = "/usr/local/php/lib/php/extensions/no-debug-non-zts-20160303/"
extension = phalcon.so

如果之前已配置过 extension_dir，则只需添加 extension = phalcon.so 即可。

保存后重启 PHP-FPM：

systemctl restart php-fpm

验证安装

php -m | grep phalcon

有输出即表示安装成功。

Phalcon DevTools

Phalcon DevTools 提供了命令行工具，可用于生成项目骨架、模型、控制器等。

官方仓库：github.com/phalcon/phalcon-devtools
安装教程参考：博客园 - Phalcon 安装教程