使用fastcgi_finish_request提高页面响应速度

本文介绍了如何在PHP中利用fastcgi_finish_request方法提高网页加载速度,通过实例展示了该方法如何实现响应快速完成,同时在服务端继续执行后续操作,从而提升用户体验。同时对比了其与Flush的使用区别,并提供了代码片段以确保代码在不同环境中兼容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

当PHP运行在FastCGI模式时,PHP FPM提供了一个名为fastcgi_finish_request的方法.按照文档上的说法,此方法可以提高请求的处理速度,如果有些处理可以在页面生成完后再进行,就可以使用这个方法.

听起来可能有些茫然,我们通过几个例子来说明一下:

  1. <?php
  2.  
  3. echo ‘例子:’;
  4. fastcgi_finish_request(); /* 响应完成, 关闭连接 */
  5.  
  6. /* 记录日志 */
  7. file_put_contents(‘log.txt’, ‘生存还是毁灭,这是个问题.’);
  8. ?>

通过浏览器访问此脚本, 结果发现并没有输出相应的字符串,但却生成了相应的文件.由此说明在调用fastcgi_finish_request后,客户端响应就已经结束,但与此同时服务端脚本却继续运行!

合理利用这个特性可以大大提升用户体验,趁热打铁再来一个例子:

  1. <?php
  2.  
  3. echo ‘例子:’;
  4.  
  5. file_put_contents(‘log.txt’, date(‘Y-m-d H:i:s’) . ” 上传视频\n”, FILE_APPEND);
  6.  
  7. fastcgi_finish_request();
  8.  
  9. sleep(1);
  10. file_put_contents(‘log.txt’, date(‘Y-m-d H:i:s’) . ” 转换格式\n”, FILE_APPEND);
  11.  
  12. sleep(1);
  13. file_put_contents(‘log.txt’, date(‘Y-m-d H:i:s’) . ” 提取图片\n”, FILE_APPEND);
  14.  
  15. ?>

代码里用sleep模拟一些耗时的操作,浏览时没有被堵塞,程序却都执行了,具体看日志.

末了给您提个醒,Yahoo在Best Practices for Speeding Up Your Web Site中提到了Flush the Buffer Early,也就是利用PHP中的flush方法把内容尽快发到客户端去,它和本文介绍的fastcgi_finish_request有些许的类似.

转载附言: 我看了下这个方法, 在调用的时候, 会发送响应, 关闭连接. 但是不会结束PHP的运行. 相比调用flush, 或者我之前介绍的加速你的Echo来说, 这个方法能更加干脆一些.

另外, 从代码的可移植性讲的话, 可以在代码中附上如下代码:

  1. if (!function_exists(“fastcgi_finish_request”)) {
  2.       function fastcgi_finish_request() {
  3.       }
  4. }

不会造成代码部署在非fpm环境下造成问题.

