# 图片生成程序

**Repository Path**: xpx/image-generation-program

## Basic Information

- **Project Name**: 图片生成程序
- **Description**: 测试图片生成程序。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-03
- **Last Updated**: 2025-12-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PHP 图片生成器

这是一个基于 PHP 的动态图片生成工具，可以根据传入的参数生成带有指定文本和背景的 PNG 图片。支持纯色背景和随机背景图片两种模式，并包含缓存机制以提高性能。

## 功能特点

- 根据 URL 参数动态生成图片
- 支持自定义文本内容
- 支持自定义背景颜色或使用随机背景图片
- 支持自定义图片尺寸
- 内置缓存机制提升重复请求的响应速度
- 自动居中文本显示

## 使用方法

### 基本用法

将 [img.php](img.php) 文件部署到支持 PHP 的服务器上，然后通过以下方式访问：

```
http://yourserver/img.php?[参数]
```

### 可用参数

| 参数 | 描述 | 默认值 | 示例 |
|------|------|--------|------|
| text | 图片上显示的文本 | 空(无文本) | `text=欢迎使用` |
| bg_color | 背景颜色(十六进制) | 随机背景图 | `bg_color=87CEEB` |
| width | 图片宽度(像素) | 400 | `width=600` |
| height | 图片高度(像素) | 200 | `height=300` |

### 使用示例

1. 仅使用默认设置:
   ```
   http://yourserver/img.php
   ```
   效果: 使用默认尺寸 400×200px，无文本，随机背景图片。

2. 使用自定义背景颜色:
   ```
   http://yourserver/img.php?bg_color=FF5733
   ```
   效果: 使用背景颜色 #FF5733，尺寸 400×200px，无文本。

3. 使用自定义尺寸:
   ```
   http://yourserver/img.php?width=600&height=300
   ```
   效果: 使用默认背景色，尺寸 600×300px，无文本。

4. 显示文本:
   ```
   http://yourserver/img.php?text=欢迎使用
   ```
   效果: 使用随机背景图片，尺寸 400×200px，显示文本"欢迎使用"。

5. 组合使用多种参数:
   ```
   http://yourserver/img.php?bg_color=87CEEB&width=600&height=300&text=欢迎使用
   ```
   效果: 使用背景颜色 #87CEEB，尺寸 600×300px，显示文本"欢迎使用"。

## 目录结构

- [img.php](img.php) - 主程序文件
- [/backgrounds](backgrounds/) - 背景图片目录，存放用于随机背景的图片
- [/cache](cache/) - 缓存目录，存放已生成的图片以提高性能
- [SourceHanSansSC-Bold-Min.ttf](SourceHanSansSC-Bold-Min.ttf) - 字体文件

## 系统要求

- PHP 5.6 或更高版本
- GD 库支持

## 注意事项

1. 确保 [/cache](cache/) 目录具有写权限，以便缓存功能正常工作
2. 背景图片支持 JPG、PNG、GIF 格式
3. 文本会自动居中显示在图片上
4. 当同时指定背景颜色(bg_color)和背景图片时，优先使用背景颜色