小皮面板修改 post_max_size 需编辑对应 PHP 版本的 php.ini 文件,设置 post_max_size、upload_max_filesize 和 memory_limit,并重启 PHP 服务生效。

小皮面板(XPanels)是面向 PHP 开发者的一键式 Windows / macOS / Linux 环境管理工具,集成 Apache/Nginx、PHP、MySQL 等组件。它对 PHP 配置做了图形化封装,但底层仍依赖标准 php.ini 文件。修改 post_max_size 上传限制,本质就是改对应 PHP 版本的 php.ini,只是路径和操作方式更集中。
以下是小皮面板中修改 post_max_size 的具体步骤(以最新稳定版为准,适配 Windows 和 macOS):
找到并编辑正确的 php.ini 文件
小皮面板为每个 PHP 版本单独维护一份 php.ini,不能直接改全局模板或默认备份。
- 打开小皮面板 → 顶部切换到「软件管理」→ 「PHP」选项卡
- 找到你当前网站所用的 PHP 版本(如 PHP 8.2),点击右侧「设置」按钮(齿轮图标)
- 在弹出窗口中,点击「配置文件」→ 「php.ini」,面板会自动打开该版本对应的
php.ini文件(路径类似:D:\XPanel\php\version\php.ini或/Applications/XPanel/php/8.2/php.ini)
✅ 关键确认点:打开文件后搜索
Loaded Configuration File(可通过新建一个info.php写<?php phpinfo(); ?>访问网页确认),确保编辑的是“已加载”的那个文件,而非.default或备份。
修改 post_max_size 和关联参数
在 php.ini 中依次完成以下三处修改(建议用 Ctrl+F 搜索):
找到
post_max_size行(通常在「Data Handling」章节),改为:post_max_size = 128M
(单位推荐用M,不要空格,如128M而非128 MB)找到
upload_max_filesize行,确保它 ≤post_max_size,例如:upload_max_filesize = 100M检查
memory_limit,它需 ≥post_max_size(建议留 20% 余量):memory_limit = 256M
⚠️ 注意:如果启用了 Suhosin(小皮旧版可能默认启用),还需检查是否存在
suhosin.post.max_value_length或suhosin.request.max_value_length,它们也会截断 POST 数据——建议临时注释掉这两行(行首加;)测试是否生效。
保存并重启 PHP 服务
- 保存
php.ini文件(确保无编码错误,推荐用 UTF-8 无 BOM 格式) - 返回小皮面板 → 「软件管理」→ 「PHP」→ 点击对应版本右侧「重启」按钮
- 不要只重启 Apache/Nginx:小皮中 PHP 是独立服务,必须单独重启 PHP 进程才能加载新配置
验证是否生效
- 创建一个
test.php,内容为:<?php phpinfo();
- 浏览器访问,搜索
post_max_size,确认显示值为你设置的128M - 同时核对
upload_max_filesize和memory_limit是否同步更新
? 小贴士:小皮面板不支持通过
.htaccess修改post_max_size(即使选 Apache 模式,PHP 多为 php-fpm 方式运行,php_value指令无效);ini_set()也对post_max_size完全无效,无需尝试。
不复杂但容易忽略

















