# 简易图片管理系统

**Repository Path**: ADStudio/simple-image-management-system

## Basic Information

- **Project Name**: 简易图片管理系统
- **Description**: 采用ThinkPHP8.0版本开发的简易图片管理系统。通过将本地图片上次到服务器，在服务器上简单管理图片，包括浏览、删除、地址等。
- **Primary Language**: PHP
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-03-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 简易图片管理系统

基于ThinkPHP 8.0框架开发的简易文件上传管理系统，提供简洁的Web界面上传本地文件到服务器。

## 技术栈

- **后端框架**: ThinkPHP 8.0
- **PHP版本**: PHP 8.0+
- **前端框架**: Bootstrap 5.0
- **前端库**: jQuery 3.6.0, FontAwesome 6.0
- **文件系统**: think-filesystem

## 功能特性

- ✅ 支持多种文件类型上传（图片、压缩包等）
- ✅ 自动生成唯一文件名（年月日时分秒+扩展名）
- ✅ 保留原始文件扩展名
- ✅ 美观的Bootstrap界面
- ✅ 上传成功后弹窗提示
- ✅ 无需数据库支持
- ✅ 响应式设计，支持移动端

## 安装和部署

### 环境要求

- PHP >= 8.0.0
- Composer
- Web服务器（Apache/Nginx）

### 安装步骤

1. 克隆或下载项目到本地

```bash
git clone <repository-url>
cd simple-image-management-system
```

2. 安装依赖

```bash
composer install
```

3. 配置文件系统

确保`config/filesystem.php`配置正确，默认配置如下：

```php
'public' => [
    'type'       => 'local',
    'root'       => app()->getRootPath() . 'public/storage',
    'url'        => '/storage',
    'visibility' => 'public',
],
```

4. 创建上传目录

```bash
mkdir -p public/storage/upload
```

5. 启动开发服务器

```bash
php think run
```

6. 访问应用

在浏览器中打开：`http://localhost:8000/upload`

## 使用方法

### 上传文件

1. 访问上传页面：`http://localhost:8000/upload`
2. 点击"选择文件"按钮，选择要上传的文件
3. 点击"上传"按钮
4. 等待上传完成，系统会弹窗显示上传结果
5. 点击"确定"按钮，可以继续上传其他文件

### 访问上传的文件

上传的文件存储在`public/storage/upload`目录中，可以通过以下URL访问：

```
http://localhost:8000/storage/upload/文件名
```

## 项目结构

```
simple-image-management-system/
├── app/
│   ├── controller/
│   │   └── Upload.php          # 上传控制器
│   ├── BaseController.php
│   ├── AppService.php
│   ├── ExceptionHandle.php
│   ├── Request.php
│   └── ...
├── config/
│   ├── app.php
│   ├── filesystem.php           # 文件系统配置
│   └── ...
├── public/
│   ├── index.php                # 入口文件
│   └── storage/
│       └── upload/              # 上传文件目录
├── route/
│   └── app.php                  # 路由配置
├── vendor/                      # Composer依赖
├── .gitignore                   # Git忽略文件
├── composer.json                # Composer配置
├── think                        # 命令行工具
└── README.md                    # 项目说明文档
```

## 配置说明

### 文件上传配置

文件上传相关配置在`config/filesystem.php`中：

- **磁盘类型**: 本地存储
- **存储路径**: `public/storage`
- **访问URL**: `/storage`
- **可见性**: 公开访问

### 服务器配置

**Apache配置**：

确保启用了`mod_rewrite`模块，并配置`.htaccess`文件。

**Nginx配置**：

```nginx
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}
```

## 注意事项

1. **目录权限**: 确保`public/storage/upload`目录具有写入权限
2. **文件大小限制**: 默认PHP上传文件大小限制为2MB，如需上传更大文件，请修改`php.ini`中的`upload_max_filesize`和`post_max_size`配置
3. **文件类型**: 系统支持所有文件类型，但建议根据实际需求在代码中添加文件类型验证
4. **安全性**: 生产环境中建议添加文件类型验证、文件大小限制等安全措施
5. **备份**: 定期备份上传的文件，避免数据丢失

## 开发说明

### 控制器方法

**Upload控制器**包含以下方法：

- `index()`: 显示上传页面
- `save()`: 处理文件上传请求

### 文件命名规则

上传的文件自动重命名为：`年月日时分秒.扩展名`

例如：`20260226191032.png`

## 许可证

本项目采用Apache-2.0许可证。

## 联系方式

如有问题或建议，请通过以下方式联系：

- 项目地址: [GitHub Repository]
- 问题反馈: [Issues]

## 更新日志

### v1.0.0 (2026-02-26)

- 初始版本发布
- 实现基本文件上传功能
- 添加Bootstrap美化界面
- 实现弹窗提示功能
- 添加文件命名规则