English
资源说明：SAPI: Server abstraction API，研究过PHP架构的同学应该知道这个东东的重要性，它提供了一个接口，使得PHP可以和其他应用进行交互数据。 本文不会详细介绍每个PHP的SAPI，只是针对最简单的CGI SAPI，来说明SAPI的机制。
首先，我们来看看PHP的架构图：
图1 PHP Architecture
SAPI提供了一个和外部通信的接口， 对于PHP5.2，默认提供了很多种SAPI， 常见的给apache的mod_php5，CGI，给IIS的ISAPI，还有Shell的CLI，本文就从CGI SAPI入手 ，介绍SAPI的机制。 虽然CGI简单，但是不用担心，它
Zend SAPIs（Server Application Programming Interface）是PHP中一个至关重要的概念，它是服务器抽象层的接口，使得PHP能够与各种不同的Web服务器和其他应用程序进行交互。SAPI为不同的服务器环境提供了标准化的方法来调用PHP解释器，执行PHP脚本并返回结果。
在PHP的架构中，SAPI扮演着桥梁的角色，它连接着PHP引擎（如Zend Engine）和服务器或Web服务器模块。例如，对于Apache，有mod_php5这样的SAPI，而对于命令行环境，有CLI SAPI。在PHP 5.2版本中，默认支持多种SAPI，包括mod_php5、CGI、ISAPI（用于IIS）以及CLI等。本文主要关注的是最简单的CGI SAPI，因为它虽然简单，但足以揭示SAPI的基本工作原理。
CGI（Common Gateway Interface）SAPI是PHP的一种运行模式，它允许PHP作为独立的CGI进程运行。在CGI SAPI中，PHP接收到HTTP请求后，解析请求并生成响应。CGI程序通常接收环境变量来获取请求信息，并通过标准输入（stdin）接收POST数据，通过标准输出（stdout）返回HTML响应。
为了定义一个SAPI，需要创建一个`sapi_module_struct`结构体。例如，在`PHP-SRC/sapi/cgi/cgi_main.c`中，定义了CGI SAPI的结构体，其中包含了各种函数指针，这些指针告诉Zend Engine如何处理不同操作，如启动、关闭、读取POST数据、发送头信息等。结构体中的各个成员如`name`和`pretty_name`用于标识SAPI，而`php_cgi_startup`和`php_module_shutdown_wrapper`分别用于启动和关闭PHP引擎。
1. `php_cgi_startup`函数在每次请求开始时被调用，它执行PHP的初始化工作。对于CGI SAPI，这通常涉及调用`php_module_startup`函数，初始化PHP环境。
2. `php_module_shutdown_wrapper`是对`php_module_shutdown`的简单封装，用于在请求结束时清理和关闭PHP。
3. `activate`字段在每个请求开始时执行，对于CGI SAPI，它没有定义特定的激活处理，但在其他SAPI（如mod_php）中，可能需要注册资源、初始化环境等。
4. `sapi_cgi_deactivate`则在请求结束时执行，主要负责清理工作，如CGI SAPI中，它会刷新输出缓冲区，确保所有输出都被发送给客户端。
理解SAPI的运作机制对于深入学习PHP的内部工作原理非常重要，因为SAPI决定了PHP如何与服务器进行交互，以及如何处理输入和输出。熟悉不同的SAPI可以帮助开发者更好地优化代码，根据目标服务器环境选择合适的运行模式。例如，CGI SAPI适合简单的部署，而mod_php可以提供更高的性能，因为它直接嵌入到Web服务器中。
本源码包内暂不包含可直接显示的源代码文件，请下载源码包。
