如何使用 cURL 自动上传文件并从 URL 参数中获取文件名

落静姑娘_3553

落静姑娘_3553

2026-07-10

159人浏览

原创

如何使用 cURL 自动上传文件并从 URL 参数中获取文件名

本文讲解如何通过 cURL 命令向 PHP 服务器上传文件,并让服务端自动从 URL 查询参数(如 ?fname=test.txt)中读取目标文件名,避免依赖 HTML 表单手动选择,适用于自动化部署场景。

本文讲解如何通过 curl 命令向 php 服务器上传文件,并让服务端自动从 url 查询参数(如 `?fname=test.txt`)中读取目标文件名,避免依赖 html 表单手动选择,适用于自动化部署场景。

在实际运维或 CI/CD 流程中,常需从 Linux 服务器自动上传固定名称的配置文件(如 test.txt)到 PHP 后端。此时不应依赖浏览器表单交互,而应通过命令行工具(如 curl)完成上传,并确保服务端能安全、可靠地解析并保存文件。

但需注意:原始问题中的思路存在关键误区——URL 中的 ?fname=test.txt 并不会自动成为上传文件的名称,因为 HTTP 文件上传(multipart/form-data)的文件名由客户端在请求体中显式指定,而非从查询字符串(query string)中提取。PHP 的 $_FILES['fname'] 中的 'name' 字段来源于客户端提交的 Content-Disposition 头(如 filename="test.txt"),与 URL 参数无关。

✅ 正确做法分两步:

  1. 客户端(cURL):显式指定上传字段名和本地路径,并可选传递额外参数
    使用 -F 参数模拟表单提交,其中 @ 符号表示读取本地文件。若需将原始文件名透传给服务端,推荐直接利用 $_FILES 的默认行为(cURL 会自动将本地文件名写入 $_FILES['uploadedfile']['name']),无需额外 URL 参数:

    curl -F "uploadedfile=@/path/to/test.txt" "http://myserver.com/upload.php"

    若仍需保留 fname 作为 URL 参数(例如用于日志记录、权限校验等),可同时携带:

    CurlShip Directory Submission
    CurlShip Directory Submission

    向CurlShip提交产品,这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品,支持OG标签抓取、带徽章的dofollow链接及层级升级。

    下载
    curl -F "uploadedfile=@/path/to/test.txt" "http://myserver.com/upload.php?fname=test.txt"
  2. 服务端(PHP):增强健壮性,支持「优先使用上传文件原名,备用 fallback 到 URL 参数」
    修改原 PHP 脚本,不再硬编码依赖 $_FILES['fname'](因 cURL 提交的是 uploadedfile 字段),并增加对 $_GET['fname'] 的安全校验与降级处理:

    <?php // 安全校验:仅允许 POST 请求 + 文件上传
    if ($_SERVER['REQUEST_METHOD'] !== 'POST' || !isset($_FILES['uploadedfile'])) {
        http_response_code(400);
        die("Invalid request: file upload required.");
    }
    
    $errors = [];
    $file_tmp = $_FILES['uploadedfile']['tmp_name'];
    $file_name_from_upload = basename($_FILES['uploadedfile']['name']); // 防止路径遍历
    $file_ext = strtolower(pathinfo($file_name_from_upload, PATHINFO_EXTENSION));
    
    // 可选:从 URL 获取期望文件名(需严格校验)
    $expected_name = isset($_GET['fname']) ? basename(trim($_GET['fname'])) : '';
    $final_name = !empty($expected_name) && in_array($file_ext, ['txt']) 
        ? $expected_name 
        : $file_name_from_upload;
    
    // 白名单校验扩展名
    $allowed_exts = ['txt'];
    if (!in_array($file_ext, $allowed_exts)) {
        $errors[] = "Only .txt files are allowed.";
    }
    
    // 检查临时文件是否存在且上传成功
    if (!is_uploaded_file($file_tmp)) {
        $errors[] = "File upload failed.";
    }
    
    // 目录安全检查
    $upload_dir = __DIR__ . '/download/';
    if (!is_dir($upload_dir) && !mkdir($upload_dir, 0755, true)) {
        $errors[] = "Upload directory is not writable.";
    }
    
    if (empty($errors)) {
        $target_path = $upload_dir . $final_name;
        if (move_uploaded_file($file_tmp, $target_path)) {
            echo "Success: {$final_name} uploaded.";
        } else {
            $errors[] = "Failed to save file.";
        }
    }
    
    if (!empty($errors)) {
        http_response_code(400);
        echo "Errors:\n" . implode("\n", $errors);
    }
    ?>

⚠️ 重要注意事项:

  • 永远不要直接信任 $_GET['fname'] 或 $_FILES['name']:必须使用 basename() 过滤路径遍历(如 ../../etc/passwd),并结合白名单验证扩展名;
  • -F 参数中字段名须与 PHP 中 $_FILES 键名一致:示例中 cURL 用 uploadedfile,PHP 就读 $_FILES['uploadedfile'];
  • 不建议移除 HTML 表单:开发调试时保留表单有助于快速验证逻辑,生产环境则禁用或移除 部分;
  • 权限与目录安全:确保 download/ 目录不在 Web 可访问路径下,或配置 Web 服务器禁止执行其中脚本。

通过以上改造,即可实现全自动、安全、可维护的文件上传流程,兼顾灵活性与安全性。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

curl

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
curl_exec
curl_exec

curl_exec函数是PHP cURL函数列表中的一种,它的功能是执行一个cURL会话。给大家总结了一下php curl_exec函数的一些用法实例,这个函数应该在初始化一个cURL会话并且全部的选项都被设置后被调用。他的返回值成功时返回TRUE, 或者在失败时返回FALSE。

2023.06.14

4023

6

linux常见下载安装工具
linux常见下载安装工具

linux常见下载安装工具有APT、YUM、DNF、Snapcraft、Flatpak、AppImage、Wget、Curl等。想了解更多linux常见下载安装工具相关内容,可以阅读本专题下面的文章。

2023.10.30

975

4

Nginx CVE-2026-123007排查与防护指南
Nginx CVE-2026-123007排查与防护指南

Nginx HTTP/2漏洞该怎么修复?本专题围绕CVE-2026-123007,介绍安全版本升级、模块兼容检查和配置恢复方法,以及日志排查、权限设置等后续加固操作,方便你按实际部署情况查找对应教程。

2026.11.20

0

8

GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

2026.11.17

20

15

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

2026.11.17

60

15

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

2026.11.17

80

15

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

2026.11.17

20

10

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

2026.11.17

80

11

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

2026.11.17

40

16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP使用CURL抓取页面
PHP使用CURL抓取页面

共4课时 | 3.1万人学习

前端最全HTTP基础原理及应用
前端最全HTTP基础原理及应用

共12课时 | 2.2万人学习