XAMPP默认仅监听80端口，需手动修改httpd.conf添加Listen 8080、Listen 8081等行，并配置对应VirtualHost块指定独立DocumentRoot和AllowOverride All，才能实现多端口部署Phalcon应用。
确认XAMPP中Apache是否已启用多端口监听
默认XAMPP只监听 80 端口，要跑多个Phalcon应用（比如本地开发测试不同版本或分支），必须让Apache同时响应多个端口。直接改 httpd.conf 是最稳妥的方式，而不是依赖虚拟主机名——因为Phalcon的URL重写规则（尤其是 public/.htaccess 中的 RewriteRule ^(.*)$ index.php?_url=/$1）对端口透明，但前提是请求真能抵达对应站点目录。
打开 C:\xampp\apache\conf\httpd.conf（Windows）或 /opt/lampp/etc/httpd.conf（Linux/macOS），找到 Listen 80 行，在下方新增你需要的端口，例如：
Listen 8080 Listen 8081
确保每行独立，不加空格或注释符在行首；若已有 Listen 行被注释，先取消注释再追加。
为每个端口配置独立的DocumentRoot和Phalcon入口
不能共用同一个 htdocs 目录，否则所有端口都指向同一套代码，起不到“多端口部署”的作用。你需要为每个端口定义一个独立的 <VirtualHost> 块，并指定各自的根路径和重写逻辑。
在 httpd.conf 文件末尾（或更推荐：新建 C:\xampp\apache\conf\extra\phalcon-ports.conf 并在主配置中 Include 它），添加类似内容：
<VirtualHost *:8080>
DocumentRoot "C:/xampp/htdocs/phalcon-app-v1/public"
<Directory "C:/xampp/htdocs/phalcon-app-v1/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
<p><VirtualHost *:8081>
DocumentRoot "C:/xampp/htdocs/phalcon-app-v2/public"
<Directory "C:/xampp/htdocs/phalcon-app-v2/public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>注意三点：
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
-
DocumentRoot必须指向各项目的public/目录，不是项目根目录——否则.htaccess无法生效，index.php会暴露路径或403 -
<Directory>块中AllowOverride All不可省略，否则.htaccess的重写规则被忽略，Phalcon的路由（_url参数）收不到 - 路径中的反斜杠（Windows）或正斜杠（macOS/Linux）要与系统一致；路径含空格时需加双引号
检查Phalcon扩展是否在所有PHP实例中加载
XAMPP只有一个PHP配置，但如果你用命令行运行 php -v 或 php --ini，可能发现 CLI 和 Apache 加载的是不同 php.ini。而Phalcon扩展只在 extension=php_phalcon.dll（Windows）或 extension=phalcon.so（macOS/Linux）所在配置文件中生效。
务必确认以下两点：
- Apache使用的
php.ini（通常是C:\xampp\php\php.ini或/opt/lampp/etc/php.ini）里已启用php_phalcon.dll或phalcon.so - 通过
http://localhost/dashboard/phpinfo.php访问任一端口（如:8080），搜索 “phalcon”，确认扩展已加载且版本正确 - 若用M1 Mac跑XAMPP（x86_64模式），必须下载 x86_64 架构的
phalcon.so；ARM64版会导致mach-o file, but is an incompatible architecture错误
避免 .htaccess 规则跨端口干扰
每个Phalcon项目都自带 public/.htaccess，但Apache默认会继承上级目录的规则。如果多个项目共用父级目录（如都在 htdocs/ 下），而你又没在每个 <VirtualHost> 中显式关闭继承，就可能出现重写冲突或404。
安全做法是在每个 <VirtualHost> 的 <Directory> 块中明确声明：
<Directory "C:/xampp/htdocs/phalcon-app-v1/public">
AllowOverride All
Require all granted
# 确保不从父目录继承无关规则
Options -Indexes
</Directory>另外，不要把多个项目的 public/ 放进同一目录下再靠端口区分——Apache不会自动按端口选子目录，它只认 DocumentRoot。路径隔离比端口“伪装”更可靠。
真正容易被忽略的是：Phalcon的 index.php 引导文件里硬编码的 BASE_PATH 或 __DIR__ 路径，若项目结构不统一（比如一个用 app/ 一个用 src/），路由或资源加载可能出错。建议所有多端口部署的Phalcon项目保持一致的目录约定。
