# Git文件上传工具

一个基于PHP的Git文件上传工具，支持JS和CSS分离，文件上传无限制。

## 功能特点

- ✅ **文件上传无限制**：支持任意大小和数量的文件上传
- ✅ **Git集成**：完整的Git操作支持（添加、提交、推送、状态查看）
- ✅ **分支管理**：支持创建、删除、切换分支
- ✅ **远程仓库配置**：支持添加和管理多个远程仓库
- ✅ **前后端分离**：独立的CSS和JavaScript文件
- ✅ **拖拽上传**：支持拖拽文件上传
- ✅ **文件管理**：可视化的文件列表和选择
- ✅ **实时状态**：Git仓库状态实时显示
- ✅ **响应式设计**：适配移动端和桌面端

## 文件结构

```
git/
├── index.php          # 主文件（包含PHP后端逻辑和HTML结构）
├── css/
│   └── style.css      # 样式文件
├── js/
│   └── main.js        # JavaScript交互逻辑
├── test.php           # 测试文件
└── uploads/           # 上传文件存储目录（自动生成）
```

## 安装要求

- PHP 7.0 或更高版本
- Git 已安装并配置
- Web服务器（Apache/Nginx等）
- 足够的磁盘空间

## 安装步骤

1. **上传文件到Web服务器**
   ```bash
   # 将整个 git 目录上传到Web服务器目录
   # 例如：/var/www/html/git/
   ```

2. **设置目录权限**
   ```bash
   chmod 755 /var/www/html/git/
   chmod 777 /var/www/html/git/uploads/
   ```

3. **访问工具**
   ```
   http://your-domain.com/git/
   ```

## 使用方法

### 1. 文件上传

- **拖拽上传**：将文件拖拽到上传区域
- **点击上传**：点击上传区域选择文件
- **批量上传**：支持同时选择多个文件

### 2. 分支管理

- **查看分支**：分支列表会自动加载，显示当前分支和其他分支
- **创建新分支**：
  1. 在"新分支名称"输入框中输入分支名称
  2. 点击"创建分支"按钮
  3. 新分支将基于当前分支创建

- **切换分支**：
  1. 在"当前分支"下拉框中选择目标分支
  2. 点击"切换分支"按钮
  3. 工具会自动切换到选中的分支

- **删除分支**：
  1. 在"当前分支"下拉框中选择要删除的分支
  2. 点击"删除分支"按钮
  3. 确认删除操作（如果分支未合并，可选择强制删除）

- **刷新分支**：点击"刷新分支"按钮更新分支列表

### 3. 远程仓库配置

- **添加远程仓库**：
  1. 在"远程仓库名称"输入框中输入名称（如：origin）
  2. 在"仓库地址"输入框中输入远程仓库URL（如：https://github.com/username/repo.git）
  3. 点击"添加远程仓库"按钮

- **查看远程仓库**：点击"查看远程仓库"按钮查看已配置的远程仓库列表

### 4. Git操作

- **添加到暂存区**：选择文件后点击"添加到暂存区"
- **提交更改**：输入提交信息后点击"提交更改"
- **推送到远程**：
  1. 确保已配置远程仓库
  2. 选择要推送的分支（在分支管理区域）
  3. 在"远程仓库名称"输入框中输入要推送的远程仓库名称
  4. 点击"推送到远程"按钮
- **查看状态**：点击"查看状态"查看Git状态
- **查看日志**：点击"查看日志"查看提交历史

### 5. 文件管理

- **刷新列表**：点击"刷新文件列表"更新文件列表
- **选择文件**：勾选需要Git管理的文件
- **全选/取消**：快速选择或取消所有文件

## 配置说明

### PHP配置

工具会自动配置以下PHP设置：
```php
ini_set('upload_max_filesize', '0');     // 无上传大小限制
ini_set('post_max_size', '0');           // 无POST大小限制
ini_set('max_execution_time', '0');      // 无执行时间限制
ini_set('memory_limit', '-1');           // 无内存限制
```

### Git配置

确保Web服务器用户有权限执行Git命令：
```bash
# 检查Git是否可用
sudo -u www-data git --version

# 如果需要，配置Git用户信息
sudo -u www-data git config --global user.name "Web Server"
sudo -u www-data git config --global user.email "web@example.com"
```

## 安全建议

1. **访问控制**：建议添加密码保护或IP限制
2. **文件类型限制**：根据需要限制上传文件类型
3. **定期清理**：定期清理上传目录
4. **备份重要数据**：重要文件请做好备份

## 故障排除

### 常见问题

1. **文件上传失败**
   - 检查 `uploads/` 目录权限
   - 确认PHP配置允许大文件上传
   - 查看Web服务器错误日志

2. **Git操作失败**
   - 确认Git已安装
   - 检查Web服务器用户对Git的访问权限
   - 确认Git仓库已初始化

3. **分支管理问题**
   - 无法删除当前分支，请先切换到其他分支
   - 分支未合并时删除需要强制删除
   - 分支名称不能包含特殊字符

4. **远程仓库配置问题**
   - 确保远程仓库URL格式正确
   - 检查网络连接是否正常
   - 确认有权限访问远程仓库
   - 如需要认证，请配置Git凭据

5. **推送失败**
   - 确认远程仓库已正确添加
   - 检查是否有冲突需要解决
   - 确认有推送权限
   - 确认选择了正确的分支进行推送

6. **界面显示异常**
   - 检查CSS文件是否正确加载
   - 确认JavaScript文件无错误
   - 清除浏览器缓存

### 运行测试

访问测试文件检查配置：
```
http://your-domain.com/git/test.php
```

## 更新日志

### v1.2.0 (2024-01-15)
- 添加分支管理功能
- 支持创建、删除、切换分支
- 支持分支选择和推送
- 优化分支操作的用户体验

### v1.1.0 (2024-01-15)
- 添加远程仓库配置功能
- 支持添加和管理远程仓库
- 支持推送到指定远程仓库
- 优化推送操作的用户体验

### v1.0.0 (2024-01-15)
- 初始版本发布
- 支持文件上传和Git操作
- 实现前后端分离
- 添加拖拽上传功能

## 许可证

MIT License - 详见LICENSE文件

## 作者

Git文件上传工具开发团队

## 支持

如有问题，请通过以下方式联系：
- 邮箱：support@example.com
- 项目主页：https://github.com/your-repo/git-uploader