dede 缩略图不识别jpeg

问题根源分析

主要有两个层面的问题：

1. PHP getimagesize() 函数的限制：

   • 这个函数在读取图片信息时,依赖于文件的“魔数”（Magic Number），也就是文件头部的特定字节序列，而不是文件的后缀名。
   • 虽然 getimagesize() 本身能识别 jpeg 格式的图片，但它要求文件后缀名必须是它所支持的格式之一，其中并不包含 jpeg，它主要识别 .jpg, .jpeg, .png, .gif 等。
   • 当你上传一个 image.jpeg 文件时，getimagesize() 可能会因为文件后缀不匹配其内部预期而返回 false 或 null，导致 DedecCMS 无法获取图片的宽度和高度信息。

2. DedeCMS 程序的后缀名白名单限制：

   • 在 include/helpers/upload.helper.php 文件中，DedeCMS 定义了一个允许上传的文件后缀名列表。
   • 这个列表通常只包含了 jpg, png, gif 等，而没有 jpeg，即使 PHP 环境允许，DedeCMS 的上传器在第一步就会拒绝后缀为 jpeg 的文件。

要解决这个问题,必须从以上两个层面入手，修改 DedecCMS 的配置，让它“认识”并“允许” jpeg 这个后缀。

解决方案

请按照以下步骤操作,建议在修改前备份相关文件。

第一步：修改上传类文件，允许 jpeg 后缀

这是最关键的一步,需要修改 DedecCMS 的核心上传类文件。

1. 找到文件： 打开您的 DedecCMS 安装目录，找到以下文件： include/helpers/upload.helper.php

2. 编辑文件： 用代码编辑器（如 VS Code, Sublime Text, Notepad++ 等）打开该文件。

3. 找到并修改代码： 在文件中搜索 $cfg_upext 这个变量，你会找到类似下面这样的代码：

   // 在文件中找到这个数组
   $cfg_upext = array('jpg', 'png', 'gif', 'bmp', 'jpeg');
   // 或者可能是这样
   $cfg_upext = 'jpg,png,gif,bmp,jpeg';
   // 或者是下面这种更严格的定义
   $cfg_upext = array(
       'image/jpeg',
       'image/pjpeg',
       'image/png',
       'image/gif',
       'image/bmp'
   );

4. 确保 jpeg 在列表中：

   • $cfg_upext 是一个数组，请确保 'jpeg' 在其中，很多时候它可能只有 'jpg'，你需要手动加上 'jpeg'。
   • $cfg_upext 是一个字符串，请确保 ',jpeg' 在其中。

   修改后的示例（数组形式）：

   // 修改前
   // $cfg_upext = array('jpg', 'png', 'gif', 'bmp');
   // 修改后
   $cfg_upext = array('jpg', 'png', 'gif', 'bmp', 'jpeg');

   修改后的示例（字符串形式）：

   // 修改前
   // $cfg_upext = 'jpg,png,gif,bmp';
   // 修改后
   $cfg_upext = 'jpg,png,gif,bmp,jpeg';

   修改后的示例（MIME 类型形式）：

   // 修改前
   // $cfg_upext = array('image/jpeg', 'image/png', 'image/gif', 'image/bmp');
   // 修改后
   $cfg_upext = array('image/jpeg', 'image/pjpeg', 'image/png', 'image/gif', 'image/bmp');

   注意：MIME 类型中，image/jpeg 和 image/pjpeg (用于旧版IE) 都代表 JPEG 图片。

5. 保存文件。

完成这一步后,DedeCMS 的上传器就允许你上传后缀为 jpeg 的文件了。

第二步：处理缩略图识别问题

如果上传后,系统仍然无法识别 jpeg 图片来生成缩略图（在“系统基本参数”-“图片默认尺寸”里设置自动生成缩略图时失败），那么问题可能出在 getimagesize() 函数上。

由于 getimagesize() 函数本身在识别文件内容时没有问题，但 DedecCMS 在调用它时可能会因为后缀名问题而出错，最稳妥的解决方法是将已上传的 image.jpeg 文件重命名为 image.jpg。

操作方法：

1. 通过 FTP 或文件管理器：

   • 登录您的服务器,找到 /uploads/ 目录。
   • 找到所有后缀为 .jpeg 的图片文件。
   • 将它们全部重命名为 .jpg，将 abc.jpeg 重命名为 abc.jpg。

2. 批量替换数据库（高级操作，谨慎使用）： 如果图片数量非常多，手动修改不现实，可以考虑批量修改数据库，但这有风险，请务必先备份数据库！

   • 找到数据表：图片的路径通常存储在 dede_archives (文章表)、dede_addonarticle (文章附加表) 或其他自定义模型的附加表中，字段名可能是 litpic (缩略图) 或 body (文章正文，里面可能包含图片路径)。

   • 执行 SQL 更新语句： 以 dede_archives 表的 litpic 字段为例，你可以使用以下 SQL 语句：

     -- 更新缩略图路径
     UPDATE `dede_archives` SET `litpic` = REPLACE(`litpic`, '.jpeg', '.jpg') WHERE `litpic` LIKE '%.jpeg';
     -- 如果图片路径在文章正文中，也需要更新
     UPDATE `dede_addonarticle` SET `body` = REPLACE(`body`, '.jpeg', '.jpg') WHERE `body` LIKE '%.jpeg';

     注意：请将 dede_ 替换为您自己的数据库表前缀。

   • 验证：执行 SQL 后，再到网站后台“文档HTML更新”-“一键更新所有文档”，让系统重新生成文档，检查图片是否正常显示。

总结与最佳实践

1. 根本解决：通过修改 include/helpers/upload.helper.php 文件，从源头上杜绝 jpeg 文件的产生，这是最推荐的做法，可以一劳永逸。
2. 事后补救：如果已经存在大量 .jpeg 文件，通过 FTP 重命名或数据库批量替换来修正。
3. 统一规范：建议在网站建设初期就统一图片后缀名规范，全部使用 .jpg，避免此类问题再次发生。

希望这个详细的解决方案能帮助您成功解决问题！