本文详解 PHP 通过 shell_exec 调用 PowerShell 脚本时正确传递参数的方法，重点解决变量未解析、param 块失效及执行策略报错等常见问题，并提供防注入加固与调试技巧。
本文详解 php 通过 shell_exec 调用 powershell 脚本时正确传递参数的方法，重点解决变量未解析、`param` 块失效及执行策略报错等常见问题，并提供防注入加固与调试技巧。
在 Web 应用中调用 PowerShell 执行 AD 用户创建等系统管理任务时，常因参数传递方式不当导致脚本失败——典型表现为 PowerShell 报错 The term '-nom' is not recognized，或变量值为空字符串。根本原因在于 PHP 字符串拼接与 PowerShell 参数解析机制的双重误解。
✅ 正确调用方式：使用 -File + 双引号转义
原代码中：
$query2 = shell_exec("powershell.exe -executionpolicy remotesigned -command $psScriptPath2 -nom '$nom' -prenom '$prenom' ...");存在两个关键错误：
-
误用
-command模式调用脚本文件：-command用于执行内联命令（如Get-Date），而调用.ps1文件应使用-File； -
PHP 单引号不解析变量：
'$nom'在 PHP 中是字面量字符串，不会替换为实际值；必须改用双引号并对 PowerShell 特殊字符进行转义。
✅ 修正后的 PHP 调用（含安全防护）：
立即学习“PHP免费学习笔记（深入）”；
// 对输入做基础清理（防止命令注入）
$nom = escapeshellarg(trim($_POST["nom"]));
$prenom = escapeshellarg(trim($_POST["prenom"]));
$login = escapeshellarg(trim($_POST["login"]));
$mdp = escapeshellarg(trim($_POST["mdp"]));
$psScriptPath2 = "C:\inetpub\wwwroot\Test\test2.ps1";
// 使用 -File 并确保参数被正确传递
$query2 = shell_exec(
"powershell.exe -ExecutionPolicy Bypass -File " .
escapeshellarg($psScriptPath2) .
" -nom $nom -prenom $prenom -login $login -mdp $mdp 2>&1"
);
echo "<pre class="brush:php;toolbar:false;">" . htmlspecialchars($query2) . "";? 关键点说明：
escapeshellarg()：为每个变量添加单引号并转义内部引号，防御命令注入（如$mdp = "a'$(Remove-Item C:* -Recurse)'b"）；-ExecutionPolicy Bypass：比RemoteSigned更可靠（尤其在 IIS 应用池用户无权限修改策略时）；2>&1：捕获 PowerShell 错误流（stderr），避免静默失败；htmlspecialchars()：安全输出结果，防止 XSS。
✅ PowerShell 脚本：强化参数验证与错误处理
test2.ps1 需补充健壮性逻辑：
param(
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[string]$nom,
[Parameter(Mandatory = $true)]
[ValidateNotNullOrEmpty()]
[string]$prenom,
[Parameter(Mandatory = $true)]
[ValidatePattern('^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+.[a-zA-Z]{2,}$')]
[string]$login,
[Parameter(Mandatory = $true)]
[ValidateLength(8, 128)]
[string]$mdp
)
Write-Host "Received: nom=$nom, prenom=$prenom, login=$login"
# 强制导入模块并检查
try {
Import-Module ActiveDirectory -ErrorAction Stop
} catch {
Write-Error "Failed to load ActiveDirectory module: $($_.Exception.Message)"
exit 1
}
$domaine = "xxx.fr"
$OU = "OU=AA,OU=Utilisateurs,OU=BB,OU=CC,OU=DD,DC=XXX,DC=FR"
try {
$securePwd = ConvertTo-SecureString $mdp -AsPlainText -Force
New-ADUser `
-SamAccountName $nom `
-UserPrincipalName ("$login@$env:userdnsdomain") `
-Name "$nom $prenom" `
-GivenName $nom `
-Surname $prenom `
-EmailAddress "$login@xxx.fr" `
-Enabled $true `
-DisplayName "$nom, $prenom" `
-Server $domaine `
-Path $OU `
-AccountPassword $securePwd `
-PassThru | Out-Null
Write-Host "✅ User '$nom' created successfully."
} catch {
Write-Error "❌ Failed to create user: $($_.Exception.Message)"
}⚠️ 注意事项与最佳实践
-
IIS 权限：确保应用池身份（如
IIS APPPOOLDefaultAppPool）具有Active Directory模块权限及目标 OU 的写入权限； -
PowerShell 执行策略：若无法全局设为
Bypass，可临时设置：powershell.exe -Command "Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass -Force" -
调试技巧：先在 CMD 中手动测试命令，例如：
powershell.exe -ExecutionPolicy Bypass -File "C: est2.ps1" -nom "test" -prenom "user" -login "t.user" -mdp "P@ssw0rd123" - 替代方案建议：生产环境推荐使用 PowerShell Web API 或 RESTful 接口封装 AD 操作，避免直接暴露 shell 调用。
通过以上调整，PHP 与 PowerShell 的参数传递将稳定可靠，同时兼顾安全性与可维护性。
