根本原因是zf.bat所在目录未加入系统PATH，且php.exe路径也未加入PATH；需分别添加D:\xampp\php和D:\xampp\ZendFramework-1.12.17\bin到PATH，并重启命令行验证。
zf 命令无法识别：环境变量没配对路径
根本原因不是 Zend Framework 没装好，而是 zf.bat 所在目录没进系统 Path，或者 php.exe 不在 Path 里——前者导致敲 zf 报“不是内部或外部命令”，后者让 zf.bat 启动时直接失败。
必须同时加两条路径（以 XAMPP 默认安装在 D:\xampp 为例）：
-
D:\xampp\php（确保php.exe可执行） -
D:\xampp\ZendFramework-1.12.17\bin（替换成你解压的实际版本路径，含zf.bat）
改完后务必新开一个 cmd 窗口验证：
php -v<br>zf show version
如果只显示 PHP 版本但 zf 报错，说明第二条路径错了或拼写有空格；如果两个都报错，优先检查第一条。
include_path 配置错误：PHP 找不到 Zend 类
即使 zf 命令能跑，新建项目后访问 index.php 仍可能报 Fatal error: Class 'Zend_Controller_Front' not found，这是 include_path 没指向 ZendFramework/library 导致的。
修改 D:\xampp\php\php.ini 中这一行（不要只改 include_path = ".;c:\zend" 这种模糊路径）：
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
include_path = ".;D:\xampp\ZendFramework-1.12.17\library"
注意：
- 路径必须是绝对路径，且用反斜杠
\或双正斜杠//，单斜杠/在 Windows 下部分 PHP 版本会失效 - 别漏掉开头的
.（当前目录），否则项目内相对 require 会失败 - 改完重启 Apache，用
phpinfo()页面确认include_path值已更新
项目创建后白屏或 404：public 目录没设为 Web 根
Zend Framework 1.x 要求 Web 服务器 DocumentRoot 指向项目内的 public/ 子目录，而不是整个项目根目录。XAMPP 默认把 D:\xampp\htdocs 当根，直接放项目进去必然出问题。
两种可靠做法：
- 用 Apache 虚拟主机：在
D:\xampp\apache\conf\extra\httpd-vhosts.conf加一段，DocumentRoot明确指向D:/xampp/htdocs/myproject/public，并开启AllowOverride All - 不配虚拟主机时，把
public/里的全部内容（主要是index.php和.htaccess）复制到D:\xampp\htdocs\myproject\，再手动修改index.php中的defined('APPLICATION_PATH')路径，让它向上找对application/目录
忽略这步，.htaccess 规则不生效，URL 路由全挂，连首页都 404。
Zend Framework 2+ 必须用 Composer：别硬套 zf.bat
如果你下的是 Zend Framework 2 或 3，zf.bat 已废弃，强行配置也运行不了。ZF2+ 的标准流程是：
- 先装 Composer（选 Windows Installer，指定
D:\xampp\php\php.exe） - 用
composer create-project拉 skeleton（如composer create-project zendframework/skeleton-application path/to/project） - Composer 会自动处理 autoloader、依赖和
vendor/结构，include_path改不改都不影响加载
常见误区是把 ZF1 的教程照搬到 ZF2 上，结果卡在 zf 命令或 library 手动拷贝环节——ZF2 的入口逻辑和类加载机制完全不同，路径配置只是表象，底层依赖管理方式已经切换。
