PHPer 开发环境管理器

一款功能强大的 Windows PHP 开发环境管理工具

轻松管理 PHP、MySQL、Nginx、Redis、Node.js、Python 等服务，告别繁琐的手动配置

功能特性 • 安装使用 • 使用指南 • 常见问题

---

📸 界面预览

🏠 仪表盘	🐘 PHP 版本管理
🐬 MySQL 管理	🌐 Nginx 管理
🔴 Redis 管理	💚 Node.js 管理
🐍 Python 管理	⚙️ 设置

✨ 功能特性

🐘 PHP 版本管理

功能	说明
多版本管理	支持同时安装 PHP 8.1、8.2、8.3、8.4、8.5 等多个版本
CGI 独立控制	每个 PHP 版本可独立启动/停止 CGI 进程，支持多版本并行运行
端口自动分配	各版本自动分配端口（如 8.4→9084, 8.3→9083）
一键切换	点击即可切换 PHP 版本，自动配置系统环境变量
扩展管理	可视化管理 PHP 扩展，支持在线安装（从 PECL）
配置编辑	在线编辑 php.ini，无需手动查找配置文件
自动配置	安装时自动启用常用扩展（curl、gd、mbstring、pdo_mysql 等）
Composer	集成 Composer 管理，支持镜像源切换（阿里云、腾讯云等）
日志查看	直接查看 PHP 错误日志
下载源	从 windows.php.net 官方下载

🐬 MySQL 管理

功能	说明
版本支持	支持 MySQL 5.7.x 和 8.0.x 系列
服务控制	启动、停止、重启 MySQL 服务
密码管理	一键修改 root 密码
配置编辑	在线编辑 my.ini 配置文件
自动初始化	安装时自动初始化数据库，开箱即用
下载源	从阿里云镜像站下载，速度更快

🌐 Nginx 管理

功能	说明
版本管理	支持多个 Nginx 版本，可随时切换
服务控制	启动、停止、重启、热重载配置
站点管理	可视化添加、删除、启用、禁用虚拟主机
Laravel 支持	自动生成 Laravel 项目的伪静态配置
SSL 证书	支持申请 Let's Encrypt 免费 SSL 证书
配置编辑	在线编辑 nginx.conf 主配置文件
下载源	从 nginx.org 官方下载

🔴 Redis 管理

功能	说明
Windows 版本	使用 Windows 原生编译版 Redis
服务控制	启动、停止、重启 Redis 服务
状态监控	实时查看运行状态、内存使用情况
配置编辑	在线编辑 redis.windows.conf 配置
下载源	从 GitHub (redis-windows) 下载

💚 Node.js 管理

功能	说明
多版本管理	支持同时安装多个 Node.js 版本
LTS 支持	显示 LTS 版本和 Current 版本标识
npm 集成	自动显示对应的 npm 版本
一键切换	快速切换默认 Node.js 版本，自动配置环境变量
下载源	从 nodejs.org 官方下载

🐍 Python 管理

功能	说明
嵌入式版本	使用免安装的嵌入式版本，不影响系统环境
pip 集成	自动配置 pip，支持安装 Python 包
多版本管理	支持同时安装多个 Python 版本
一键切换	快速切换默认 Python 版本
下载源	从 python.org 官方下载

🔧 Git 管理

功能	说明
版本管理	一键安装/卸载 Git for Windows
配置管理	可视化配置用户名、邮箱等信息
环境变量	自动配置系统 PATH

🌍 站点管理

• ➕ 快速创建站点 - 填写域名和路径即可创建虚拟主机
• 🎯 Laravel 一键配置 - 自动配置 public 目录和伪静态规则
• 🔒 SSL 证书申请 - 集成 Let's Encrypt 自动申请
• 📝 Hosts 自动配置 - 自动添加域名到系统 hosts 文件
• 📋 站点日志查看 - 查看每个站点的访问日志和错误日志
• 🌐 一键打开站点 - 点击域名在默认浏览器打开

📋 日志查看

功能	说明
多服务日志	支持查看 Nginx、PHP、MySQL、Redis 日志
站点日志	查看各站点的访问日志和错误日志
实时刷新	支持刷新日志内容，查看最新记录
行数控制	可配置显示的日志行数（100-5000 行）
快速清空	一键清空指定日志文件
打开目录	快速在文件管理器中打开日志目录

⚙️ 其他功能

• 🚀 开机自启动 - 可配置各服务开机自动启动（静默模式，无弹窗）
• 🔇 静默启动 - 所有服务启动无黑色窗口闪烁
• 📋 Hosts 管理 - 可视化管理系统 hosts 文件
• 🌙 深色/浅色主题 - 支持主题切换
• 📊 服务状态监控 - 实时显示各服务运行状态
• ⚡ 页面切换优化 - 使用 KeepAlive 缓存页面，切换无闪烁
• 🔢 自动版本号 - 打包时自动更新版本号
• 📥 下载源说明 - 清晰显示各软件的下载来源
• 🌐 默认浏览器打开 - 站点链接自动在默认浏览器打开

🛠️ 技术栈

技术	说明
Vue 3	前端框架
TypeScript	类型安全
Electron	桌面应用框架
Element Plus	UI 组件库
Vite	构建工具
Pinia	状态管理

📦 安装使用

系统要求

• ✅ Windows 10/11 (64 位)
• ✅ Node.js 18.0 或更高版本
• ✅ 管理员权限（用于管理服务和修改 hosts 文件）
• ✅ Visual C++ Redistributable 2015-2022

开发环境

# 克隆项目
git clone https://github.com/your-username/phper.git
cd phper

# 安装依赖
npm install

# 启动开发服务器
npm run electron:dev

构建生产版本

