这套 PHP 图库系统是一套「上传即用」的轻量图片展示站源码,PHP + SQLite 单文件数据库,不依赖 MySQL,前台网格展示、后台管专辑,适合手上有一台 1 核 1G 小 VPS、想给自己做个图床或作品集页面的个人站长。整套程序没有安装向导,也不用导入 SQL 文件,解压改配置就能进后台。
在搭建168 的「其它源码」分类里,这类体积小的 PHP 程序其实挺容易被忽略——大家更愿意找带框架的大件。但真要落地一个只放图、能外链、能随机出图的站,这种单文件数据库的方案反而省事:不用装 MySQL,不用配账号权限,备份就是拷一个 .db 文件。下面按我实际部署的顺序拆开讲。
整套源码真正需要你动手的地方只有一个文件:根目录下的 config.php,里面 4 个配置项,其中 3 个必改。后台入口固定是 /admin.php,登录账号密码不写在数据库里,而是从这个文件读。
我部署的时候发现一个细节:程序第一次访问时会自动生成 SQLite 数据库文件,也就是说根目录必须可写。很多人卡在「后台登录没反应」,其实是目录权限 755 挡住了写库,跟密码一点关系没有。
马上能用的 checklist:改完 config.php 后先 curl -I 你的域名/admin.php 看返回码是不是 200,再去浏览器登录;如果服务器开了 OPcache,改完记得 reload 一次 php-fpm,否则改了等于没改。
功能不花哨,但刚好覆盖「放图—控权限—对外供图」这条链路,实测 3 个模块开箱即用,不需要装插件。
| 功能 | 入口位置 | 实际用起来的注意点 |
|---|---|---|
| 图片批量上传 | 后台图片管理 | 支持本地存储与外链图床两种落地方式,一次传几十张没问题,前提是 PHP 的 upload_max_filesize 和 post_max_size 要跟着调 |
| 密码查看 / 隐藏图片 | 后台专辑设置 | 粒度是「专辑」级,不是单张图,密码给整个专辑设一把锁 |
| 随机图片 API | 前台接口 | 一个端点,直接拿去当博客侧边栏随机图、友链随机头像都行 |
后台里有个设置项容易被跳过:专辑的排序与显示开关。默认新建专辑是不在前台导航出现的,我第一次传完图刷新前台以为坏了,其实是没勾「显示」。批量上传前建议先把 post_max_size 调到 64M 以上,不然后台会静默丢图——页面不报错,但列表里少几张,这个坑挺隐蔽。
标准 LAMP/LNMP 环境就够,整个流程 5 步,熟练的话 10 分钟内能跑起来。不需要 Composer,不需要 Node,不用配伪静态(除非你自己加规则)。
| 项目 | 要求 |
|---|---|
| PHP | 7.4 及以上,推荐 8.0 / 8.1 |
| 扩展 | pdo_sqlite、sqlite3、gd(缩略图相关)、fileinfo |
| 数据库 | 无需 MySQL,SQLite 3 自动生成单文件 |
| Web 服务器 | Nginx 或 Apache 均可 |
| 硬件 | 1 核 1G 起步,磁盘按图片量算 |
实测下来,前台列表走的是分页 + 图片网格,服务端没做缩略图裁剪,原图多大就加载多大。所以上线前最好在本地把图压到 300KB 以内,手机端首屏体验会差一个档次——这一步比换服务器管用。
它的定位很清楚:单人维护、图量在千级以内、需要外链和随机图的场景。对上了就很顺,对不上会一直别扭。
适合的:个人图床 / 摄影作品集、博客文章配图外链、小型团队内部素材墙、给静态站做随机头图。在搭建168 找「其它源码」的朋友如果是给客户做个简易相册展示,这套也够交差。
别硬上的 3 种:一是需要多用户注册投稿,它只有单管理员;二是需要自动裁剪、加水印、CDN 回源那套图片处理流水线,它没有;三是图片量上万还要求关键词全文检索,SQLite 的查询会明显变慢。
还有一个上线前必须知道的事:SQLite 是写锁机制,多人同时批量上传容易出现「上传成功但列表不刷新」的假象,本质是写并发排队。所以后台操作最好一个人来做,或者避开高峰期传图。
问:随机图 API 能不能只取某个专辑里的图?
答:可以,通过专辑参数限定范围,不带参数时默认全库随机。返回的是图片直链,直接 <img src> 引用就行,不需要额外写解析。
问:SQLite 扛得住多少张图?
答:单库几千条记录基本无感,前端列表分页加载。真正的瓶颈是磁盘和带宽,不是数据库。图片量过万时建议改用外链图床模式,本地只存路径。
问:改了 config.php 里的密码,后台还是登不进去?
答:先确认改的是站点根目录那份文件(别改到备份目录里),再清一次

⚠️ 本文仅供学习研究和技术交流,相关源码仅用于了解系统架构与部署流程,请勿用于非法用途。任何商业运营行为均与作者无关。