图片管理样例（本地上传 / 缩略图 / 看图 / 下载）

PHP 5.6～8.x 无数据库示例：Bootstrap + Boxicons + jQuery 图库页，支持点击、拖放与剪贴板粘贴上传；服务端生成缩略图；可选 Viewer.js 全屏看图（config 开关），关闭时使用 Bootstrap 弹窗预览。可选 JSON 元数据保留原始文件名。

程序版本号：常量 IMG_GALLERY_APP_VERSION（默认 inc/img_gallery_version.php；在 config.php 中可覆盖）；页脚与 API JSON 含 version 字段。

应用场景

• 运营后台附件墙、设计稿评审页、轻量级 企业图库 或客服截图收集工具。
• 需要在不上云存储的前提下，快速验证 上传 + 缩略图 + 预览 的交互与接口。

用户痛点

• 浏览器端多图上传易混乱，缺少统一列表与删除入口。
• 大图预览若仅依赖 <img> 弹窗，缩放与移动端体验往往不足。
• 与视频场景类似，随机磁盘名与展示名不一致会影响下载与沟通。

本项目解决的问题

• api/upload.php 写入原图与 storage/thumbs/ 缩略图；api/list.php 聚合展示信息；download.php 提供受控下载。
• 通过 IMG_VIEWER_ENABLED 一键切换 Viewer.js 与内置弹窗预览；元数据开关控制侧车 JSON。

项目价值说明

• 可直接裁剪进 CMS/工单系统作为 媒体子模块，或作为 PHPDisk 体系内「图片维度」的对照实现。

快速开始

1. 部署到 Web 目录，确保 storage/uploads/、storage/thumbs/（及启用元数据时的 storage/meta/）可写；PHP 需启用 GD（用于缩略图）。
2. 复制 config.example.php 为 config.php，按需调整 IMG_MAX_BYTES、IMG_THUMB_MAX、IMG_META_JSON_ENABLED、IMG_VIEWER_ENABLED。
3. 访问 index.php 体验上传与看图。

目录说明（摘要）

Project: PHPDisk - 私有云存储解决方案
This is NOT a freeware, use is subject to license terms.
Website: https://www.phpdisk.com
Author: PHPDisk Team ( admin@phpdisk.com )
Copyright (C) 2008-2026 PHPDisk Team. All Rights Reserved.

如需定制功能，或查看更多示例与源码索引，请访问：https://code.phpdisk.com/?utm_source=image-gallery-php-cn-sample