编辑“︁PHP文件上传表单”︁

= PHP文件上传表单 =

== 介绍 ==
PHP文件上传表单允许用户通过网页界面上传文件到服务器。这是Web开发中常见的功能，广泛应用于头像上传、文档提交、图片分享等场景。PHP通过<code>$_FILES</code>超全局变量处理上传的文件，并结合HTML表单的<code><input type="file"></code>元素实现。

文件上传涉及客户端（浏览器）和服务器端（PHP）的协作：
# 用户通过HTML表单选择文件并提交。
# PHP接收文件并临时存储在服务器。
# PHP脚本验证文件后将其移动到永久目录。

== 基础实现 ==

=== HTML表单 ===
文件上传表单必须设置<code>enctype="multipart/form-data"</code>，否则文件无法上传。

<syntaxhighlight lang="html">
<form action="upload.php" method="post" enctype="multipart/form-data">
    <label for="file">选择文件：</label>
    <input type="file" name="file" id="file">
    <input type="submit" value="上传">
</form>
</syntaxhighlight>

=== PHP处理脚本 ===
以下是最基础的上传处理脚本（upload.php）：

<syntaxhighlight lang="php">
<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    $targetDir = "uploads/";
    $targetFile = $targetDir . basename($_FILES["file"]["name"]);
    
    if (move_uploaded_file($_FILES["file"]["tmp_name"], $targetFile)) {
        echo "文件 ". htmlspecialchars(basename($_FILES["file"]["name"])). " 上传成功";
    } else {
        echo "上传失败";
    }
}
?>
</syntaxhighlight>

== $_FILES数组详解 ==
PHP将每个上传文件的信息存储在<code>$_FILES</code>数组中，包含以下键：

{| class="wikitable"
|-
! 键名 !! 描述
|-
| name || 原始文件名
|-
| type || 文件MIME类型（如image/jpeg）
|-
| tmp_name || 服务器上的临时文件名
|-
| error || 错误代码（0表示成功）
|-
| size || 文件大小（字节）
|}

== 安全验证 ==
'''必须'''对上传文件进行严格验证：

=== 文件类型验证 ===
<syntaxhighlight lang="php">
$allowedTypes = ['image/jpeg', 'image/png'];
if (!in_array($_FILES['file']['type'], $allowedTypes)) {
    die("错误：只允许JPEG和PNG文件");
}
</syntaxhighlight>

=== 文件扩展名验证 ===
<syntaxhighlight lang="php">
$extension = strtolower(pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION));
$allowedExtensions = ['jpg', 'jpeg', 'png'];
if (!in_array($extension, $allowedExtensions)) {
    die("错误：无效文件扩展名");
}
</syntaxhighlight>

=== 文件大小限制 ===
<syntaxhighlight lang="php">
$maxSize = 2 * 1024 * 1024; // 2MB
if ($_FILES['file']['size'] > $maxSize) {
    die("错误：文件大小超过2MB限制");
}
</syntaxhighlight>

== 高级处理 ==

=== 生成唯一文件名 ===
防止文件名冲突：

<syntaxhighlight lang="php">
$extension = pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION);
$newFilename = uniqid() . '.' . $extension;
$targetFile = $targetDir . $newFilename;
</syntaxhighlight>

=== 图片处理 ===
使用GD库验证图片有效性：

<syntaxhighlight lang="php">
$imageInfo = getimagesize($_FILES['file']['tmp_name']);
if (!$imageInfo) {
    die("错误：上传的不是有效图片");
}
</syntaxhighlight>

== 错误处理 ==
PHP定义了多种上传错误代码：

{| class="wikitable"
|-
! 值 !! 常量 !! 描述
|-
| 0 || UPLOAD_ERR_OK || 成功
|-
| 1 || UPLOAD_ERR_INI_SIZE || 超过php.ini中的upload_max_filesize
|-
| 2 || UPLOAD_ERR_FORM_SIZE || 超过HTML表单中的MAX_FILE_SIZE
|-
| 3 || UPLOAD_ERR_PARTIAL || 文件只有部分被上传
|-
| 4 || UPLOAD_ERR_NO_FILE || 没有文件被上传
|}

