phpenv仅管理php版本切换，不模拟线上web环境；需手动处理路径、$_server变量及web服务配置，否则会导致require报错、路由失效等问题。
phpEnv 本身不模拟线上环境，它只管理 PHP 版本切换；要让本地行为接近线上，必须配合路径处理、服务器变量 normalize 和 Web 服务配置——否则 require 报错、路由失效、$_SERVER 值错乱都是常态。
phpEnv 只负责 PHP 二进制切换，不解决 DOCUMENT_ROOT 和 SCRIPT_NAME 不一致问题
很多人装完 phpenv 就以为“本地环境齐了”，结果一跑 Laravel 或 ThinkPHP 就报 require(): No such file 或路由 404。根本原因是：phpenv 完全不管 Web 服务器怎么起、$_SERVER 怎么填、入口路径怎么算。
-
phpenv global 8.1.25只改了php命令指向哪个二进制，不影响 Apache/Nginx 的模块加载或内置服务器的行为 - 线上用 Nginx +
try_files $uri $uri/ /index.php?$query_string，本地用php -S默认不解析 PATH_INFO，$_SERVER['SCRIPT_NAME']固定为/index.php，而$_SERVER['REQUEST_URI']却是/user/profile，导致框架路由匹配失败 -
$_SERVER['DOCUMENT_ROOT']在php -S下默认为null，但很多老项目硬编码require $_SERVER['DOCUMENT_ROOT'].'/config/db.php'，直接崩
必须手动补全 $_SERVER 变量才能让框架/路由正常工作
在项目入口文件（如 public/index.php）最开头插入 normalize 逻辑，别依赖任何“自动适配”：
if (php_sapi_name() === 'cli-server') {
$_SERVER['DOCUMENT_ROOT'] = dirname(__DIR__);
$_SERVER['SCRIPT_NAME'] = '/index.php';
$_SERVER['PHP_SELF'] = $_SERVER['SCRIPT_NAME'];
// 把 /api/user → /index.php/api/user，激活 PATH_INFO
$_SERVER['REQUEST_URI'] = preg_replace('/^(\/[^?]*)(?:\?.*)?$/', '$1', $_SERVER['REQUEST_URI']);
$_SERVER['PATH_INFO'] = str_replace($_SERVER['SCRIPT_NAME'], '', $_SERVER['REQUEST_URI']);
}
- 这段代码不能丢进中间件或框架启动后——必须在
require任何其他文件前执行 - 如果项目入口不在
public/而是根目录下，把dirname(__DIR__)换成__DIR__，否则DOCUMENT_ROOT指向错误目录 - 别用
$_SERVER['SCRIPT_FILENAME']推导DOCUMENT_ROOT，它在 CLI Server 下指向 router.php，不是你想要的 webroot
用 Apache/Nginx + phpenv 切换 PHP，比 php -S 更贴近线上
phpenv 管理 PHP 版本，但 Web 服务得自己搭。推荐走真实服务器组合：
- Windows 用户：用
phpstudy或XAMPP，它们自带 Apache+PHP+MySQL，且允许你替换 PHP 目录（把 phpenv 安装的~/.phpenv/versions/8.1.25整个复制过去，再改 Apache 的LoadModule php_module路径和AddHandler配置） - macOS/Linux 用户：用
brew install httpd+ 手动链接 phpenv 的libphp.so，或更稳妥地用 Docker：docker run -v $(pwd):/var/www/html -p 8080:80 php:8.1-apache，完全绕过 phpenv 的 Web 层限制 - 切记：Apache 的
DocumentRoot必须指向你的public/目录，不是项目根目录；否则.htaccess不生效，重写规则挂掉
真正复现线上路径的关键是 APP_BASE_PATH 和 APP_BASE_URL
所有 require/include、URL 生成、资源路径拼接，都该基于这两个常量，而不是动态读 $_SERVER：
define('APP_BASE_PATH', dirname(__DIR__)); // 项目根目录
define('APP_BASE_URL', 'http://localhost:8000'); // 开发时可硬写，上线由环境变量注入
-
require APP_BASE_PATH . '/app/helpers/str.php';—— 不依赖DOCUMENT_ROOT，也不怕 CLI Server 下为 null -
<img src="<?php%20echo%20APP_BASE_URL;%20?>/assets/logo.png">—— 避免相对路径在子路由下错位 - 线上部署时，用
getenv('APP_BASE_URL')替代硬写，本地开发用.env文件注入，这才是可复现的路径方案
最容易被忽略的一点：phpenv 切换版本后，php --ini 显示的配置文件路径会变，但 Apache 或 Nginx 加载的 php.ini 是编译时绑定的，不是 phpenv 当前版本的配置。改配置必须去对应版本的 etc/php/php.ini，而不是你以为的全局位置。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
