小皮面板调大文件上传限制需同步修改PHP和Web服务器配置：1.在面板PHP设置中修改php.ini的upload_max_filesize、post_max_size等参数并重启PHP；2.根据Apache或Nginx分别设置LimitRequestBody或client_max_body_size；3.通过phpinfo验证生效路径与数值；4.确保临时目录权限、表单enctype正确及代码层校验。
小皮面板（XPanels）默认集成 PHP 8.2，但其上传限制沿用 PHP 的默认值（通常 upload_max_filesize = 2M），直接改代码或前端无效。要真正调大文件上传限制，需同步调整 PHP 层和 Web 服务器层配置，并确认生效路径。以下是小皮面板环境下最稳妥、实测有效的操作步骤：
1. 找准并修改正确的 php.ini 文件
小皮面板的 PHP 配置文件不是系统全局的，而是**面板为每个 PHP 版本单独管理的**： - 进入小皮面板 → 左侧「PHP」→ 点击你正在使用的版本（如「8.2」）→ 右上角「设置」→ 「配置文件」 - 此处打开的就是该 PHP 版本实际加载的 `php.ini`（路径类似：`D:\xp\php\php-8.2\php.ini` 或 `/www/server/php/82/etc/php.ini`） - **不要**去系统其他位置找副本，否则改了也不生效在该 php.ini 中定位并修改以下四项（单位不加空格，大小写不敏感，推荐用 M）：
- upload_max_filesize = 100M（单个文件上限，按需设，如 500M、2G 也可）
- post_max_size = 105M（必须 ≥ upload_max_filesize，预留 POST 头空间）
- memory_limit = 256M（建议 ≥ post_max_size，避免处理时内存不足）
- max_execution_time = 600（大文件上传耗时，设为 600 秒较稳妥）
✅ 修改后保存文件，**必须重启 PHP 服务**：回到小皮面板 →「PHP」→「8.2」→ 点击「重启」按钮（不是重启 Apache/Nginx）
2. 同步检查并调整 Web 服务器限制
小皮面板默认使用 Apache 或 Nginx，二者自身也会拦截超大请求：-
若用 Apache（小皮默认）：
PHP 8.5.12下载修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
立即学习“PHP免费学习笔记（深入）”；
- 进入面板 →「网站」→ 找到你的站点 →「设置」→ 「配置文件」→ 切换到「Apache 配置」标签页
- 在
<directory></directory>或虚拟主机段内添加（或确认已有）：LimitRequestBody 0
（`0` 表示不限制，或设为 `1073741824` 即 1GB） - 保存后点击「重载配置」
-
若用 Nginx：
- 同样在站点「配置文件」→「Nginx 配置」标签页
- 在
server { }块内添加（或修改已有）：client_max_body_size 1024m;
- 保存后点击「重载配置」
3. 验证是否真正生效
别信“改完就 OK”，务必验证： - 新建一个 `test.php` 放到网站根目录，内容为：<?php phpinfo(); ?>- 访问 `http://你的域名/test.php`，搜索 `upload_max_filesize` 和 `post_max_size` - 确认显示的值是你刚改的数值，且「Loaded Configuration File」路径与你在面板里编辑的完全一致 - 同时检查 `Server API` 是 `apache2handler` 还是 `fpm/fcgi` —— 小皮通常为 `fpm`，此时还需确认 PHP-FPM 没额外覆盖（小皮一般不会）
4. 补充注意点（常被忽略）
- 临时目录权限：PHP 上传需写入 `upload_tmp_dir`。小皮通常设为系统默认（如 `C:\Windows\Temp` 或 `/tmp`），确保该目录对 `www` 或 `www-data` 用户可写；也可在 `php.ini` 中显式指定：upload_tmp_dir = "D:/xp/tmp"并手动创建该目录、赋予权限。 - 表单 enctype 必须正确：HTML 上传表单必须含 `enctype="multipart/form-data"`，否则限制不触发。 - 代码层校验不能少：即使服务端设了 100M，PHP 脚本中仍应检查 `$_FILES['file']['error'] === UPLOAD_ERR_OK` 和 `$_FILES['file']['size']`，防止绕过或友好提示。
改完重启、验证路径、双层限制都放开——上传几百 MB 的文件就不再报错。
