如何在phpEnv中修改PHP上传文件大小限制upload_max_filesize？

在本地开发中使用phpEnv集成的PHP环境时，上传文件经常碰到大小被截断的情况。根本原因是PHP配置文件里对上传体积做了默认约束，其中最核心的就是upload_max_filesize。除了它，post_max_size和max_execution_time也会间接影响大文件上传能否成功。理解这几个指令的关系，才能在phpEnv里把限制改得既有效又不留隐患。

一、phpEnv中PHP配置文件的位置

phpEnv作为Windows下常用的PHP集成环境，会把每个PHP版本独立存放。不同版本的php.ini并不通用，因此修改前必须先确认当前站点用的是哪个PHP版本。打开phpEnv主界面，在顶部或左侧的PHP版本切换处，能看到类似PHP 7.4、PHP 8.1这样的标识，记下正在运行的那一个。

进入phpEnv的安装目录，通常会有一个类似phpenvphpphp-7.4.33-nts的文件夹，里面就有该版本对应的php.ini。也可以直接在phpEnv界面点击对应PHP版本的“配置”或“php.ini”按钮，软件会帮你打开正确文件。注意不要改到phpenv根目录里那些无关的配置模板，那不会生效。

二、修改upload_max_filesize与相关参数

用记事本或VS Code打开php.ini后，搜索upload_max_filesize。默认一般是upload_max_filesize = 2M。把它改成你需要的大小，例如允许传五十兆就写50M。这里的值可以是K、M、G，大小写不敏感，但必须带单位。

只改这一项还不够。PHP在处理表单提交时，整个POST体大小由post_max_size控制，它必须大于或等于upload_max_filesize，否则文件还没到上传阶段就被POST限制拦掉。同时大文件接收慢，若max_execution_time太短会超时，建议脚本执行时间也适当放宽。示例如下：

; 允许单个文件最大 50M
upload_max_filesize = 50M

; POST 总大小要大于上传限制，留点余量
post_max_size = 60M

; 脚本最长执行 300 秒，避免大文件超时
max_execution_time = 300

; 脚本占用内存上限，大文件处理时可能用到
memory_limit = 128M

修改完保存，回到phpEnv界面重启对应PHP服务或重启Apache/Nginx。有些版本切换了PHP后需要整体重启服务才能加载新配置。重启后写个简单的上传页验证即可。

三、用PHP代码验证配置是否生效

配置改完最怕没生效。可以新建一个info.php放在站点目录，内容如下，访问它搜索upload_max_filesize看数值变没变：

<?php
// 输出当前 PHP 上传相关限制
echo 'upload_max_filesize: ' . ini_get('upload_max_filesize') . "<br>";
echo 'post_max_size: ' . ini_get('post_max_size') . "<br>";
echo 'max_execution_time: ' . ini_get('max_execution_time') . "<br>";

// 简单上传表单
if ($_SERVER['REQUEST_METHOD'] === 'POST' && isset($_FILES['file'])) {
    if ($_FILES['file']['error'] === UPLOAD_ERR_OK) {
        move_uploaded_file($_FILES['file']['tmp_name'], __DIR__ . '/' . $_FILES['file']['name']);
        echo '上传成功';
    } else {
        echo '上传失败，错误码：' . $_FILES['file']['error'];
    }
}
?>
<form method="post" enctype="multipart/form-data">
    <input type="file" name="file">
    <button type="submit">上传</button>
</form>

如果页面显示的数值还是旧的限制，说明php.ini路径找错或者服务没重启。这时回到phpEnv确认运行的PHP版本，并用phpinfo里“Loaded Configuration File”一行核对真实加载的ini路径。

四、常见误区与处理建议

一个典型误区是只在phpEnv里点了“修改配置”却没保存，或改了A版本但站点跑的是B版本。另一个误区是web服务器自身也有限制，例如Nginx的client_max_body_size默认只有1M，就算PHP放开，Nginx也会返回413。用Apache一般不受额外体限制约，但也要注意超时设置。

还有人用ini_set()在代码里临时改upload_max_filesize，这通常是无效的，因为该指令属于PHP_INI_PERDIR类型，只能在php.ini、httpd.conf或.user.ini里设置。因此老老实实在phpEnv对应的php.ini中改，并重启服务，是最稳妥的做法。

按照上述步骤在phpEnv中调整并重启，PHP上传文件大小限制就能顺利放开，本地调试大文件功能也不再报错。

phpEnvupload_max_filesizePHP配置修改时间：2026-08-04 04:06:28