PHP 8.5环境变量配置核心是让系统和命令行找到php可执行文件，并确保php.ini正确加载及扩展启用；需分CLI路径（PATH）、PHP配置（php.ini+extension_dir+扩展启用）、业务变量（.env或Web服务器注入）三类设置，每步须用php -v、php -m、getenv()验证。
PHP 8.5 配置环境变量，核心就一件事：让系统和命令行能“找到” php.exe（Windows）或 php（macOS/Linux）。没配好，输 php -v 就报“不是内部或外部命令”；配错了，Composer、Laravel 启动就卡在扩展缺失。下面分三类场景说清楚，不绕弯子。
一、让命令行认得 php 命令（CLI 环境变量）
这是新手第一步，也是最常出错的一步。关键不是“装没装”，而是“找不找得到”。
- 先确认 php.exe 实际位置，比如解压后是
C:\php或/opt/php-8.5.5，路径里不能有中文、空格 - Windows：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”→在“系统变量”的 Path 里点“新建”，粘贴完整路径（如
C:\php），别加反斜杠 - macOS/Linux：打开终端，编辑
~/.zshrc（macOS Catalina 及以后）或~/.bashrc，末尾加一行：export PATH="$PATH:/opt/php-8.5.5/bin"，然后运行source ~/.zshrc - 配置完必须关掉所有终端窗口，新开一个，再执行
php -v—— 显示PHP 8.5.5才算真正生效
二、让 PHP 自己加载扩展（php.ini 中的路径与启用项）
光有 php 命令还不够。默认 php.ini 是“半瘫痪”状态：扩展目录没指向、关键扩展没开、时区没设——这会导致 Composer 报 mbstring not loaded、Laravel 启动失败、时间显示为 UTC+0。
- 找到并重命名配置文件：把
php.ini-development复制一份，改名为php.ini（别用 production 版，新手调试不方便） - 用记事本或 VS Code 打开
php.ini，重点改这四行（取消前面的分号 ; 并确认值正确）：-
extension_dir = "ext"（Windows）或extension_dir = "/opt/php-8.5.5/lib/php/extensions/no-debug-zts-20240821"（Linux/macOS，路径以你实际为准） date.timezone = Asia/Shanghaiextension=opensslextension=mbstring
-
- 顺手打开
opcache.enable=1（开发阶段也建议开，避免每次重解析脚本） - 保存后，在命令行运行
php -m | grep -i mbstring（macOS/Linux）或php -m然后找mbstring（Windows），确认已加载
三、让 Web 项目读到自己的配置（APP_ENV、DB_HOST 这类变量）
这类变量不控制 PHP 本身，而是给你的代码用的，比如 Laravel 的 APP_ENV=production 或 ThinkPHP 的 DB_PORT=3306。它们不写在 php.ini 里，也不能靠 CLI 的 PATH 解决。
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段推荐用
.env文件 +vlucas/phpdotenv库：用 Composer 安装后，在入口文件开头加几行代码，就能用getenv('DB_HOST')读取 - 生产环境别传 .env 文件！应通过服务器配置注入：
- Apache：在虚拟主机或 .htaccess 里写
SetEnv APP_ENV production - Nginx：在
location ~ \.php$块里加fastcgi_param APP_ENV production; - PHP-FPM：编辑池配置（如
www.conf），加一行env[APP_ENV] = production
- Apache：在虚拟主机或 .htaccess 里写
- 无论哪种方式，PHP 里统一用
getenv('APP_ENV')或$_SERVER['APP_ENV']获取，别混用$_ENV（它依赖 php.ini 的variables_order设置，容易失效）
配环境变量不是一步到位的事，但每一步都有明确验证点：php -v 看命令行、php -m 看扩展、getenv() 看业务变量。抓住这三个锚点，就不会迷失在各种配置文件里。
