PHPer 开发环境管理器

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

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

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

---

📸 界面预览

仪表盘	PHP 版本管理

✨ 功能特性

🐘 PHP 版本管理

功能	说明
多版本管理	支持同时安装 PHP 8.1、8.2、8.3、8.4、8.5 等多个版本
一键切换	点击即可切换 PHP 版本，自动配置系统环境变量
扩展管理	可视化管理 PHP 扩展，一键启用/禁用
配置编辑	在线编辑 php.ini，无需手动查找配置文件
自动配置	安装时自动启用常用扩展（curl、gd、mbstring、pdo_mysql 等）

🐬 MySQL 管理

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

🌐 Nginx 管理

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

🔴 Redis 管理

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

🌍 站点管理

• ➕ 快速创建站点 - 填写域名和路径即可创建虚拟主机
• 🎯 Laravel 一键配置 - 自动配置 public 目录和伪静态规则
• 🔒 SSL 证书申请 - 集成 Let's Encrypt 自动申请
• 📝 Hosts 自动配置 - 自动添加域名到系统 hosts 文件

⚙️ 其他功能

• 🚀 开机自启动 - 可配置各服务开机自动启动
• 📋 Hosts 管理 - 可视化管理系统 hosts 文件
• 🌙 深色/浅色主题 - 支持主题切换
• 📊 服务状态监控 - 实时显示各服务运行状态

🛠️ 技术栈

技术	说明
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 安装包
npm run electron:build

构建完成后，安装包将生成在 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 服务管理器
│       ├── ServiceManager.ts   # 开机自启服务管理器
│       └── HostsManager.ts     # Hosts 文件管理器
│
├── src/                         # Vue 前端源码
│   ├── App.vue                 # 根组件
│   ├── main.ts                 # 入口文件
│   ├── vite-env.d.ts           # 类型声明
│   ├── router/                 # 路由配置
│   │   └── index.ts
│   ├── styles/                 # 样式文件
│   │   └── main.scss           # 全局样式（含主题变量）
│   └── views/                  # 页面视图
│       ├── Dashboard.vue       # 仪表盘
│       ├── PhpManager.vue      # PHP 管理
│       ├── MysqlManager.vue    # MySQL 管理
│       ├── NginxManager.vue    # Nginx 管理
│       ├── RedisManager.vue    # Redis 管理
│       ├── SitesManager.vue    # 站点管理
│       ├── HostsManager.vue    # Hosts 管理
│       └── Settings.vue        # 设置
│
├── public/                      # 静态资源
│   └── icon.svg                # 应用图标
│
├── 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 for Windows - PHP Windows 官方下载
• MySQL Downloads - MySQL 官方下载
• Nginx - Nginx 官方网站
• Redis for Windows - Windows 版 Redis

📄 开源协议

本项目基于 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！