# 构建 Windows 安装包（自动更新 patch 版本号 +0.0.1）
npm run build

# 指定版本号更新类型
npm run build:patch   # 1.0.0 -> 1.0.1
npm run build:minor   # 1.0.0 -> 1.1.0
npm run build:major   # 1.0.0 -> 2.0.0

# 不更新版本号直接打包
npm run build:nobump

构建完成后，安装包将生成在 release 目录中。

📁 项目结构

phper/
├── electron/                    # Electron 主进程
│   ├── main.ts                 # 主进程入口
│   ├── preload.ts              # 预加载脚本（IPC 通信）
│   └── services/               # 服务管理模块
│       ├── ConfigStore.ts      # 配置存储（使用 electron-store）
│       ├── PhpManager.ts       # PHP 版本管理器
│       ├── MysqlManager.ts     # MySQL 服务管理器
│       ├── NginxManager.ts     # Nginx 服务管理器
│       ├── RedisManager.ts     # Redis 服务管理器
│       ├── NodeManager.ts      # Node.js 版本管理器
│       ├── PythonManager.ts    # Python 版本管理器
│       ├── GitManager.ts       # Git 管理器
│       ├── ServiceManager.ts   # 开机自启服务管理器
│       ├── HostsManager.ts     # Hosts 文件管理器
│       └── LogManager.ts       # 日志管理器
│
├── src/                         # Vue 前端源码
│   ├── App.vue                 # 根组件（含 KeepAlive 缓存）
│   ├── main.ts                 # 入口文件
│   ├── vite-env.d.ts           # 类型声明
│   ├── router/                 # 路由配置
│   │   └── index.ts
│   ├── stores/                 # Pinia 状态管理
│   │   └── serviceStore.ts     # 服务状态存储
│   ├── components/             # 公共组件
│   │   └── LogViewer.vue       # 日志查看器组件
│   ├── styles/                 # 样式文件
│   │   └── main.scss           # 全局样式（含主题变量）
│   └── views/                  # 页面视图
│       ├── Dashboard.vue       # 仪表盘
│       ├── PhpManager.vue      # PHP 管理
│       ├── MysqlManager.vue    # MySQL 管理
│       ├── NginxManager.vue    # Nginx 管理
│       ├── RedisManager.vue    # Redis 管理
│       ├── NodeManager.vue     # Node.js 管理
│       ├── PythonManager.vue   # Python 管理
│       ├── GitManager.vue      # Git 管理
│       ├── SitesManager.vue    # 站点管理
│       ├── HostsManager.vue    # Hosts 管理
│       └── Settings.vue        # 设置
│
├── scripts/                     # 构建脚本
│   └── bump-version.js         # 版本号自动更新脚本
│
├── public/                      # 静态资源
│   ├── icon.svg                # 应用图标
│   └── version.json            # 版本信息（构建时生成）
│
├── index.html                   # HTML 模板
├── package.json                 # 项目配置
├── vite.config.ts              # Vite 配置
├── tsconfig.json               # TypeScript 配置
└── README.md                   # 项目说明

📖 使用指南

首次使用

1. 安装运行时依赖

   • 确保已安装 Visual C++ Redistributable 2015-2022

2. 以管理员身份运行

   • 右键点击应用图标，选择"以管理员身份运行"
   • 这是管理服务和修改 hosts 文件所必需的

3. 安装服务

   • 首次使用需要安装 PHP、MySQL、Nginx、Redis
   • 进入对应管理页面，点击"安装"按钮

创建第一个站点

1. 安装并启动 Nginx 和 PHP
2. 进入"站点管理"页面
3. 点击"添加站点"
4. 填写站点信息：
   • 站点名称：如 myproject
   • 域名：如 myproject.test
   • 根目录：如 C:\Projects\myproject（Laravel 项目无需指定 public）
   • 选择 PHP 版本
   • 如果是 Laravel 项目，开启"Laravel 项目"选项
5. 点击确认，站点即创建完成
6. 在浏览器访问 http://myproject.test

配置开机自启动

1. 进入"设置"页面
2. 在"开机自启动"部分，开启需要自启的服务
3. 应用会在 Windows 启动目录创建启动脚本

❓ 常见问题

Q: 为什么需要管理员权限？

A: 应用需要管理员权限来：

• 启动/停止 Windows 服务
• 修改系统 hosts 文件
• 配置系统环境变量

Q: PHP 下载很慢怎么办？

A: PHP 从 windows.php.net 官方下载，如果速度较慢：

• 可以手动从官网下载 ZIP 文件
• 解压到 [安装目录]/php/php-版本号 目录
• 重新打开应用即可识别

Q: MySQL 启动失败？

A: 常见原因：

• 3306 端口被占用，检查是否有其他 MySQL 实例
• 防火墙阻止，添加防火墙规则
• 数据目录权限问题，确保目录可写

Q: 如何卸载服务？

A: 进入对应服务管理页面，先停止服务，然后点击"卸载"按钮。

🔗 相关资源

软件	下载源
PHP	windows.php.net - 官方 Windows 版
MySQL	阿里云镜像 - 国内高速下载
Nginx	nginx.org - 官方 Windows 版
Redis	GitHub redis-windows
Node.js	nodejs.org - 官方下载
Python	python.org - 嵌入式版本
Git	git-scm.com - 官方 Windows 版

📄 开源协议

本项目基于 MIT License 开源。

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建功能分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 提交 Pull Request

📮 反馈建议

如果您在使用过程中遇到问题或有任何建议，欢迎：

• 提交 Issue
• 发送邮件至 your-email@example.com

---

Made with ❤️ for PHP Developers

⭐ 如果这个项目对您有帮助，请给我们一个 Star！