FrankenPHP 卸载即清理手动配置的文件与资源:删除主程序、配置文件、socket、日志缓存目录,清除环境变量与别名,停用服务,并移除代码中相关集成逻辑。

FrankenPHP 本身没有传统意义上的“安装包”或系统级注册,它是一个自包含的二进制可执行文件(frankenphp),不写入注册表、不修改系统路径、也不自动注册为 Windows 服务或 systemd 单元。因此,“卸载”本质是**清理你主动放置和配置的文件与相关资源**。
删除主程序文件
找到你当初下载并存放 frankenphp(Windows 下为 frankenphp.exe)的位置,直接删除该文件即可。常见位置包括:
- 项目根目录下(如
./frankenphp) -
~/bin/或C:\tools\等手动添加到 PATH 的目录 - Docker 镜像中 —— 若仅用于容器,宿主机无需操作;镜像构建时不再 COPY 即可
清理配置与运行时文件
这些文件不会被自动删除,但对 FrankenPHP 运行非必需,残留可能干扰新部署:
-
配置文件:删掉
frankenphp.toml或Caddyfile中专为 FrankenPHP 编写的php { ... }块 -
Unix socket 文件:如
/tmp/frankenphp.sock(Linux/macOS)或C:\tmp\frankenphp.sock(Windows),手动删除 -
缓存与日志目录:若你曾指定
log.file或cache.dir,可一并清空对应路径
解除环境变量与启动集成
检查是否在系统或用户级 shell 配置中设置了 FrankenPHP 相关变量或别名:
立即学习“PHP免费学习笔记(深入)”;
- Linux/macOS:
~/.bashrc、~/.zshrc中查找FRANKENPHP_*或alias frankenphp=...,删掉后运行source ~/.zshrc - Windows:
系统属性 → 高级 → 环境变量中删除FRANKENPHP_WORKER等自定义变量 - 若曾用
systemctl --user enable frankenphp.service或brew services start frankenphp,需对应停用并卸载服务管理项
移除框架侧调试与集成组件
FrankenPHP 虽已删,但应用代码里可能还留着适配它的逻辑,建议同步清理以避免混淆:
- 删掉
public/index.php中为 Worker 模式添加的frankenphp_handle_request()调用或封装层 - 移除
config/packages/frankenphp.yaml(如有) - 确认
composer.json中无laravel/octane或symfony/runtime等强绑定 FrankenPHP 的运行时依赖(除非你仍需它们)



















