云图库（SQLite / MySQL + 七牛 / OSS / COS / R2）

PHP 7.2+ 示例：在参考 image-gallery-php-cn-sample 交互风格的基础上，增加 数据库元数据、多云对象存储、分享页、下载统计 与 后台管理（列表 + Chart.js 统计图）。前台使用 Bootstrap + Boxicons + jQuery；R2 使用内置 AWS Signature V4 上传与预签名下载，无需安装 aws-sdk。

程序版本号：常量 IGC_APP_VERSION（默认见 inc/igc_version.php）；在 config.php 中 define('IGC_APP_VERSION', 'x.y.z') 可覆盖（须在 require config.php 之后定义，参见示例注释）。

应用场景

• 企业/团队 素材库、活动照片归档、客服截图留存，需要 按用户/运营维度检索 与简单 用量统计。
• 已使用 七牛、阿里云 OSS、腾讯云 COS 或 Cloudflare R2，希望统一上传接口与分享下载体验。

用户痛点

• 仅本地目录存图难以横向扩容与 CDN 加速；多云各自 SDK 与签名规则分散。
• 无数据库时难以做 下载次数、按天统计、后台筛选。
• 分享外链与后台权限若设计不当，易产生 任意文件被删 或 匿名滥用分享接口 的风险。

本项目解决的问题

• PDO 同时支持 SQLite3（默认 storage/app.db）与 MySQL，首次访问自动 CREATE TABLE。
• 存储驱动：local（零依赖）、r2（纯 PHP+curl）、qiniu / oss / cos（composer install 引入官方 SDK）。
• 上传：服务端 GD 生成缩略图后，主图与缩略图一并写入对象存储；库表记录 public_url / 或 download.php 代理地址。
• 下载：download.php 对本地直出；云端私有桶 302 至签名 URL；公开 CDN 则直接跳转。
• 后台：admin/login.php（默认口令 admin123 对应示例哈希，务必修改）、admin/index.php 仪表盘（Chart.js）、admin/images.php 列表管理。

项目价值说明

• 可作为 PHPDisk 体系内「云对象存储 + 轻量 DAM」的对照实现，按需裁剪进 CMS、工单或内部工具。

快速开始

1. 将目录部署到 Web 根路径或子目录；确保 PHP 启用 PDO（sqlite 或 mysql）、curl（R2/部分云）、GD（缩略图）。
2. 复制 config.example.php 为 config.php（仓库已附带一份便于开箱；生产请自行保管密钥）。按需设置 IGC_STORAGE_PROVIDER 与对应云参数。
3. 使用七牛 / OSS / COS 时，在项目根执行：composer install。
4. 浏览器访问 install.php 一次以创建 storage/uploads、storage/thumbs 并触发建表（也可直接打开 index.php，建表逻辑相同）。
5. 访问 index.php 上传图片；admin/login.php 进入后台查看图表与列表。
6. 可选：将 IGC_VIEWER_ENABLED 设为 true（已复制 assets/viewer 静态资源）。

安全建议（生产）

• 修改 IGC_ADMIN_PASSWORD_HASH（php -r "echo password_hash('你的强口令', PASSWORD_DEFAULT);"）。
• 将 IGC_SHARE_ALLOW_PUBLIC 设为 false，仅登录后台后创建分享。
• 将 IGC_DELETE_REQUIRES_ADMIN 设为 true，禁止匿名删除。
• 配置完成后可删除 install.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-cloud-php-cn-sample