Phalcon及Devtools安装后创建项目报错：Class 'Phalcon\Config'未找到

问题说明 #

已完成Phalcon框架安装、php.ini配置修改及Devtools安装，但执行项目创建命令时触发错误：Fatal error: Uncaught Error: Class 'Phalcon\Config' not found

相关截图 #

• PHP版本信息：
  
• Phalcon Devtools状态：
  
• 报错详情：
  

排查与解决步骤 #

• 确认Phalcon扩展加载状态

  1. 执行php -m命令，查看输出列表中是否存在phalcon，不存在则说明扩展未加载。
  2. 检查php.ini的扩展配置是否正确，注意区分CLI和Web环境的php.ini路径（多数系统中两者使用不同配置文件）。
  3. 修改配置后重启PHP服务（如php-fpm、Apache或Nginx），再次验证扩展加载情况。

• 验证版本兼容性
  Devtools版本必须与Phalcon框架版本严格匹配（如Phalcon 5.x需对应5.x版本的Devtools），执行phalcon --version查看Devtools版本，对比PHPinfo中的Phalcon版本是否一致。

• 检查Devtools执行环境

  1. 确保Devtools的执行路径已添加至系统环境变量，或使用绝对路径调用命令。
  2. 确认执行phalcon create-project时使用的PHP环境，与加载Phalcon扩展的环境为同一个（可通过which php和php -i命令验证）。

• 手动测试类加载
  创建测试文件test_phalcon.php，内容如下：

  <?php
  try {
      $config = new Phalcon\Config([]);
      echo "Phalcon Config类加载成功";
  } catch (Error $e) {
      echo "加载失败：" . $e->getMessage();
  }
  ?>
  

  执行php test_phalcon.php，若报错则回到扩展加载环节排查；若正常输出，则说明Devtools的执行环境存在问题。

内容的提问来源于stack exchange，提问作者Mateus J. Machado