2024 年 9 月 26 日: PostgreSQL 17 发布!
支持版本:当前 (17) / 16 / 15 / 14 / 13 / 12
开发版本:devel
不支持的版本:11 / 10 / 9.6 / 9.5 / 9.4 / 9.3 / 9.2 / 9.1 / 9.0 / 8.4 / 8.3 / 8.2 / 8.1 / 8.0 / 7.4 / 7.3 / 7.2

32.21. 构建 libpq 程序 #

要构建(即编译和链接)使用 libpq 的程序,您需要执行以下所有操作

  • 包含 libpq-fe.h 头文件

    #include <libpq-fe.h>
    

    如果您没有这样做,那么您通常会从编译器收到类似于以下内容的错误消息

    foo.c: In function `main':
    foo.c:34: `PGconn' undeclared (first use in this function)
    foo.c:35: `PGresult' undeclared (first use in this function)
    foo.c:54: `CONNECTION_BAD' undeclared (first use in this function)
    foo.c:68: `PGRES_COMMAND_OK' undeclared (first use in this function)
    foo.c:95: `PGRES_TUPLES_OK' undeclared (first use in this function)
    
  • 通过向编译器提供 -Idirectory 选项,将编译器指向 PostgreSQL 头文件安装的目录。 (在某些情况下,编译器将默认情况下查看该目录,因此您可以省略此选项。)例如,您的编译命令行可能如下所示

    cc -c -I/usr/local/pgsql/include testprog.c
    

    如果您使用的是 makefile,则将该选项添加到 CPPFLAGS 变量中

    CPPFLAGS += -I/usr/local/pgsql/include
    

    如果您的程序有可能被其他用户编译,那么您不应该像那样硬编码目录位置。 相反,您可以运行实用程序 pg_config 来找出本地系统上头文件的位置

    $ pg_config --includedir
    /usr/local/include
    

    如果您安装了 pkg-config,您可以改为运行

    $ pkg-config --cflags libpq
    -I/usr/local/include
    

    请注意,这将已经包含在路径前面的 -I

    未指定编译器的正确选项会导致以下错误消息

    testlibpq.c:8:22: libpq-fe.h: No such file or directory
    
  • 在链接最终程序时,指定选项 -lpq,以便 libpq 库被拉入,以及选项 -Ldirectory 以将编译器指向 libpq 库所在的目录。 (同样,编译器将默认情况下搜索一些目录。)为了最大限度地提高可移植性,请将 -L 选项放在 -lpq 选项之前。 例如

    cc -o testprog testprog1.o testprog2.o -L/usr/local/pgsql/lib -lpq
    

    您也可以使用 pg_config 找到库目录

    $ pg_config --libdir
    /usr/local/pgsql/lib
    

    或者再次使用 pkg-config

    $ pkg-config --libs libpq
    -L/usr/local/pgsql/lib -lpq
    

    请再次注意,这会打印完整的选项,而不仅仅是路径。

    指向此区域问题的错误消息可能如下所示

    testlibpq.o: In function `main':
    testlibpq.o(.text+0x60): undefined reference to `PQsetdbLogin'
    testlibpq.o(.text+0x71): undefined reference to `PQstatus'
    testlibpq.o(.text+0xa4): undefined reference to `PQerrorMessage'
    

    这意味着您忘记了 -lpq

    /usr/bin/ld: cannot find -lpq
    

    这意味着您忘记了 -L 选项或未指定正确的目录。

提交更正

如果您在文档中发现任何不正确的内容,与您对特定功能的体验不符或需要进一步澄清,请使用 此表格 报告文档问题。