PHP上传文件时.htaccess配置参数完全不生效该如何排查解决？

核心原因 #

• PHP运行模式导致.htaccess配置未实际生效
  如果你的服务器用的是FastCGI/PHP-FPM模式运行PHP，只有Apache mod_php模式才支持.htaccess里的php_value指令修改PHP配置，FPM模式下该指令默认无效。你确认的.htaccess生效一般指rewrite等Apache原生配置生效，不代表PHP配置修改能力生效。
• 配置被更高优先级的规则覆盖
  如果服务器全局php.ini、虚拟主机配置中用了php_admin_value指定了上传相关参数，该指令不允许被.htaccess的配置覆盖，你写的参数不会生效。
• 你的上传脚本缺失所有校验逻辑
  你当前的脚本完全没有对上传错误、文件大小、文件类型、上传数量做判断，就算PHP配置生效触发了上传限制，你也收不到明确的错误提示，甚至会误认为限制被绕过：
  • 你配置的三个PHP参数本身就不包含文件类型限制逻辑，想限制文件类型必须额外加规则
  • 上传超过大小限制时PHP会给$_FILES['sharex']['error']赋值为错误码1，你没有判断该字段，直接执行后续逻辑，只会得到通用的内部错误提示，无法判断是配置生效还是真的服务器错误
  • 多文件上传的限制只有你用数组形式的上传字段（比如name="sharex[]"）时才会触发，你当前代码只处理单个sharex字段，自然不会触发数量限制

解决步骤 #

1. 先确认配置是否实际生效
   新建一个info.php文件，写入代码<?php phpinfo(); ?>，上传到站点目录后访问该文件，查看post_max_size、upload_max_filesize、max_file_uploads三个参数的local值是否和你设置的一致，就能确认配置是否真的生效。
2. 适配PHP运行模式修改配置
   如果确认配置未生效且你用的是PHP-FPM模式，有两种修改方式：

• 找服务商获取站点自定义php.ini的路径，在该文件中添加上传参数配置，优先级高于.htaccess
• 联系服务商帮你修改对应站点的FPM池配置，添加上传限制参数

3. 给脚本添加上传校验逻辑
   不要完全依赖PHP的全局配置，在业务层加双重校验更安全，参考添加以下逻辑：

// 先判断上传错误
if ($_FILES["sharex"]["error"] !== UPLOAD_ERR_OK) {
    $errors = [
        1 => '文件大小超过服务器限制',
        2 => '文件大小超过表单限制',
        3 => '文件上传不完整',
        4 => '未选择上传文件'
    ];
    echo 'ERROR: ' . ($errors[$_FILES["sharex"]["error"]] ?? '未知上传错误');
    exit;
}
// 校验文件大小 8M = 8*1024*1024 = 8388608字节
if ($_FILES["sharex"]["size"] > 8388608) {
    echo 'ERROR: 文件大小不能超过8M';
    exit;
}
// 白名单校验文件类型，示例只允许图片，可按需修改
$allowedExt = ['jpg', 'jpeg', 'png', 'gif', 'webp'];
$fileType = strtolower(pathinfo($_FILES["sharex"]["name"], PATHINFO_EXTENSION));
if (!in_array($fileType, $allowedExt)) {
    echo 'ERROR: 不允许上传该类型文件';
    exit;
}
// 可选：校验文件实际内容避免后缀伪造
$finfo = new Finfo(FILEINFO_MIME_TYPE);
$mime = $finfo->file($_FILES["sharex"]["tmp_name"]);
$allowedMime = ['image/jpeg', 'image/png', 'image/gif', 'image/webp'];
if (!in_array($mime, $allowedMime)) {
    echo 'ERROR: 文件内容不符合要求';
    exit;
}

4. 如需在.htaccess层加额外限制，可添加文件执行拦截规则，避免上传木马被执行：

<FilesMatch "\.(php|php5|phtml)$">
    Deny from all
</FilesMatch>

内容的提问来源于stack exchange，提问作者visual