XAMPP环境下安装Zend Framework XAMPP包含路径配置

必须同时加两条路径。以XAMPP默认安装到D:\xampp为例：

• D:\xampp\php（保证php.exe可执行）
• D:\xampp\ZendFramework-1.12.17\bin（具体版本号按实际解压路径来，这个目录里放着zf.bat）

改完后记得重新打开一个cmd窗口验证：

php -v
zf show version

如果只显示PHP版本但zf依然报错，说明第二条路径写错了或者里面带空格。如果两个都报错，先检查第一条路径。

include_path配置错误：PHP找不到Zend类

就算zf命令能正常运行，新建项目后访问index.php也可能遇到Fatal error: Class 'Zend_Controller_Front' not found。这是include_path没指向ZendFramework/library导致的。别只在php.ini里写一句include_path = ".;c:\zend"这种模糊路径，直接明确指定：

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路由全挂，连首页都访问不了。

Zend Framework 2+必须用Composer：别硬套zf.bat

如果你下载的是Zend Framework 2或3，zf.bat已经被废弃了，强行配置也运行不了。ZF2+的标准流程是：

• 先装Composer（使用Windows Installer，指定D:\xampp\php\php.exe作为PHP路径）
• 用composer create-project拉取skeleton应用，比如composer create-project zendframework/skeleton-application path/to/project
• Composer会自动处理autoloader、依赖和vendor/结构，include_path改不改都不影响加载。

常见的坑是把ZF1的教程照搬到ZF2上，结果卡在zf命令或手工拷贝library环节。其实ZF2的入口逻辑和类加载机制跟1.x完全不同，路径配置只是表象，底层依赖管理方式已经换了。