zf命令报错因path缺失php.exe和zf.bat路径；class not found因include_path未设zend库绝对路径；重写失效因mod_rewrite未启用或allowoverride未设为all；url路由失败因documentroot未指向public目录。
zf 命令报“不是内部或外部命令”：PATH 没配全
根本不是 Zend Framework 没装对，而是两条路径缺一不可：php.exe 和 zf.bat 必须都能被系统直接调用。
-
D:\xampp\php—— 确保php -v能执行（否则zf.bat启动即失败） -
D:\xampp\ZendFramework-1.12.17\bin—— 这里放着zf.bat，路径必须精确到\bin目录，不能只写到\ZendFramework-1.12.17 - 改完环境变量后，一定要新开一个
cmd窗口验证：php -v和zf show version都得成功返回 - 路径中含空格或中文？重装到纯英文无空格路径下，Windows 对 PATH 解析很敏感
访问 index.php 报 Class 'Zend_Controller_Front' not found
这是 PHP 根本没找到 Zend 类库，include_path 配置错了。
Apache 2.4.62
下载
PHP中文网提供Apache 2.4.62 官方 tar.gz 源码包下载，通过源码编译安装，开发者能够灵活定制模块、优化性能并精准控制安装路径，满足多样化的业务需求。
- 打开
D:\xampp\php\php.ini，定位到include_path行，改成绝对路径：include_path = ".;D:\xampp\ZendFramework-1.12.17\library" - 开头的
.不能丢——它代表当前脚本所在目录，项目内相对 require 依赖它 - 反斜杠
\或双正斜杠//可用，单斜杠/在某些 PHP 版本下会失效 - 改完必须重启 Apache，用
phpinfo()页面确认include_path值已更新，别只信编辑器保存了就完事
Apache 重写不生效、404 或白屏：mod_rewrite + AllowOverride 缺一不可
.htaccess 里的路由规则完全静默失效，90% 是这两个配置没到位。
- 在
D:\xampp\apache\conf\httpd.conf中取消注释：LoadModule rewrite_module modules/mod_rewrite.so—— 注意别多写.so，模块名就是rewrite_module - 全局
<directory></directory>块内，把AllowOverride None改成AllowOverride All - 如果用了虚拟主机，在
httpd-vhosts.conf的<directory></directory>块里也得单独设AllowOverride All，外层设置不会自动继承 - 验证是否真生效：在
htdocs下放个内容为garbage_text的.htaccess，访问任意页面，返回 500 才说明被读取了
public 目录没暴露、URL 路由全挂：DocumentRoot 必须指向 public/
Zend Framework 1.x 不是把整个项目扔进 htdocs 就能跑的，Web 根必须严格落在 public/ 子目录。
- 推荐配虚拟主机：
DocumentRoot "D:/xampp/htdocs/myproject/public"，同时ServerName myapp.local，再改 hosts 文件映射127.0.0.1 myapp.local - 不想配域名？那就把
public/里的index.php和.htaccess复制到htdocs/myproject/，然后手动改index.php中的APPLICATION_PATH，让它向上两级找application/ - 漏掉这步，
.htaccess规则压根不触发，所有请求都绕过 Front Controller，连首页都 404
AllowOverride All 没写对位置，或者 DocumentRoot 指向了项目根而非 public/。这两处一错，其他配置全白搭。