<think>我们正在分析Nginx配置中与FastCGI相关的两个关键指令:`fastcgi_param`和`include`,特别是针对以下配置行: fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; include fastcgi_params; 根据引用内容,我们逐步解释: 1. **`include fastcgi_params;` 的作用**: - 引用[2]指出:`fastcgi_params` 是一个文件,其中包含了Nginx预定义的一组FastCGI参数(常量)。这些参数是Nginx与FastCGI进程(如PHP-FPM)通信时所必需传递的。 - 默认情况下,这个文件位于Nginx配置目录(例如:`/etc/nginx/`)中,其内容定义了多个`fastcgi_param`参数,例如: ```nginx fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; ...(其他参数) ``` 注意:在默认的`fastcgi_params`文件中,`SCRIPT_FILENAME`参数可能被设置为`$fastcgi_script_name`(即只有脚本文件名,没有完整路径)[^2]。 2. **`fastcgi_param SCRIPT_FILENAME ...` 的作用**: - 引用[1]详细解释了这一行: - `fastcgi_param` 是Nginx指令,用于设置传递给FastCGI进程的参数。 - `SCRIPT_FILENAME` 是FastCGI协议中的一个特殊参数,它告诉PHP-FPM要执行哪个脚本文件。 - `$document_root` 是Nginx内置变量,表示当前请求的根目录(通常由`root`指令设置)。 - `$fastcgi_script_name` 是Nginx内置变量,表示请求的脚本文件名(例如:`/index.php`)。 - 因此,`$document_root$fastcgi_script_name` 拼接后得到脚本的完整文件系统路径(例如:`/usr/share/nginx/html/index.php`)[^1]。 3. **为什么需要单独设置 `SCRIPT_FILENAME`?** - 引用[2]和引用[3]提到:默认的`fastcgi_params`文件可能没有正确设置`SCRIPT_FILENAME`(仅设置为`$fastcgi_script_name`),这会导致PHP-FPM找不到脚本文件,从而出现空白页或“File not found”错误。 - 因此,在配置中显式设置 `SCRIPT_FILENAME` 为 `$document_root$fastcgi_script_name` 是为了覆盖默认值,确保传递正确的脚本路径[^1][^2][^3]。 4. **配置顺序的重要性**: - 由于Nginx配置中相同参数后出现的指令会覆盖前面的值,因此我们通常在`include fastcgi_params;`之后(或之前)单独设置`SCRIPT_FILENAME`。但更常见的做法是先包含通用参数,再覆盖特定参数: ```nginx include fastcgi_params; # 包含默认参数(其中SCRIPT_FILENAME可能不正确) fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # 覆盖为正确值 ``` **总结**: - `include fastcgi_params;` 引入一组通用的FastCGI参数。 - `fastcgi_param SCRIPT_FILENAME ...` 专门设置脚本的完整路径,确保PHP-FPM能定位到待执行的PHP文件。 **完整配置示例**: ```nginx location ~ \.php$ { root /usr/share/nginx/html; fastcgi_pass 127.0.0.1:9000; include fastcgi_params; # 包含基础参数 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # 覆盖关键参数 } ``` **验证方法**: 1. 检查Nginx错误日志(`/var/log/nginx/error.log`)是否有“Primary script unknown”错误(表明路径错误)。 2. 在PHP脚本中输出`$_SERVER['SCRIPT_FILENAME']`,确认路径与实际一致。 §§相关问题§§ 1. Nginx 内置变量 `$document_root` 和 `$fastcgi_script_name` 分别代表什么? 2. 为什么默认的 `fastcgi_params` 文件可能导致 PHP 脚本无法执行? 3. 如何自定义 FastCGI 参数传递到 PHP-FPM? 4. 除了 `SCRIPT_FILENAME`,还有哪些 FastCGI 参数对 PHP 执行至关重要?</think>### Nginx FastCGI 配置详解 #### 1. `fastcgi_param` 指令解析 ```nginx fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; ``` - **作用**:向 PHP-FPM 传递关键执行参数 - **组成要素**: - `SCRIPT_FILENAME`:PHP-FPM 用于定位脚本的核心参数[^1] - `$document_root`:Nginx 变量,表示当前站点的根目录路径(由 `root` 指令定义) - `$fastcgi_script_name`:Nginx 变量,包含请求的脚本路径(如 `/index.php`) - **实际效果**:拼接出 PHP 文件的完整物理路径 示例:若请求 `/index.php`,则拼接为 `/usr/share/nginx/html/index.php` #### 2. `include` 指令解析 ```nginx include fastcgi_params; ``` - **作用**:加载预定义的 FastCGI 参数集合 - **文件位置**:通常位于 `/etc/nginx/fastcgi_params` - **包含内容**: ```nginx # 基础通信参数 fastcgi_param QUERY_STRING $query_string; fastcgi_param REQUEST_METHOD $request_method; fastcgi_param CONTENT_TYPE $content_type; fastcgi_param CONTENT_LENGTH $content_length; # 服务器环境参数 fastcgi_param SCRIPT_NAME $fastcgi_script_name; fastcgi_param REQUEST_URI $request_uri; fastcgi_param DOCUMENT_URI $document_uri; fastcgi_param SERVER_PROTOCOL $server_protocol; # 客户端信息 fastcgi_param REMOTE_ADDR $remote_addr; fastcgi_param REMOTE_PORT $remote_port; fastcgi_param SERVER_ADDR $server_addr; fastcgi_param SERVER_PORT $server_port; fastcgi_param SERVER_NAME $server_name; ``` #### 3. 组合工作流程 ```mermaid graph LR A[客户端请求 index.php] --> B[Nginx接收请求] B --> C[include fastcgi_params 加载基础参数] C --> D[fastcgi_param SCRIPT_FILENAME 设置脚本路径] D --> E[将完整参数集传递给PHP-FPM] E --> F[PHP-FPM执行 /usr/share/nginx/html/index.php] ``` #### 4. 关键注意事项 1. **覆盖关系**: - `include fastcgi_params` 默认设置 `SCRIPT_FILENAME = $fastcgi_script_name`(仅文件名)[^2] - 后续的 `fastcgi_param` 会覆盖同名参数,因此必须显式设置完整路径 2. **常见错误**: - 空白页:通常因 `SCRIPT_FILENAME` 路径错误导致 PHP-FPM 找不到文件[^3] - 502错误:`fastcgi_pass` 地址与 PHP-FPM 监听地址不匹配 3. **最佳实践**: ```nginx location ~ \.php$ { # 先包含基础参数 include fastcgi_params; # 再覆盖关键路径参数 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name; # 添加安全限制 try_files $uri =404; } ``` #### 5. 参数传递原理 当 Nginx 处理 PHP 请求时: 1. 通过 `include fastcgi_params` 加载基础环境变量 2. 使用 `fastcgi_param` 添加/修改特定参数 3. 所有参数以键值对形式发送给 PHP-FPM 4. PHP-FPM 将这些参数转换为 `$_SERVER` 超全局变量 > 示例:`fastcgi_param TEST "value"` 在 PHP 中可通过 `$_SERVER['TEST']` 访问
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值