31.20. 编译 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'

  This means you forgot -lpq.

  /usr/bin/ld: cannot find -lpq

  这意味着你忘记了-L选项或者没有指定正确的目录。