Hostinger环境下PHP表单上传图片至数据库及文件夹失败问题

结论：完全可以通过PHP表单在Hostinger主机实现图片上传到文件夹并将记录存入数据库，本地正常但部署后失效，基本是环境配置、权限或代码适配问题，以下是针对性修复方案：

一、核心排查与修复点 #

1. 上传目录权限问题 #

Hostinger服务器对目录权限有严格限制，uploads/目录需配置正确权限：

• 手动确认uploads/目录存在，不存在则创建
• 将目录权限设置为755（所有者可读可写可执行，其他用户可读可执行），测试阶段可临时设为777验证权限问题，测试后改回755保障安全

2. PHP上传参数限制 #

Hostinger默认PHP配置有上传大小限制，需调整：

• 若能修改php.ini，将upload_max_filesize和post_max_size设为大于你要上传的文件大小（如10M）
• 无法修改全局配置时，在项目根目录创建.htaccess文件，添加：

php_value upload_max_filesize 10M
php_value post_max_size 10M
php_value max_execution_time 300

3. 文件路径适配问题 #

代码中相对路径uploads/在Hostinger虚拟主机环境可能失效，改用绝对路径：

// 通过服务器变量获取站点根目录，拼接上传路径
$targetDir = $_SERVER['DOCUMENT_ROOT'] . "/uploads/";
// 确保目录存在，不存在则递归创建
if (!is_dir($targetDir)) {
    mkdir($targetDir, 0755, true);
}

4. 数据库操作优化与错误捕获 #

原代码存在SQL注入风险，且未捕获数据库错误，无法定位问题：

• 替换SQL拼接为预处理语句：

$stmt = $db->prepare("INSERT into images (file_name, uploaded_on) VALUES (?, NOW())");
$stmt->bind_param("s", $fileName);
$insert = $stmt->execute();

• 添加数据库错误捕获：

if (!$insert) {
    $statusMsg = "数据库插入失败：" . $db->error;
}

5. 上传错误码精准排查 #

move_uploaded_file失败时，通过错误码定位具体问题：

if ($_FILES["file"]["error"] !== UPLOAD_ERR_OK) {
    $errorCode = $_FILES["file"]["error"];
    switch($errorCode){
        case UPLOAD_ERR_INI_SIZE: $statusMsg = "文件超过php.ini中upload_max_filesize限制"; break;
        case UPLOAD_ERR_FORM_SIZE: $statusMsg = "文件超过表单中MAX_FILE_SIZE限制"; break;
        case UPLOAD_ERR_PARTIAL: $statusMsg = "文件仅部分上传"; break;
        case UPLOAD_ERR_NO_TMP_DIR: $statusMsg = "服务器找不到临时文件夹"; break;
        case UPLOAD_ERR_CANT_WRITE: $statusMsg = "文件写入磁盘失败"; break;
        default: $statusMsg = "未知上传错误，错误码：".$errorCode;
    }
}

二、修复后的完整代码 #

<?php
include 'dbConfig.php';
$statusMsg = '';

// 使用绝对路径确保兼容性
$targetDir = $_SERVER['DOCUMENT_ROOT'] . "/uploads/";
// 自动创建上传目录
if (!is_dir($targetDir)) {
    mkdir($targetDir, 0755, true);
}

$fileName = time() . '_' . basename($_FILES["file"]["name"]); // 重命名避免文件名冲突
$targetFilePath = $targetDir . $fileName;
$fileType = strtolower(pathinfo($targetFilePath, PATHINFO_EXTENSION));

if (isset($_POST["submit"]) && !empty($_FILES["file"]["name"])) {
    $allowTypes = array('jpg','png','jpeg','gif','pdf');
    if (in_array($fileType, $allowTypes)) {
        // 先检查上传错误码
        if ($_FILES["file"]["error"] !== UPLOAD_ERR_OK) {
            $errorCode = $_FILES["file"]["error"];
            switch($errorCode){
                case UPLOAD_ERR_INI_SIZE: $statusMsg = "文件超过php.ini中upload_max_filesize限制"; break;
                case UPLOAD_ERR_FORM_SIZE: $statusMsg = "文件超过表单中MAX_FILE_SIZE限制"; break;
                case UPLOAD_ERR_PARTIAL: $statusMsg = "文件仅部分上传"; break;
                case UPLOAD_ERR_NO_TMP_DIR: $statusMsg = "服务器找不到临时文件夹"; break;
                case UPLOAD_ERR_CANT_WRITE: $statusMsg = "文件写入磁盘失败"; break;
                default: $statusMsg = "未知上传错误，错误码：".$errorCode;
            }
        } elseif (move_uploaded_file($_FILES["file"]["tmp_name"], $targetFilePath)) {
            // 预处理语句防SQL注入
            $stmt = $db->prepare("INSERT into images (file_name, uploaded_on) VALUES (?, NOW())");
            $stmt->bind_param("s", $fileName);
            $insert = $stmt->execute();

            if ($insert) {
                $statusMsg = "文件 ".$fileName." 上传成功。";
            } else {
                $statusMsg = "数据库插入失败：" . $db->error;
            }
        } else {
            $statusMsg = "文件移动失败，请检查目录权限。";
        }
    } else {
        $statusMsg = '仅允许上传JPG、JPEG、PNG、GIF、PDF格式文件。';
    }
} else {
    $statusMsg = '请选择要上传的文件。';
}

echo $statusMsg;
?>

额外注意事项 #

• 若上传被拦截，可能是Hostinger开启了mod_security模块，可联系客服临时关闭测试
• 对文件名重命名（如时间戳+原文件名）可避免特殊字符导致的路径解析错误

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