怎样配置PHP临时目录参数-php教程-PHP中文网

php临时目录需分三类独立配置：1.upload_tmp_dir用于文件上传，推荐在php-fpm pool中用php_admin_value[upload_tmp_dir]设置绝对路径；2.session.save_path用于session存储，建议设为项目专属安全目录并确保web进程有读写权；3.sys_temp_dir影响tempnam()等函数，可通过php.ini或sys_set_temp_dir()指定。

怎样配置php临时目录参数

PHP 临时目录涉及多个关键参数，主要分三类场景：文件上传临时目录（upload_tmp_dir）、Session 存储路径（session.save_path）、系统级临时文件目录（sys_temp_dir）。它们彼此独立，不能互相替代，需按需分别配置。

1. 设置文件上传临时目录（upload_tmp_dir）

这个目录用于存放 `$_FILES['xxx']['tmp_name']` 指向的上传中文件，必须存在、可写，且路径为**绝对路径**。

推荐方式：在 PHP-FPM 的 pool 配置中设置（最高优先级）
编辑对应站点的 FPM 配置（如 /etc/php/{版本}/fpm/pool.d/www.conf），在 [www] 块内添加：

php_admin_value[upload_tmp_dir] = /var/www/uploads/tmp
注意：不能加末尾斜杠，不能是相对路径或符号链接。
备选方式：Apache 中用 php_admin_value（仅限 mod_php）
在 <virtualhost></virtualhost> 或 <directory></directory> 块中加入：

php_admin_value upload_tmp_dir "/var/www/uploads/tmp"
操作后必须执行：
✅ 创建目录：sudo mkdir -p /var/www/uploads/tmp
✅ 授权（以 Debian/Ubuntu 的 www-data 为例）：sudo chown www-data:www-data /var/www/uploads/tmp && sudo chmod 755 /var/www/uploads/tmp
✅ 重启服务：sudo systemctl restart php{版本}-fpm 或 sudo systemctl restart apache2
✅ 验证：php -i | grep upload_tmp_dir，输出应为你设置的路径。

2. 设置 Session 临时存储路径（session.save_path）

Session 文件默认也落在系统 `/tmp`，但为安全和隔离，建议改到项目专属目录。

方法一：修改 php.ini（全局生效）
找到你的 php.ini（用 php --ini 查看位置），修改：

session.save_path = /var/www/myapp/sessions
保持 `session.save_handler = files`（默认即可）。
方法二：运行时指定（单脚本生效）
在 session_start() 前调用：

session_save_path('/var/www/myapp/sessions');

PHP
编写健壮的PHP代码，规避类型转换陷阱、数组怪癖及常见安全漏洞。

下载

要求该路径已存在，且 Web 进程用户有读写权限。
注意：
✅ 路径必须是绝对路径；
✅ 目录不能被 Web 直接访问（避免暴露 session 文件）；
✅ 若用 CLI 测试，也要确保 CLI 用户有权限。

3. 查看与覆盖系统级临时目录（sys_temp_dir）

这是 `sys_get_temp_dir()` 返回的路径，影响 `tempnam()`、`tmpfile()` 等函数，默认通常是 `/tmp`。

可通过 php.ini 修改（非所有环境支持）：

sys_temp_dir = /var/www/tmp
更通用的做法是在代码中显式指定：

$tmpDir = '/var/www/tmp';
sys_set_temp_dir($tmpDir); // PHP 8.1+
或直接传参给函数，例如：`tempnam('/var/www/tmp', 'prefix')`

4. 常见问题排查要点

- ❌ `upload_tmp_dir` 设了却无效？检查是否被更高优先级指令覆盖（如 FPM pool > php.ini > .htaccess）； - ❌ 提示 “Permission denied”？确认目录归属用户与 PHP 进程一致（`ps aux | grep php` 查用户），并检查 SELinux/AppArmor 是否拦截； - ❌ 上传卡住或空白页？同步检查 `file_uploads = On`、`upload_max_filesize` 和 `post_max_size` 是否匹配且足够大； - ❌ Docker 环境下目录消失？避免挂载 `tmpfs` 类型的 `/tmp`，改用持久化卷路径（如 `/var/www/tmp`）并正确挂载。

不复杂但容易忽略。