XAMPP搭建私有图床环境教程

XAMPP虽不自带图床功能，却是搭建私有图床（如Chevereto、imgurl、Lychee）的理想本地运行环境——关键在于精准匹配图床程序的兼容性要求：从PHP版本（7.4–8.2）、MySQL/SQLite支持、mod_rewrite启用，到上传限制调高、utf8mb4字符集配置及目录写入权限修复，每一步都直接影响图床能否顺利安装与稳定运行；本文直击新手易踩的五大坑——默认模块禁用、配置未重启、字符集乱码、上传大小受限、文件夹只读锁定，帮你绕过试错弯路，快速拥有一个安全、可控、可扩展的私人图床系统。

直接说结论：XAMPP 本身不自带图床功能，但能为图床系统（如 chevereto、imgurl、Uptime-Kuma 类静态上传服务除外）提供运行所需的 Apache + PHP + MySQL 组合；关键不是“XAMPP 能不能搭图床”，而是你选的图床程序是否兼容 PHP 7.4–8.2、是否支持 MySQL 或 SQLite、是否要求 mod_rewrite 或文件写入权限。

确认图床程序对 XAMPP 的兼容性要求

不同图床依赖差异大，别盲目解压就扔进 htdocs：

• chevereto-free（v4.x）要求 PHP ≥ 8.0、MySQL ≥ 5.7、GD 和 exif 扩展开启，且必须启用 mod_rewrite；XAMPP 默认 PHP 版本可能偏低（如 7.4），需手动切换或升级
• imgurl（PHP 版）轻量，支持 PHP 7.2+ 和 SQLite，可跳过 MySQL 配置，但需确保 fileinfo 和 curl 扩展已启用
• Lychee（v4+）强制要求 PHP ≥ 8.1、MySQL ≥ 5.7.22，且需 imagick 或 gd 处理缩略图——XAMPP 自带的 PHP 通常没编译 imagick，得额外装 DLL 并改 php.ini
• 纯前端图床（如 Uppy + 自定义后端）不依赖 XAMPP 运行逻辑，但上传接口仍需 PHP 脚本支撑，此时重点检查 upload_max_filesize 和 post_max_size 是否足够

Apache 必须启用 mod_rewrite 且配置好 .htaccess

绝大多数图床（chevereto、Lychee）靠重写规则实现友好 URL，XAMPP 默认禁用该模块：

• 打开 \xampp\apache\conf\httpd.conf，搜索 #LoadModule rewrite_module modules/mod_rewrite.so，删掉开头的 #
• 继续搜索 块（通常在 DocumentRoot 配置下方），把其中的 AllowOverride None 改成 AllowOverride All
• 重启 Apache，否则访问图床首页会报 404 或白屏

PHP 配置必须调高上传与执行限制

图床上传动辄几 MB～几十 MB，XAMPP 默认值（2M）根本不够用：

• 编辑 \xampp\php\php.ini，修改以下三项（单位是字节，M 表示兆）：
  upload_max_filesize = 64M
post_max_size = 128M
max_execution_time = 300
• 若图床生成缩略图卡住，再加一行：memory_limit = 256M
• 改完必须重启 Apache，否则 PHP 不会加载新配置

MySQL 字符集务必设为 utf8mb4

用户上传带 emoji 的文件名、中文标签、特殊符号时，MySQL 默认 latin1 会存成乱码或直接报错：

• 编辑 \xampp\mysql\bin\my.ini，在 [mysqld] 段落下添加：
  character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
• 重启 MySQL，然后进 phpMyAdmin → 选中对应数据库 → “操作”页 → 把“排序规则”改为 utf8mb4_unicode_ci
• 注意：仅改配置文件不生效，数据库和数据表的字符集都得手动同步更新

真正容易被忽略的是图床安装后的权限问题：XAMPP 进程以当前 Windows 用户身份运行，但 htdocs 下的图床目录若从 ZIP 解压而来，可能继承了只读属性或被杀毒软件锁定，导致安装时提示“无法创建 app/settings.php”或“缓存目录不可写”——这时得右键文件夹 → 属性 → 取消“只读”，再进安全选项卡赋予当前用户“完全控制”权限。

理论要掌握，实操不能落！以上关于《XAMPP搭建私有图床环境教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！