处理示例：
<syntaxhighlight lang="php">
if ($_FILES['file']['error'] !== UPLOAD_ERR_OK) {
    switch ($_FILES['file']['error']) {
        case UPLOAD_ERR_INI_SIZE:
            die("错误：文件超过服务器限制");
        // 其他错误处理...
    }
}
</syntaxhighlight>

== 实际案例：头像上传系统 ==

=== 完整实现 ===
<syntaxhighlight lang="php">
<?php
if ($_SERVER['REQUEST_METHOD'] === 'POST') {
    // 配置
    $uploadDir = 'avatars/';
    $allowedTypes = ['image/jpeg', 'image/png'];
    $maxSize = 1 * 1024 * 1024; // 1MB
    
    // 验证
    if ($_FILES['avatar']['error'] !== UPLOAD_ERR_OK) {
        die("上传错误：". $_FILES['avatar']['error']);
    }
    
    if (!in_array($_FILES['avatar']['type'], $allowedTypes)) {
        die("错误：只允许JPEG和PNG图片");
    }
    
    if ($_FILES['avatar']['size'] > $maxSize) {
        die("错误：图片大小超过1MB限制");
    }
    
    // 生成唯一文件名
    $extension = strtolower(pathinfo($_FILES['avatar']['name'], PATHINFO_EXTENSION));
    $filename = 'user_' . time() . '.' . $extension;
    $destination = $uploadDir . $filename;
    
    // 移动文件
    if (move_uploaded_file($_FILES['avatar']['tmp_name'], $destination)) {
        echo "头像上传成功！";
        // 这里可以更新数据库中的用户头像路径
    } else {
        echo "头像保存失败";
    }
}
?>
</syntaxhighlight>

== 服务器配置 ==
PHP文件上传需要正确的服务器配置（php.ini）：

{| class="wikitable"
|-
! 指令 !! 建议值 !! 说明
|-
| file_uploads || On || 启用文件上传
|-
| upload_max_filesize || 2M || 单个文件最大尺寸
|-
| post_max_size || 8M || POST数据最大尺寸
|-
| upload_tmp_dir || /tmp || 临时目录路径
|}

== 文件上传流程 ==
<mermaid>
sequenceDiagram
    participant 用户
    participant 浏览器
    participant 服务器
    participant PHP
    
    用户->>浏览器: 选择文件并提交表单
    浏览器->>服务器: 发送multipart/form-data请求
    服务器->>PHP: 接收文件到临时目录
    PHP->>PHP: 验证文件(move_uploaded_file)
    PHP->>服务器: 将文件移动到目标目录
    服务器->>浏览器: 返回上传结果
    浏览器->>用户: 显示结果
</mermaid>

== 常见问题 ==

=== 为什么文件上传后消失了？ ===
PHP会将上传的文件存储在临时目录中（由<code>upload_tmp_dir</code>指定），如果脚本结束时文件未被移动（使用<code>move_uploaded_file()</code>），临时文件会被自动删除。

=== 如何提高上传安全性？ ===
1. 永远不要信任<code>$_FILES['file']['type']</code>，因为它来自客户端
2. 使用<code>is_uploaded_file()</code>验证文件
3. 将上传文件存储在Web根目录外
4. 禁用危险文件类型（如.php）

=== 如何实现分块上传？ ===
对于大文件，可以使用JavaScript库（如Dropzone.js）实现分块上传，或使用PHP的<code>fopen()</code>和<code>fwrite()</code>手动处理。

== 数学计算 ==
计算上传进度百分比：

<math>
\text{上传进度} = \left( \frac{\text{已接收字节数}}{\text{总文件大小}} \right) \times 100\%
</math>

== 总结 ==
PHP文件上传是Web开发的基础功能，但需要特别注意安全性。关键点包括：
* 正确配置HTML表单（<code>enctype="multipart/form-data"</code>）
* 使用<code>$_FILES</code>数组处理上传文件
* 实施严格的文件验证
* 使用<code>move_uploaded_file()</code>而非普通文件函数
* 配置适当的服务器设置

通过遵循这些最佳实践，您可以构建安全可靠的文件上传功能。

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP表单处理]]