如果您正在考虑分发您的 PostgreSQL 扩展模块，为它们设置一个可移植的构建系统可能会相当困难。因此，PostgreSQL 安装为扩展提供了一个构建基础设施，称为 PGXS，以便可以针对已安装的服务器轻松构建简单的扩展模块。 PGXS 主要适用于包含 C 代码的扩展，尽管它也可以用于纯 SQL 扩展。请注意，PGXS 并不是一个通用的构建系统框架，不能用于构建任何与 PostgreSQL 交互的软件；它只是为简单的服务器扩展模块自动执行常见的构建规则。对于更复杂的包，您可能需要编写自己的构建系统。

要为您的扩展使用 PGXS 基础设施，您必须编写一个简单的 makefile。在 makefile 中，您需要设置一些变量并包含全局 PGXS makefile。以下是一个构建名为 isbn_issn 的扩展模块的示例，该模块由一个包含一些 C 代码的共享库、一个扩展控制文件、一个 SQL 脚本、一个包含文件（仅当其他模块可能需要通过 SQL 访问扩展函数时才需要）和一个文档文本文件组成

MODULES = isbn_issn
EXTENSION = isbn_issn
DATA = isbn_issn--1.0.sql
DOCS = README.isbn_issn
HEADERS_isbn_issn = isbn_issn.h

PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)

最后三行应始终相同。在文件前面，您分配变量或添加自定义 make 规则。

设置以下三个变量之一以指定构建的内容

还可以设置以下变量

将此 Makefile 作为 Makefile 放置在包含扩展名的目录中。然后，你可以执行 make 进行编译，然后执行 make install 安装模块。默认情况下，扩展名针对与 PATH 中找到的第一个 pg_config 程序相对应的 PostgreSQL 安装进行编译和安装。你可以通过将 PG_CONFIG 设置为指向其 pg_config 程序（在 Makefile 中或在 make 命令行中）来使用不同的安装。

如果您希望将构建目录分开，您还可以在扩展源树外部的目录中运行 make。此过程也称为 VPATH 构建。方法如下

mkdir build_dir
cd build_dir
make -f /path/to/extension/source/tree/Makefile
make -f /path/to/extension/source/tree/Makefile install

或者，您可以像对核心代码执行操作一样，为 VPATH 构建设置一个目录。执行此操作的一种方法是使用核心脚本 config/prep_buildtree。完成此操作后，您可以通过设置 make 变量 VPATH 如下进行构建

make VPATH=/path/to/extension/source/tree
make VPATH=/path/to/extension/source/tree install

此过程可用于更多种类的目录布局。

在 REGRESS 变量中列出的脚本用于模块的回归测试，执行 make install 后，可以通过 make installcheck 调用这些脚本。为此，您必须运行 PostgreSQL 服务器。在 REGRESS 中列出的脚本文件必须出现在扩展目录中名为 sql/ 的子目录中。这些文件必须具有扩展名 .sql，该扩展名不得包含在 makefile 中的 REGRESS 列表中。对于每个测试，还应在名为 expected/ 的子目录中包含一个包含预期输出的文件，该文件具有相同的词干和扩展名 .out。 make installcheck 使用 psql 执行每个测试脚本，并将结果输出与匹配的预期文件进行比较。任何差异都将以 diff -c 格式写入文件 regression.diffs。请注意，尝试运行缺少预期文件的测试将报告为 “问题”，因此请确保您拥有所有预期文件。

在 ISOLATION 变量中列出的脚本用于测试与模块并发会话的行为，可以在执行 make install 后通过 make installcheck 调用这些脚本。要实现此功能，您必须运行一个 PostgreSQL 服务器。在 ISOLATION 中列出的脚本文件必须出现在扩展目录中名为 specs/ 的子目录中。这些文件必须具有扩展名 .spec，而此扩展名不能包含在 Makefile 中的 ISOLATION 列表中。对于每个测试，还应有一个文件包含预期输出，该文件位于名为 expected/ 的子目录中，且具有相同的主干和扩展名 .out。 make installcheck 执行每个测试脚本，并将产生的输出与匹配的预期文件进行比较。任何差异都将以 diff -c 格式写入文件 output_iso/regression.diffs 中。请注意，尝试运行缺少预期文件的测试将被报告为 “trouble”，因此请确保您拥有所有预期文件。

TAP_TESTS 启用 TAP 测试的使用。每次运行的数据都存在于名为 tmp_check/ 的子目录中。另请参阅 第 33.4 节 了解更多详情。