本文详解PHP通过exec执行含Selenium WebDriver的Python脚本时“PHP阻塞/无响应”的根本原因，指出未封装主逻辑导致的进程挂起问题，并提供标准化解决方案：将Python代码封装进main函数+if name == 'main'入口，配合PHP端超时控制与错误捕获，确保Web请求正常响应。
本文详解php通过exec执行含selenium webdriver的python脚本时“php阻塞/无响应”的根本原因，指出未封装主逻辑导致的进程挂起问题，并提供标准化解决方案：将python代码封装进main函数+if __name__ == '__main__'入口，配合php端超时控制与错误捕获，确保web请求正常响应。
在Web表单场景中，常需PHP接收用户关键词后调用Python脚本执行自动化任务（如Selenium爬图）。但实践中常出现“Python成功运行、PHP却卡住不返回”的现象——表单看似未提交，页面无响应，实际是PHP的exec()被阻塞，根源在于未规范Python脚本的执行入口。
问题本质：Python脚本缺乏明确执行边界
原始Python代码直接在模块顶层执行Selenium操作（启动Chrome、登录、滚动、下载），这会导致：
- Python解释器在脚本加载阶段即启动WebDriver，占用大量资源；
- 若Chrome驱动异常或页面加载超时，脚本可能无限等待；
- PHP的exec()会同步等待Python进程完全退出，而未封装的脚本难以可靠终止，造成PHP长时间阻塞。
✅ 正确做法是：将所有业务逻辑封装进main()函数，并通过if __name__ == '__main__':控制执行入口。这不仅提升代码可测试性，更关键的是确保Python进程在完成任务后能明确退出，避免exec()挂起。
✅ 修复后的Python脚本（关键修改已高亮）
from selenium import webdriver
from selenium.webdriver.common.keys import Keys
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
import time
import os
import wget
import sys
import codecs
# 设置UTF-8输出（保持原有逻辑）
sys.stdout = codecs.getwriter("utf-8")(sys.stdout.buffer, "strict")
def main():
# 获取命令行参数
if len(sys.argv) < 2:
print("false")
return
keyword = sys.argv[1]
# 初始化WebDriver（建议添加options避免GUI干扰）
options = webdriver.ChromeOptions()
options.add_argument('--headless') # 关键：无头模式，避免服务器GUI依赖
options.add_argument('--no-sandbox')
options.add_argument('--disable-dev-shm-usage')
try:
path = "D:/chromedriver.exe"
driver = webdriver.Chrome(path, options=options)
driver.get("https://www.instagram.com/")
# 后续登录、搜索、下载逻辑（保持原结构，但置于try内）
username = WebDriverWait(driver, 10).until(
EC.element_to_be_clickable((By.CLASS_NAME, "KPnG0"))
)
# ...（此处省略中间登录逻辑，保持原样）...
search = WebDriverWait(driver, 10).until(
EC.element_to_be_clickable((By.CLASS_NAME, "XTCLo"))
)
search.send_keys(keyword)
time.sleep(1)
search.send_keys(Keys.RETURN)
time.sleep(1)
search.send_keys(Keys.RETURN)
time.sleep(5)
WebDriverWait(driver, 10).until(
EC.presence_of_element_located((By.CLASS_NAME, "FFVAD"))
)
for i in range(5):
driver.execute_script("window.scrollTo(0, document.body.scrollHeight);")
time.sleep(5)
imgs = driver.find_elements(By.CLASS_NAME, "FFVAD")
path_dir = os.path.join(keyword)
os.makedirs(path_dir, exist_ok=True) # 使用makedirs避免目录已存在报错
count = 0
for img in imgs:
src = img.get_attribute("src")
if src and src.startswith("http"):
save_as = os.path.join(path_dir, f"{keyword}_{count}.jpg")
wget.download(src, save_as)
count += 1
print("true") # 成功标识
except Exception as e:
print(f"false: {str(e)}")
finally:
if 'driver' in locals():
driver.quit() # 确保WebDriver释放
if __name__ == '__main__':
main()? PHP端增强健壮性（推荐改进）
原始PHP代码存在安全隐患与逻辑缺陷，应同步优化：
立即学习“PHP免费学习笔记（深入）”；
<?php
echo '<form method="post">';
echo '<input type="text" name="keywords" placeholder="Enter keywords" required>';
echo '<input type="submit" value="Search">';
echo '</form>';
if ($_POST && !empty($_POST['keywords'])) {
$keywords = trim($_POST['keywords']);
// 严格过滤关键词（防止命令注入）
if (!preg_match('/^[a-zA-Z0-9_\-\s]{1,50}$/', $keywords)) {
echo '<p style="color:red">Invalid keywords format.</p>';
exit;
}
// 构建安全命令（使用escapeshellarg）
$cmd = 'D:/ProgramData/Anaconda3/python D:/xampp/htdocs/website_test/test.py ' . escapeshellarg($keywords);
// 设置超时（避免无限等待），使用shell_exec + timeout（Windows需用timeout.exe）
$output = [];
$return_code = 0;
// Windows下使用timeout命令（需系统支持）
$full_cmd = 'timeout /t 120 /nobreak ' . $cmd . ' 2>&1';
$result = shell_exec($full_cmd);
// 解析Python输出
if (strpos($result, 'true') !== false) {
echo '<p style="color:green">✅ Download completed successfully!</p>';
} else {
echo '<p style="color:red">❌ Failed: ' . htmlspecialchars($result) . '</p>';
}
}
?>⚠️ 重要注意事项
- 环境隔离：Selenium在Web服务器（如Apache）后台运行时，需配置Chrome为--headless模式，否则因缺少桌面会话而崩溃；
- 权限与路径：确保PHP进程有权限执行Python及访问chromedriver路径；推荐使用绝对路径并验证可执行性；
- 资源释放：务必在finally块中调用driver.quit()，防止残留浏览器进程耗尽内存；
- 安全性：永远使用escapeshellarg()处理用户输入，杜绝命令注入风险；
- 调试技巧：开发期可在Python脚本开头添加print("DEBUG: START")，并在PHP中捕获完整$result，定位卡点。
遵循以上规范后，PHP将稳定接收Python的返回结果，表单交互恢复正常，真正实现“用户提交→后端调度→结果反馈”的闭环流程。
