本文详解如何在 PHP 中安全、准确地执行多行 PowerShell 脚本（如查询当前用户邮箱），重点解决因 PHP 变量解析导致的 $searcher 未定义等语法错误。
本文详解如何在 php 中安全、准确地执行多行 powershell 脚本（如查询当前用户邮箱），重点解决因 php 变量解析导致的 `$searcher` 未定义等语法错误。
在 PHP 中调用 PowerShell 执行多行命令时，一个常见误区是直接使用 heredoc（如 ）包裹 PowerShell 脚本——这会导致 PHP 尝试解析其中所有以 <code>$ 开头的标识符（如 $searcher、$env:USERNAME），将其误认为 PHP 变量，从而引发“undefined variable”错误或意外替换，最终 PowerShell 脚本根本无法运行。
✅ 正确做法：使用 nowdoc 语法（单引号包裹的 heredoc），它完全禁用 PHP 的变量解析和转义处理，确保 PowerShell 脚本原样传递给系统 shell：
$cmd = <<<'CMD'
$searcher = [ADSISearcher] "(sAMAccountName=$env:USERNAME)"
$searcher.PropertiesToLoad.AddRange(@("mail"))
$searcher.FindOne().Properties["mail"][0]
CMD;
$output = shell_exec("powershell -Command " . escapeshellarg($cmd));
echo trim($output); // 输出类似：user@domain.com? 关键说明：
中的单引号是 nowdoc 的标志，<code>$searcher、$env:USERNAME等将不被 PHP 解析，完整保留给 PowerShell；- 必须显式调用
powershell -Command并用escapeshellarg()安全包裹脚本内容，防止命令注入与特殊字符（如引号、换行）破坏执行； -
shell_exec()返回含尾部换行的字符串，建议用trim()清理； - 若目标环境为 Windows Server 或域环境，请确保 PHP 进程具有足够权限访问 Active Directory（如运行在具备域用户上下文的服务账户下）。
⚠️ 注意事项：
立即学习“PHP免费学习笔记（深入）”；
- Heredoc（
）会解析 <code>$和{}，绝对不可用于含 PowerShell 变量的多行脚本； - 避免拼接未过滤的用户输入到
$cmd中——始终优先使用escapeshellarg()或改用更安全的proc_open()+ 输入流方式； - 在非 Windows 环境或无 PowerShell Core 的场景下，该方案不可用；如需跨平台，应考虑 LDAP 扩展（如
ldap_connect()）替代。
综上，nowdoc 是 PHP 调用多行 PowerShell 的基石语法保障。结合安全的命令封装与环境校验，即可稳定实现 AD 用户属性查询等系统集成任务。
