上一篇
阿里云虚拟主机安装 php.ini
- 虚拟主机
- 2025-08-17
- 5
登录阿里云虚拟主机管理控制台 → 文件管理器 → 将php.ini上传至网站根目录 →
前提条件
确保已购买阿里云虚拟主机并完成初始化;
拥有FTP/WebDAV等文件管理权限;
知晓当前使用的PHP版本(可通过 <?php phpinfo(); ?> 生成页面查看)。

定位可用配置文件方式
| 方法 | 说明 | 适用场景 |
|---|---|---|
| .user.ini 文件 | 用户级配置文件,仅影响所在目录及其子目录 | 推荐(无需全局权限) |
| php.ini 主文件 | 全局配置文件,需高权限且可能被服务商限制 | 不推荐(多数虚拟主机禁止) |
| 控制面板设置 | 通过阿里云控制台调整部分PHP参数 | 简单参数快速修改 |
️ 注意:阿里云虚拟主机通常不允许直接修改系统级 php.ini,优先使用 .user.ini。
通过 .user.ini 自定义 PHP 配置
-
创建/编辑 .user.ini 文件

- 使用FTP工具(如FileZilla)连接到虚拟主机;
- 在网站根目录(或需生效的子目录)新建空白文件,命名为 .user.ini;
- 参考示例内容如下: ; 上调最大上传大小至20MB upload_max_filesize = 20M post_max_size = 20M ; 延长脚本执行时间至30秒 max_execution_time = 30 ; 启用错误日志记录 log_errors = On error_log = /home/yourusername/logs/php_errors.log ; 根据实际路径调整
- 注: 如果已有现成模板,可从本地复制并按需修改。
-
验证配置文件有效性

- 保存文件后,访问包含以下代码的测试页: <?php echo 'Current settings:<br>'; ini_get('upload_max_filesize'); // 应显示新值 ini_get('max_execution_time'); // 应显示新值
- 若未生效,检查以下两点:
- 确认文件名为 .user.ini(无扩展名);
- 检查语法错误(可在本地用记事本打开,确保无乱码)。
- 登录阿里云官网 → 进入“虚拟主机管理”;
- 选择目标主机 → “高级环境设置” → “PHP版本设置”;
- 在此界面可临时修改 memory_limit, max_input_vars 等参数(部分版本支持)。
此方法无需编码,适合紧急需求。
- 禁止操作:切勿尝试删除或重命名系统默认的 php.ini,可能导致服务崩溃;
- 生效延迟:部分改动需等待5-10分钟自动加载;
- 作用范围:.user.ini 仅对所在目录及子目录有效,如需全站生效需置于根目录;
- ️ 安全建议:敏感操作(如关闭安全模式)可能引发风险,请谨慎测试。
- 缓存问题:清除浏览器缓存或强制刷新(Ctrl+F5);
- 多层级覆盖:检查上级目录是否存在其他 .user.ini 定义了相同参数;
- 权限不足:确认文件所属用户/组与运行PHP的用户一致(可通过阿里云工单咨询);
- 拼写错误:检查参数名是否完全匹配官方文档(如 upload_max_filesize 而非 upload_max)。
替代方案:利用阿里云控制台调整关键参数
若仅需微调少数常用设置,可通过以下路径操作:
注意事项
相关问题与解答
Q1: 我按照教程添加了 .user.ini,但新的 upload_max_filesize 仍然无效怎么办?
A: 可能原因及解决方案:
Q2: 能否为某个特定子目录单独设置 PHP 配置?
A: 可以,只需将 .user.ini 文件放置在目标子目录中,其规则仅对该目录及子目录生效,若希望 /images/ 目录允许更大文件上传,则在该目录下创建 .user.ini 并设置相应参数